From af3c53cd1de5c336fa07d8880416bf05d11d6203 Mon Sep 17 00:00:00 2001 From: Tom Schraitle Date: Thu, 10 Aug 2023 14:19:19 +0200 Subject: [PATCH 1/3] Fix bsc#1209302: add some hints for SLES SUSE Linux Enterprise Server (SLES) has KIWI as a package. However, some KIWI extensions and their dependencies can be unavailable. This commit introduces a new section which deals with this aspect. --- doc/source/installation.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index fb0ad602edd..389b4e222fe 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -94,6 +94,32 @@ Fedora/Rawhide: $ sudo dnf install kiwi-cli + + +Installation for SUSE Linux Enterprise Server +--------------------------------------------- + +{kiwi} is available and supported for SUSE Linux Enterprise Server (SLES). +The recommended and supported way is to install {kiwi} by using zypper. + +However, if your rely on some extensions for {kiwi}, either the extension +itself or any dependencies might not be available for your service pack. + +If you want to proceed anyway, keep these things in mind: + +* Extensions that are not provided by SLES are not supported. +* You probably need to install dependencies via :command:`pip`. + The :command:`pip` command installs these dependencies from PyPI + (the Python Package Index). + However, this approach will not update the RPM database. +* Depending on your security concerns, installing Python packages + outside the secured SLES installation may not be desirable. +* Python packages installed from PyPI won't contain any SUSE + customizations. +* Depending on your extension and its dependencies, you might even need + a more recent Python version. + + .. _example-descriptions: Example Appliance Descriptions From aa71f6bf41dbcc6622807d25d41d62dcee389acc Mon Sep 17 00:00:00 2001 From: Tom Schraitle Date: Fri, 11 Aug 2023 09:51:00 +0200 Subject: [PATCH 2/3] Use "plugin" instead of "extension" --- doc/source/installation.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index 389b4e222fe..dc1d85eece6 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -102,12 +102,12 @@ Installation for SUSE Linux Enterprise Server {kiwi} is available and supported for SUSE Linux Enterprise Server (SLES). The recommended and supported way is to install {kiwi} by using zypper. -However, if your rely on some extensions for {kiwi}, either the extension +However, if you rely on some plugins for {kiwi}, either the plugin itself or any dependencies might not be available for your service pack. If you want to proceed anyway, keep these things in mind: -* Extensions that are not provided by SLES are not supported. +* Plugins that are not provided by SLES are not supported. * You probably need to install dependencies via :command:`pip`. The :command:`pip` command installs these dependencies from PyPI (the Python Package Index). From 31b599c71cbca7554ff2e2b998ca6ef054b769e0 Mon Sep 17 00:00:00 2001 From: Tom Schraitle Date: Tue, 15 Aug 2023 08:50:10 +0200 Subject: [PATCH 3/3] Fix SLES -> SLE --- doc/source/installation.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/source/installation.rst b/doc/source/installation.rst index dc1d85eece6..0ea87fccbcb 100644 --- a/doc/source/installation.rst +++ b/doc/source/installation.rst @@ -96,10 +96,10 @@ Fedora/Rawhide: -Installation for SUSE Linux Enterprise Server ---------------------------------------------- +Installation for SUSE Linux Enterprise +-------------------------------------- -{kiwi} is available and supported for SUSE Linux Enterprise Server (SLES). +{kiwi} is available and supported for SUSE Linux Enterprise (SLE). The recommended and supported way is to install {kiwi} by using zypper. However, if you rely on some plugins for {kiwi}, either the plugin @@ -107,13 +107,13 @@ itself or any dependencies might not be available for your service pack. If you want to proceed anyway, keep these things in mind: -* Plugins that are not provided by SLES are not supported. +* Plugins that are not provided by SLE are not supported. * You probably need to install dependencies via :command:`pip`. The :command:`pip` command installs these dependencies from PyPI (the Python Package Index). However, this approach will not update the RPM database. * Depending on your security concerns, installing Python packages - outside the secured SLES installation may not be desirable. + outside the secured SLE installation may not be desirable. * Python packages installed from PyPI won't contain any SUSE customizations. * Depending on your extension and its dependencies, you might even need