1
1
---
2
- description : Learn how to install Docker Engine on SLES. These instructions cover
3
- the different installation methods, how to uninstall, and next steps.
4
- keywords : requirements, apt, installation, install docker engine, centos, rpm, sles, install, uninstall,
5
- upgrade, update, s390x, ibm-z
6
- title : Install Docker Engine on SLES (s390x)
2
+ description : Information about Docker Engine availability on SLES. Docker packages are no longer available for SLES s390x architecture.
3
+ keywords : sles, install, uninstall, upgrade, update, s390x, ibm-z, not supported, unavailable
4
+ title : Docker Engine on SLES (s390x)
7
5
linkTitle : SLES (s390x)
8
6
weight : 70
9
7
toc_max : 4
@@ -23,247 +21,35 @@ aliases:
23
21
- /install/linux/docker-ee/suse/
24
22
- /install/linux/sles/
25
23
- /installation/sles/
26
- download-url-base : https://download.docker.com/linux/sles
27
24
---
28
25
29
- > [ !NOTE]
30
- >
31
- > The installation instructions on this page refer to packages for SLES on the
32
- > ** s390x** architecture (IBM Z). Other architectures, including x86_64, aren't
33
- > supported for SLES.
34
-
35
- To get started with Docker Engine on SLES, make sure you
36
- [ meet the prerequisites] ( #prerequisites ) , and then follow the
37
- [ installation steps] ( #installation-methods ) .
38
-
39
- ## Prerequisites
40
-
41
- ### OS requirements
42
-
43
- To install Docker Engine, you need a maintained version of one of the following
44
- SLES versions:
45
-
46
- - SLES 15-SP4 on s390x (IBM Z)
47
- - SLES 15-SP5 on s390x (IBM Z)
48
-
49
- You must enable the [ ` SCC SUSE ` ] ( https://scc.suse.com/packages?name=SUSE%20Linux%20Enterprise%20Server&version=15.5&arch=s390x )
50
- repositories.
51
-
52
- You must add the [ OpenSUSE ` SELinux ` repository] ( https://download.opensuse.org/repositories/security:/SELinux/ ) . This repository is not added by default. Run the following commands to add it:
53
-
54
- ``` console
55
- $ opensuse_repo=" https://download.opensuse.org/repositories/security:/SELinux/openSUSE_Factory/security:SELinux.repo"
56
- $ sudo zypper addrepo $opensuse_repo
57
- ```
58
-
59
- ### Uninstall old versions
60
-
61
- Before you can install Docker Engine, you need to uninstall any conflicting packages.
62
-
63
- Your Linux distribution may provide unofficial Docker packages, which may conflict
64
- with the official packages provided by Docker. You must uninstall these packages
65
- before you install the official version of Docker Engine.
66
-
67
- ``` console
68
- $ sudo zypper remove docker \
69
- docker-client \
70
- docker-client-latest \
71
- docker-common \
72
- docker-latest \
73
- docker-latest-logrotate \
74
- docker-logrotate \
75
- docker-engine \
76
- runc
77
- ```
78
-
79
- ` zypper ` might report that you have none of these packages installed.
80
-
81
- Images, containers, volumes, and networks stored in ` /var/lib/docker/ ` aren't
82
- automatically removed when you uninstall Docker.
83
-
84
- ## Installation methods
85
-
86
- You can install Docker Engine in different ways, depending on your needs:
87
-
88
- - You can
89
- [ set up Docker's repositories] ( #install-using-the-repository ) and install
90
- from them, for ease of installation and upgrade tasks. This is the
91
- recommended approach.
92
-
93
- - You can download the RPM package,
94
- [ install it manually] ( #install-from-a-package ) , and manage
95
- upgrades completely manually. This is useful in situations such as installing
96
- Docker on air-gapped systems with no access to the internet.
97
-
98
- - In testing and development environments, you can use automated
99
- [ convenience scripts] ( #install-using-the-convenience-script ) to install Docker.
100
-
101
- {{% include "engine-license.md" %}}
102
-
103
- ### Install using the rpm repository {#install-using-the-repository}
104
-
105
- Before you install Docker Engine for the first time on a new host machine, you
106
- need to set up the Docker repository. Afterward, you can install and update
107
- Docker from the repository.
108
-
109
- #### Set up the repository
110
-
111
- Set up the repository.
112
-
113
- ``` console
114
- $ sudo zypper addrepo {{% param " download-url-base" %}}/docker-ce.repo
115
- ```
116
-
117
- #### Install Docker Engine
118
-
119
- 1 . Install the Docker packages.
120
-
121
- {{< tabs >}}
122
- {{< tab name="Latest" >}}
123
-
124
- To install the latest version, run:
125
-
126
- ``` console
127
- $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
128
- ```
129
-
130
- If prompted to accept the GPG key, verify that the fingerprint matches
131
- ` 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 ` , and if so, accept it.
132
-
133
- This command installs Docker, but it doesn't start Docker. It also creates a
134
- ` docker ` group, however, it doesn't add any users to the group by default.
135
-
136
- {{< /tab >}}
137
- {{< tab name="Specific version" >}}
138
-
139
- To install a specific version, start by listing the available versions in
140
- the repository:
141
-
142
- ``` console
143
- $ sudo zypper search -s --match-exact docker-ce | sort -r
26
+ ## Docker Engine is no longer available for SLES
144
27
145
- v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x
146
- v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x
147
- ```
148
-
149
- The list returned depends on which repositories are enabled, and is specific
150
- to your version of SLES.
151
-
152
- Install a specific version by its fully qualified package name, which is
153
- the package name (` docker-ce ` ) plus the version string (2nd column),
154
- separated by a hyphen (` - ` ). For example, ` docker-ce-3:{{% param "docker_ce_version" %}} ` .
155
-
156
- Replace ` <VERSION_STRING> ` with the desired version and then run the following
157
- command to install:
158
-
159
- ``` console
160
- $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
161
- ```
162
-
163
- This command installs Docker, but it doesn't start Docker. It also creates a
164
- ` docker ` group, however, it doesn't add any users to the group by default.
165
-
166
- {{< /tab >}}
167
- {{< /tabs >}}
168
-
169
- 2 . Start Docker Engine.
170
-
171
- ``` console
172
- $ sudo systemctl enable --now docker
173
- ```
174
-
175
- This configures the Docker systemd service to start automatically when you
176
- boot your system. If you don't want Docker to start automatically, use `sudo
177
- systemctl start docker` instead.
178
-
179
- 3 . Verify that the installation is successful by running the ` hello-world ` image:
180
-
181
- ``` console
182
- $ sudo docker run hello-world
183
- ```
184
-
185
- This command downloads a test image and runs it in a container. When the
186
- container runs, it prints a confirmation message and exits.
187
-
188
- You have now successfully installed and started Docker Engine.
189
-
190
- {{% include "root-errors.md" %}}
191
-
192
- #### Upgrade Docker Engine
193
-
194
- To upgrade Docker Engine, follow the [ installation instructions] ( #install-using-the-repository ) ,
195
- choosing the new version you want to install.
196
-
197
- ### Install from a package
198
-
199
- If you can't use Docker's ` rpm ` repository to install Docker Engine, you can
200
- download the ` .rpm ` file for your release and install it manually. You need to
201
- download a new file each time you want to upgrade Docker Engine.
202
-
203
- <!-- markdownlint-disable-next-line -->
204
- 1 . Go to [ {{% param "download-url-base" %}}/] ({{% param "download-url-base" %}}/)
205
- and choose your version of SLES. Then browse to ` s390x/stable/Packages/ `
206
- and download the ` .rpm ` file for the Docker version you want to install.
207
-
208
- 2 . Install Docker Engine, changing the following path to the path where you downloaded
209
- the Docker package.
210
-
211
- ``` console
212
- $ sudo zypper install /path/to/package.rpm
213
- ```
214
-
215
- Docker is installed but not started. The ` docker ` group is created, but no
216
- users are added to the group.
217
-
218
- 3 . Start Docker Engine.
219
-
220
- ``` console
221
- $ sudo systemctl enable --now docker
222
- ```
223
-
224
- This configures the Docker systemd service to start automatically when you
225
- boot your system. If you don't want Docker to start automatically, use `sudo
226
- systemctl start docker` instead.
227
-
228
- 4 . Verify that the installation is successful by running the ` hello-world ` image:
229
-
230
- ``` console
231
- $ sudo docker run hello-world
232
- ```
233
-
234
- This command downloads a test image and runs it in a container. When the
235
- container runs, it prints a confirmation message and exits.
236
-
237
- You have now successfully installed and started Docker Engine.
238
-
239
- {{% include "root-errors.md" %}}
240
-
241
- #### Upgrade Docker Engine
242
-
243
- To upgrade Docker Engine, download the newer package files and repeat the
244
- [ installation procedure] ( #install-from-a-package ) , using ` zypper -y upgrade `
245
- instead of ` zypper -y install ` , and point to the new files.
246
-
247
- {{% include "install-script.md" %}}
28
+ > [ !IMPORTANT]
29
+ >
30
+ > Docker Engine packages are ** no longer available** for SUSE Linux Enterprise Server (SLES) on the ** s390x** architecture (IBM Z).
248
31
249
- ## Uninstall Docker Engine
32
+ IBM has made the decision to discontinue building and providing Docker Engine
33
+ packages for SLES s390x systems. Docker Inc. never directly built these packages
34
+ and was only involved in their deployment.
250
35
251
- 1 . Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
36
+ ## What this means
252
37
253
- ``` console
254
- $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
255
- ```
38
+ - New Docker Engine installations are not available for SLES s390x
39
+ - Existing installations will continue to work but will not receive updates
40
+ - No new versions or security updates will be provided
41
+ - The Docker package repository for SLES s390x is no longer maintained
256
42
257
- 2 . Images, containers, volumes, or custom configuration files on your host
258
- aren't automatically removed. To delete all images, containers, and volumes:
43
+ ## If you have Docker currently installed
259
44
260
- ``` console
261
- $ sudo rm -rf /var/lib/docker
262
- $ sudo rm -rf /var/lib/containerd
263
- ```
45
+ If you currently have Docker Engine installed on a SLES s390x system:
264
46
265
- You have to delete any edited configuration files manually.
47
+ - Your existing Docker installation will continue to function
48
+ - No automatic updates will be available
49
+ - You should plan accordingly for your containerization needs
50
+ - Consider the security implications of running software without updates
266
51
267
52
## Next steps
268
53
269
- - Continue to [ Post-installation steps for Linux] ( linux-postinstall.md ) .
54
+ For questions about this decision or alternative solutions, contact IBM support.
55
+
0 commit comments