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,245 +21,36 @@ 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
- ### Install using the rpm repository {#install-using-the-repository}
102
-
103
- Before you install Docker Engine for the first time on a new host machine, you
104
- need to set up the Docker repository. Afterward, you can install and update
105
- Docker from the repository.
106
-
107
- #### Set up the repository
108
-
109
- Set up the repository.
110
-
111
- ``` console
112
- $ sudo zypper addrepo {{% param " download-url-base" %}}/docker-ce.repo
113
- ```
114
-
115
- #### Install Docker Engine
116
-
117
- 1 . Install the Docker packages.
118
-
119
- {{< tabs >}}
120
- {{< tab name="Latest" >}}
121
-
122
- To install the latest version, run:
123
-
124
- ``` console
125
- $ sudo zypper install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
126
- ```
127
-
128
- If prompted to accept the GPG key, verify that the fingerprint matches
129
- ` 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35 ` , and if so, accept it.
130
-
131
- This command installs Docker, but it doesn't start Docker. It also creates a
132
- ` docker ` group, however, it doesn't add any users to the group by default.
133
-
134
- {{< /tab >}}
135
- {{< tab name="Specific version" >}}
136
-
137
- To install a specific version, start by listing the available versions in
138
- the repository:
139
-
140
- ``` console
141
- $ sudo zypper search -s --match-exact docker-ce | sort -r
142
-
143
- v | docker-ce | package | 3:{{% param "docker_ce_version" %}}-1 | s390x | Docker CE Stable - s390x
144
- v | docker-ce | package | 3:{{% param "docker_ce_version_prev" %}}-1 | s390x | Docker CE Stable - s390x
145
- ```
26
+ ## Docker Engine is no longer available for SLES
146
27
147
- The list returned depends on which repositories are enabled, and is specific
148
- to your version of SLES.
149
-
150
- Install a specific version by its fully qualified package name, which is
151
- the package name (` docker-ce ` ) plus the version string (2nd column),
152
- separated by a hyphen (` - ` ). For example, ` docker-ce-3:{{% param "docker_ce_version" %}} ` .
153
-
154
- Replace ` <VERSION_STRING> ` with the desired version and then run the following
155
- command to install:
156
-
157
- ``` console
158
- $ sudo zypper install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
159
- ```
160
-
161
- This command installs Docker, but it doesn't start Docker. It also creates a
162
- ` docker ` group, however, it doesn't add any users to the group by default.
163
-
164
- {{< /tab >}}
165
- {{< /tabs >}}
166
-
167
- 2 . Start Docker Engine.
168
-
169
- ``` console
170
- $ sudo systemctl enable --now docker
171
- ```
172
-
173
- This configures the Docker systemd service to start automatically when you
174
- boot your system. If you don't want Docker to start automatically, use `sudo
175
- systemctl start docker` instead.
176
-
177
- 3 . Verify that the installation is successful by running the ` hello-world ` image:
178
-
179
- ``` console
180
- $ sudo docker run hello-world
181
- ```
182
-
183
- This command downloads a test image and runs it in a container. When the
184
- container runs, it prints a confirmation message and exits.
185
-
186
- You have now successfully installed and started Docker Engine.
187
-
188
- {{% include "root-errors.md" %}}
189
-
190
- #### Upgrade Docker Engine
191
-
192
- To upgrade Docker Engine, follow the [ installation instructions] ( #install-using-the-repository ) ,
193
- choosing the new version you want to install.
194
-
195
- ### Install from a package
196
-
197
- If you can't use Docker's ` rpm ` repository to install Docker Engine, you can
198
- download the ` .rpm ` file for your release and install it manually. You need to
199
- download a new file each time you want to upgrade Docker Engine.
200
-
201
- <!-- markdownlint-disable-next-line -->
202
- 1 . Go to [ {{% param "download-url-base" %}}/] ({{% param "download-url-base" %}}/)
203
- and choose your version of SLES. Then browse to ` s390x/stable/Packages/ `
204
- and download the ` .rpm ` file for the Docker version you want to install.
205
-
206
- 2 . Install Docker Engine, changing the following path to the path where you downloaded
207
- the Docker package.
208
-
209
- ``` console
210
- $ sudo zypper install /path/to/package.rpm
211
- ```
212
-
213
- Docker is installed but not started. The ` docker ` group is created, but no
214
- users are added to the group.
215
-
216
- 3 . Start Docker Engine.
217
-
218
- ``` console
219
- $ sudo systemctl enable --now docker
220
- ```
221
-
222
- This configures the Docker systemd service to start automatically when you
223
- boot your system. If you don't want Docker to start automatically, use `sudo
224
- systemctl start docker` instead.
225
-
226
- 4 . Verify that the installation is successful by running the ` hello-world ` image:
227
-
228
- ``` console
229
- $ sudo docker run hello-world
230
- ```
231
-
232
- This command downloads a test image and runs it in a container. When the
233
- container runs, it prints a confirmation message and exits.
234
-
235
- You have now successfully installed and started Docker Engine.
236
-
237
- {{% include "root-errors.md" %}}
238
-
239
- #### Upgrade Docker Engine
240
-
241
- To upgrade Docker Engine, download the newer package files and repeat the
242
- [ installation procedure] ( #install-from-a-package ) , using ` zypper -y upgrade `
243
- instead of ` zypper -y install ` , and point to the new files.
244
-
245
- {{% 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).
246
31
247
- ## 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.
248
35
249
- 1 . Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
36
+ ## What this means
250
37
251
- ``` console
252
- $ sudo zypper remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
253
- ```
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
254
42
255
- 2 . Images, containers, volumes, or custom configuration files on your host
256
- aren't automatically removed. To delete all images, containers, and volumes:
43
+ ## If you have Docker currently installed
257
44
258
- ``` console
259
- $ sudo rm -rf /var/lib/docker
260
- $ sudo rm -rf /var/lib/containerd
261
- ```
45
+ If you currently have Docker Engine installed on a SLES s390x system:
262
46
263
- 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
264
51
265
52
## Next steps
266
53
267
- - Continue to [ Post-installation steps for Linux] ( linux-postinstall.md ) .
54
+ For questions about this decision or alternative solutions, contact IBM support.
55
+
56
+ ---
0 commit comments