Skip to content

Commit 2a483c2

Browse files
authored
engine/install: SLES no longer supported (#23310)
- see: docker/docker-install#466 ## Description <!-- Tell us what you did and why --> ## Related issues or tickets <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review Signed-off-by: Paweł Gronowski <[email protected]>
1 parent 021536b commit 2a483c2

File tree

4 files changed

+26
-241
lines changed

4 files changed

+26
-241
lines changed

content/includes/install-script.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b273
5353
5454
You have now successfully installed and started Docker Engine. The `docker`
5555
service starts automatically on Debian based distributions. On `RPM` based
56-
distributions, such as CentOS, Fedora, RHEL or SLES, you need to start it
56+
distributions, such as CentOS, Fedora or RHEL, you need to start it
5757
manually using the appropriate `systemctl` or `service` command. As the message
5858
indicates, non-root users can't run Docker commands by default.
5959

content/manuals/compose/install/linux.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,7 @@ To install the Docker Compose plugin on Linux, you can either:
3030
[Debian](/manuals/engine/install/debian.md#install-using-the-repository) |
3131
[Raspberry Pi OS](/manuals/engine/install/raspberry-pi-os.md#install-using-the-repository) |
3232
[Fedora](/manuals/engine/install/fedora.md#set-up-the-repository) |
33-
[RHEL](/manuals/engine/install/rhel.md#set-up-the-repository) |
34-
[SLES](/manuals/engine/install/sles.md#set-up-the-repository).
33+
[RHEL](/manuals/engine/install/rhel.md#set-up-the-repository).
3534

3635
2. Update the package index, and install the latest version of Docker Compose:
3736

content/manuals/engine/install/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Click on a platform's link to view the relevant installation procedure.
4949
| [Fedora](fedora.md) ||| || |
5050
| [Raspberry Pi OS (32-bit)](raspberry-pi-os.md) | | || | |
5151
| [RHEL](rhel.md) ||| | ||
52-
| [SLES](sles.md) | | | | | |
52+
| [SLES](sles.md) | | | | | |
5353
| [Ubuntu](ubuntu.md) ||||||
5454
| [Binaries](binaries.md) |||| | |
5555

Lines changed: 23 additions & 237 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
---
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)
75
linkTitle: SLES (s390x)
86
weight: 70
97
toc_max: 4
@@ -23,247 +21,35 @@ aliases:
2321
- /install/linux/docker-ee/suse/
2422
- /install/linux/sles/
2523
- /installation/sles/
26-
download-url-base: https://download.docker.com/linux/sles
2724
---
2825

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
14427

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).
24831
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.
25035

251-
1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:
36+
## What this means
25237

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
25642

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
25944

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:
26446

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
26651

26752
## Next steps
26853

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

Comments
 (0)