Debian Codegraph @

UG9/en/install-packages.adoc

raw
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 ///////