| 1 |
[[ch-install-packages]] |
| 2 |
== Installing pre-built DRBD binary packages |
| 3 |
|
| 4 |
|
| 5 |
[[s-linbit-packages]] |
| 6 |
=== Packages supplied by LINBIT |
| 7 |
|
| 8 |
LINBIT, the DRBD project's sponsor company, provides binary packages to its commercial support customers. |
| 9 |
These packages are available via repositories (e.g., `apt`, `yum`), and when reasonable via LINBIT's docker |
| 10 |
registry. Packages/images from these sources are considered "official" builds. |
| 11 |
|
| 12 |
These builds are available for the following distributions: |
| 13 |
|
| 14 |
* Red Hat Enterprise Linux (RHEL), versions 6, 7 and 8 |
| 15 |
|
| 16 |
* SUSE Linux Enterprise Server (SLES), versions 11SP4, 12 and 15 |
| 17 |
|
| 18 |
* Debian GNU/Linux, 9 (stretch), 10 (buster), and 11 (bullseye) |
| 19 |
|
| 20 |
* Ubuntu Server Edition LTS 16.04 (Xenial Xerus), LTS 18.04 (Bionic Beaver), and LTS 20.04 (Focal Fossa). |
| 21 |
|
| 22 |
Packages for some other distributions are built as well, but don't receive as much testing. |
| 23 |
|
| 24 |
LINBIT releases binary builds in parallel with any new DRBD source |
| 25 |
release. |
| 26 |
|
| 27 |
Package installation on RPM-based systems (SLES, RHEL) is done by |
| 28 |
simply invoking `yum install` (for new installations) or `yum update` (for |
| 29 |
upgrades). |
| 30 |
|
| 31 |
For Debian-based systems (Debian GNU/Linux, Ubuntu) systems, |
| 32 |
`drbd-utils` and `drbd-module-`uname -r`` packages are installed with `apt`, |
| 33 |
or similar tools like `aptitude` or `synaptic`, if available. |
| 34 |
|
| 35 |
[[s-ko-signing]] |
| 36 |
==== Secure Boot / Kernel module signing |
| 37 |
LINBIT signs most of its kernel module object files, the following table gives an overview when signing for distributions started: |
| 38 |
|
| 39 |
[options="header"] |
| 40 |
|=== |
| 41 |
| Distribution | Module signing since DRBD release |
| 42 |
| RHEL7 | 8.4.12/9.0.25/9.1.0 |
| 43 |
| RHEL8 | 9.0.25/9.1.0 |
| 44 |
| SLES15 | 9.0.31/9.1.4 |
| 45 |
| Debian | 9.0.30/9.1.3 |
| 46 |
| Ubuntu | 9.0.30/9.1.3 |
| 47 |
|=== |
| 48 |
|
| 49 |
The public signing key is shipped in the rpm package and gets installed to |
| 50 |
`/etc/pki/linbit/SECURE-BOOT-KEY-linbit.com.der`. It can be enrolled via: |
| 51 |
|
| 52 |
--------------------------------------- |
| 53 |
# mokutil --import /etc/pki/linbit/SECURE-BOOT-KEY-linbit.com.der |
| 54 |
input password: |
| 55 |
input password again: |
| 56 |
--------------------------------------- |
| 57 |
|
| 58 |
A password can be chosen freely. It will be used when the key is actually enrolled to the MOK list after the |
| 59 |
required reboot. |
| 60 |
|
| 61 |
[[s-docker-registry]] |
| 62 |
=== Docker images supplied by LINBIT |
| 63 |
LINBIT provides a Docker registry for its commercial support customers. The registry is accessible via |
| 64 |
the host name 'drbd.io'. Before you can pull images, you have to log in to the registry: |
| 65 |
|
| 66 |
--------------------------------------- |
| 67 |
# docker login drbd.io |
| 68 |
--------------------------------------- |
| 69 |
|
| 70 |
After a successful login, you can pull images. To test your login and the registry, start by issuing the |
| 71 |
following command: |
| 72 |
|
| 73 |
--------------------------------------- |
| 74 |
# docker pull drbd.io/alpine |
| 75 |
# docker run -it --rm drbd.io/alpine # press CTRL-D to exit |
| 76 |
--------------------------------------- |
| 77 |
|
| 78 |
[[s-distro-packages]] |
| 79 |
=== Packages supplied by distribution vendors |
| 80 |
|
| 81 |
A number of distributions provide DRBD, including pre-built binary |
| 82 |
packages. Support for these builds, if any, is being provided by the |
| 83 |
associated distribution vendor. Their release cycle may lag behind |
| 84 |
DRBD source releases. |
| 85 |
|
| 86 |
[[s-install-pkgs-suse_linux_enterprise_server]] |
| 87 |
==== SUSE Linux Enterprise Server |
| 88 |
|
| 89 |
SLES High Availability Extension (HAE) includes DRBD. |
| 90 |
|
| 91 |
|
| 92 |
On SLES, DRBD is normally installed via the software installation |
| 93 |
component of YaST2. It comes bundled with the High Availability |
| 94 |
package selection. |
| 95 |
|
| 96 |
Users who prefer a command line install may simply issue: |
| 97 |
|
| 98 |
--------------------------------------- |
| 99 |
# yast -i drbd |
| 100 |
--------------------------------------- |
| 101 |
|
| 102 |
or |
| 103 |
|
| 104 |
--------------------------------------- |
| 105 |
# zypper install drbd |
| 106 |
--------------------------------------- |
| 107 |
|
| 108 |
|
| 109 |
[[s-install-pkgs-centos]] |
| 110 |
==== CentOS |
| 111 |
|
| 112 |
CentOS has had DRBD 8 since release 5; for DRBD 9 you'll need to look at EPEL |
| 113 |
and similar sources. |
| 114 |
|
| 115 |
DRBD can be installed using `yum` (note that you will need a |
| 116 |
correct repository enabled for this to work): |
| 117 |
|
| 118 |
--------------------------------------- |
| 119 |
# yum install drbd kmod-drbd |
| 120 |
--------------------------------------- |
| 121 |
|
| 122 |
|
| 123 |
[[s-install-pkgs-ubuntu_linux]] |
| 124 |
==== Ubuntu Linux |
| 125 |
|
| 126 |
For Ubuntu LTS, LINBIT offers a PPA repository at |
| 127 |
https://launchpad.net/~linbit/+archive/ubuntu/linbit-drbd9-stack. |
| 128 |
See |
| 129 |
https://help.ubuntu.com/community/Repositories/CommandLine#Adding_Launchpad_PPA_Repositories[Adding Launchpad PPA Repositories] for more information. |
| 130 |
|
| 131 |
--------------------------------------- |
| 132 |
# apt install drbd-utils drbd-dkms |
| 133 |
--------------------------------------- |
| 134 |
|
| 135 |
[[s-from-source]] |
| 136 |
=== Compiling packages from source |
| 137 |
|
| 138 |
Releases generated by git tags on https://github.com/LINBIT[github] are snapshots of the git repository at the |
| 139 |
given time. You most likely do not want to use these. They might lack things such as generated man pages, the |
| 140 |
`configure` script, and other generated files. If you want to build from a tarball, use the ones |
| 141 |
https://www.linbit.com/en/drbd-community/drbd-download[provided by us]. |
| 142 |
|
| 143 |
All our projects contain standard build scripts (e.g., `Makefile`, `configure`). Maintaining specific |
| 144 |
information per distribution (e.g., documenting broken build macros) is too cumbersome, and historically the |
| 145 |
information provided in this section got outdated quickly. If you don't know how to build software the |
| 146 |
standard way, please consider using packages provided by LINBIT. |
| 147 |
|
| 148 |
/////// |
| 149 |
|
| 150 |
[[s-_debian_gnu_linux]] |
| 151 |
==== Debian GNU/Linux |
| 152 |
|
| 153 |
While PPAs are not directly supported in Debian, they basically work like any |
| 154 |
other package repository. For `jessie` you should be able to just use |
| 155 |
the `xenial` repository in your `sources.list`: |
| 156 |
|
| 157 |
--------------------------------------- |
| 158 |
deb http://ppa.launchpad.net/linbit/linbit-drbd9-stack/ubuntu xenial main |
| 159 |
--------------------------------------- |
| 160 |
|
| 161 |
Then use the same command to install the software: |
| 162 |
|
| 163 |
--------------------------------------- |
| 164 |
# apt install drbd-utils drbd-dkms |
| 165 |
--------------------------------------- |
| 166 |
|
| 167 |
/////// |