Skip to content

Commit d2426ae

Browse files
committed
engine/install: SLES no longer supported
Signed-off-by: Paweł Gronowski <[email protected]>
1 parent ec19565 commit d2426ae

File tree

4 files changed

+27
-239
lines changed

4 files changed

+27
-239
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: 24 additions & 235 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,245 +21,36 @@ 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-
### 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
14627

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).
24631
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.
24835

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

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
25442

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
25744

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

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
26451

26552
## Next steps
26653

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

Comments
 (0)