https://github.com/cloudbase/ceph-windows-installer
Ceph Windows Installer
https://github.com/cloudbase/ceph-windows-installer
Last synced: 5 months ago
JSON representation
Ceph Windows Installer
- Host: GitHub
- URL: https://github.com/cloudbase/ceph-windows-installer
- Owner: cloudbase
- License: lgpl-3.0
- Created: 2020-06-16T15:26:59.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-09-06T07:36:58.000Z (over 2 years ago)
- Last Synced: 2025-06-09T10:11:41.401Z (8 months ago)
- Language: PowerShell
- Size: 1.69 MB
- Stars: 15
- Watchers: 6
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
Ceph Windows Installer
======================
This project generates a MSI installer for Ceph on Windows.
Requirements
------------
Visual Studio 2019 Community, Professional, Premium or Ultimate edition
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visual Studio Community 2019 is freely available at:
https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx
WiX Toolset 3.11
^^^^^^^^^^^^^^^^
Download and install from:
http://wixtoolset.org/releases/v3.11/stable
Copy the driver files built using the instructions from https://github.com/cloudbase/wnbd#how-to-build to the ``ceph-windows-installer/Driver`` folder.
Copy also the ``*.pdb`` files generated when building the driver in the ``ceph-windows-installer/Symbols`` folder. Optionally Ceph
symbols might be included as well. ``wnbd-client.exe`` as well as ``libwnbd.dll`` must be copied to the ``ceph-windows-installer/Binaries``
folder.
Copy the binaries built using the instructions from https://github.com/petrutlucian94/ceph/blob/windows.12/README.windows.rst#building
to the ``ceph-windows-installer/Binaries`` folder.
For the ceph-rbd service to work, additional steps are required after installation:
* Create the C:\\ProgramData folder. Inside, create a ceph.conf file with the required configuration (you can copy it from an osd server).
* Create a ceph.client.admin.keyring file with the required configuration (you can copy it from an osd server).
* Restart the service: :code:`Restart-Service ceph-rbd`
Build instructions
------------------
Build the solution in the Visual Studio IDE or via command line:
::
msbuild ceph-windows-installer.sln /p:Platform=x64 /p:Configuration=Release
A complete build script that handles the Ceph and WNBD dependencies, plus the digital signature of both driver and MSI is also included.
To perform a full build with digital signature, using WSL for building Ceph:
::
.\Build.ps1 -UseWSL`
-SignX509Thumbprint 1234...`
-SignCrossCertPath path\to\the\cross\cert.cer`
-SignTimestampUrl http://timestampurl
To perform a full build with digital signature, copying the Ceph binaries from a separate location (can be a SSH, local or UNC path):
::
.\Build.ps1 -CephZipPath user@host:ceph/build/ceph.zip`
-SignX509Thumbprint 1234...`
-SignCrossCertPath path\to\the\cross\cert.cer`
-SignTimestampUrl http://timestampurl
By default, the dependencies build directory is removed before every build. To retain it, please use the ``-RetainDependenciesBuildDir`` argument.
To get a full list of the available command line arguments:
::
help .\Build.ps1
Automated installation
----------------------
For automated deployments, this package can be installed with the standard MSI silent mode, for example:
::
msiexec.exe /i Ceph.msi /l*v log.txt /qn