diff --git a/CHANGELOG.md b/CHANGELOG.md index cd3ac708925..f759517212d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,5 @@ +- Added instructions for Server installation on SUSE Linux + Enterprise Server 15 SP6 to Installation and Upgrade Guide - Remove image with beta reference in Installation and Upgrade Guide (bsc#1236678) - Set version number of host operating system back to SUSE Linux diff --git a/modules/installation-and-upgrade/nav-installation-and-upgrade-guide.adoc b/modules/installation-and-upgrade/nav-installation-and-upgrade-guide.adoc index 8c8ed8730ae..73b35920530 100644 --- a/modules/installation-and-upgrade/nav-installation-and-upgrade-guide.adoc +++ b/modules/installation-and-upgrade/nav-installation-and-upgrade-guide.adoc @@ -35,7 +35,7 @@ endif::[] ifeval::[{suma-content} == true] ** Installation and Deployment *** Server -**** xref:container-deployment/suma/server-deployment-suma.adoc[{productname} Deployment on {sle-micro}] +**** xref:container-deployment/suma/server-deployment-suma.adoc[{productname} Deployment] **** xref:container-deployment/suma/server-deployment-vm-suma.adoc[Server Deployment as Virtual Machine - KVM] **** xref:container-deployment/suma/server-deployment-vmdk-suma.adoc[Server Deployment as Virtual Machine - VMware] **** xref:container-deployment/suma/server-air-gapped-deployment-suma.adoc[Air-gapped Deployment] diff --git a/modules/installation-and-upgrade/pages/container-deployment/suma/server-air-gapped-deployment-suma.adoc b/modules/installation-and-upgrade/pages/container-deployment/suma/server-air-gapped-deployment-suma.adoc index 4c6922c3774..b8e548b6225 100644 --- a/modules/installation-and-upgrade/pages/container-deployment/suma/server-air-gapped-deployment-suma.adoc +++ b/modules/installation-and-upgrade/pages/container-deployment/suma/server-air-gapped-deployment-suma.adoc @@ -3,12 +3,17 @@ ifeval::[{uyuni-content} == true] :noindex: endif::[] + + == What is Air-gapped Deployment? Air-gapped deployment refers to the setup and operation of any networked system that is physically isolated from insecure networks, especially the internet. This type of deployment is commonly used in high-security environments such as military installations, financial systems, critical infrastructure, and anywhere sensitive data is handled and must be protected from external threats. - +[NOTE] +==== +At the moment, air-gapped deployment is available only on {sle-micro}. +==== == Deployments diff --git a/modules/installation-and-upgrade/pages/container-deployment/suma/server-deployment-suma.adoc b/modules/installation-and-upgrade/pages/container-deployment/suma/server-deployment-suma.adoc index 7b9a5a96e39..8428fea9fbb 100644 --- a/modules/installation-and-upgrade/pages/container-deployment/suma/server-deployment-suma.adoc +++ b/modules/installation-and-upgrade/pages/container-deployment/suma/server-deployment-suma.adoc @@ -1,10 +1,11 @@ [[deploy-suma-server]] -= {productname} {productnumber} Server Deployment on {sle-micro} += {productname} {productnumber} Server Deployment ifeval::[{uyuni-content} == true] :noindex: endif::[] -This guide shows you how to install and configure a {productname} {productnumber} container on {sle-micro} {microversion}. +This guide shows you how to install and configure a {productname} {productnumber} container on {sle-micro} {microversion} or {sles} {bci-suma}. + // Link to hardware requirements do not show them here. We list them on other pages. // Done within next section. @@ -19,7 +20,9 @@ For background information about disk space, see xref:installation-and-upgrade:h .Software and Hardware Requirements |=== | Software and Hardware | Recommended -| Operating System | {sle-micro} {microversion} +| Operating System | {sle-micro} {microversion} or + + {sles} {bci-suma} | Architecture | {x86_64}, {arm}, {s390x}, {ppc64le} | Processor (CPU) | Minimum of four (4) 64-bit CPU cores | RAM | 16 GB @@ -33,7 +36,7 @@ For background information about disk space, see xref:installation-and-upgrade:h .Supported operating system for the Server Container Host [NOTE] ==== -The supported operating system for the container host is {sle-micro} {microversion}. +The supported operating system for the container host is {sle-micro} {microversion} or {sles} {bci-suma}. Container host:: A container host is a server equipped with a container engine like [systemitem]``Podman``, which lets it manage and deploy containers. @@ -42,7 +45,6 @@ This setup ensures applications run the same way in different environments. The container host supplies the necessary resources such as CPU, memory, and storage for these containers. ==== - [IMPORTANT] ==== Server deployment mandates the use of a fully qualified domain name (FQDN). @@ -82,12 +84,11 @@ Recommended minimum size for this is at least 300 GB, and larger if there will Recommended Filesystem:: XFS (though any supported filesystem for {sle-micro} {microversion} could work). -==== - Optional:: You can provide custom storage for the volumes by mounting disks on the expected volume path inside it such as [path]``/var/lib/containers/storage/volumes/var-spacewalk``. This adds to the complexity of a {productname} deployment, and may affect the resilience the default storage recommendation provides. +==== For a list of all persistent volumes in the container, see xref:installation-and-upgrade:container-management/persistent-container-volumes.adoc[]. @@ -96,7 +97,7 @@ For a list of all persistent volumes in the container, see xref:installation-and [[deploy-suma-server-micro]] -== {sle-micro} {microversion} Installation +== Deploy {productname} on {sle-micro} {microversion} .Procedure: Download the Installation Media . Locate the {sle-micro} {microversion} installation media at https://www.suse.com/download/sle-micro/. @@ -104,6 +105,7 @@ For a list of all persistent volumes in the container, see xref:installation-and . Prepare a DVD or USB flash drive with the downloaded [filename]``.iso`` image for installation. . Insert the DVD or USB flash drive (USB disk or key) containing the installation image for {sle-micro} {microversion}. . Boot or reboot your system. + + For more information about preparing your machines (virtual or physical), see link:https://documentation.suse.com/sle-micro/5.5/html/SLE-Micro-all/book-deployment-slemicro.html[{sle-micro} {microversion} Deployment Guide]. @@ -116,6 +118,7 @@ For more information about preparing your machines (virtual or physical), see li . Click [systemitem]``Next`` to continue. . Select the registration method. For this example, we will register the server with {scclongform}. + + .Registering {productname} as an Extension during Installation @@ -128,7 +131,9 @@ Depending on the specific extension needed from the list below, additional {sccl * {productname} {productnumber} Proxy * Retail Branch Server ==== + + + [IMPORTANT] ==== The {sle-micro} {microversion} entitlement is included within the {productname} entitlement, so it does not require a separate registration code. @@ -157,13 +162,17 @@ This section provides steps on registering your products after {sle-micro} {micr .Procedure: Post Installation Product Registration . Register {sle-micro} {microversion} to {scclongform} from the command line run the following commands on the container host: + + + ---- transactional-update register -r -e ---- . Use the registration code you obtained from your {scclongform} account for {sle-micro} {microversion}. + + + [NOTE] ==== The following steps register a server with the {x86_64} architecture and thus require a registration code for the {x86_64} architecture. @@ -172,13 +181,17 @@ To register {arm} or {s390x} architectures use the correct registration code. . Next add the **SUSE Manager Server Extension 5.0 x86_64** Extension. List available extensions with the following command: + + + ---- transactional-update --quiet register --list-extensions ---- . Use your **SUSE Manager Server Extension 5.0 x86_64** registration code with the following command: + + + ---- transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r ---- @@ -190,6 +203,7 @@ transactional-update register -p SUSE-Manager-Server/5.0/x86_64 -r .Procedure . Log in as *root*. . Run **transactional-update**: + + [source, shell] @@ -208,19 +222,26 @@ It is highly recommended to configure custom persistent storage with the [comman This tool simplifies creating the container storage and database volumes. + Use the command in the following manner: + + ---- mgr-storage-server [] ---- + + + For example: + + + ---- mgr-storage-server /dev/nvme1n1 /dev/nvme2n1 ---- + + + [NOTE] ==== This command will create the persistent storage volumes at [path]``/var/lib/containers/storage/volumes``. @@ -232,6 +253,43 @@ For more information, see ==== +ifeval::[{suma-content} == true] +== Install {productname} on {sles} {bci-suma} + +Alternatively, you can install {productname} on {sles} {bci-suma}. +The following procedure describes the main steps of the installation process. + +.Procedure: Installing {productname} on {sles} {bci-suma} +. Locate and download {sles} {bci-suma} [literal]``.iso`` at https://www.suse.com/download/sles/. +. Make sure that the {scc} code you plan to use has the Extensions enabled. +. Start the installation of {sles} {bci-suma}. + .. On the [literal]``Language, keyboard and product selection`` select the product to install. + .. On the [literal]``License agreement`` read the agreement and check [guimenu]``I Agree to the License Terms``. +. Select the registration method. +. In the screen [literal]``Extensions and Modules Selection`` check the following: + * {productname} Server Extension + * Basesystem Module + * Containers Module +. Complete the installation. +. When the installation completes, log in to the newly installed server as root. +. As root, run + ++ + +[source,shell] +---- +zypper install podman +---- +. Finish the {productname} installation on {sles} {bci-suma} by running command: + ++ + +[source,shell] +---- +mgradm install podman +---- +endif::[] + [[deploy-suma-server-mgradm]] == Deploy with [literal]``mgradm`` @@ -239,11 +297,14 @@ For more information, see .Procedure: Deploying {productname} {productnumber} Using [literal]``mgradm`` . Log in as root. . Execute the following command, replacing `` with your fully qualified domain name: + + + [source,shell] ---- mgradm install podman ---- + + [IMPORTANT] @@ -260,6 +321,7 @@ Use the {productname} {productnumber} registration key when prompted. ==== . Enter a certificate and administrator account password when prompted. + + [NOTE] @@ -267,6 +329,7 @@ Use the {productname} {productnumber} registration key when prompted. The administrator account password must be at least 5 characters and less than 48 characters in length. ==== + + . Press btn:[Enter]. @@ -323,10 +386,13 @@ When the credentials are confirmed with a green check-mark icon, proceed with << You can monitor the progress of the operation in section on the right ``Refresh the product catalog from {scclongform}``. The table of products lists architecture, channels, and status information. For more information, see xref:reference:admin/setup-wizard.adoc[Wizard]. + + + image::admin_suse_products.png[scaledwidth=80%] . Use the ``Filter by product description`` and ``Filter by architecture`` to filter the list of displayed products. The channels listed on the btn:[Products] page provide repositories for clients. + + * Add channels to {productname} by selecting the check box to the left of each channel. diff --git a/modules/installation-and-upgrade/pages/hardware-requirements.adoc b/modules/installation-and-upgrade/pages/hardware-requirements.adoc index 3e3307837e9..7a3865ccf15 100644 --- a/modules/installation-and-upgrade/pages/hardware-requirements.adoc +++ b/modules/installation-and-upgrade/pages/hardware-requirements.adoc @@ -27,11 +27,17 @@ For {productname} {smr} hardware requirements, see xref:retail:retail-requiremen [[server-hardware-requirements]] == Server Requirements -{sle-micro} {microversion} is ths operation system of the container host and requires as free disk space: +One of {sle-micro} {microversion} or {sles} {sles-version} {sp-version} is the operating system of the container host. +In the following, {sles} as the installed host operating system is explicitly mentioned only if it matters. +Otherwise we either write {sle-micro} or just host operating system. + +The container host with {sle-micro} as operating system requires as free disk space: * Minimum for base installation 100 GB * Plus a minimum of 130 GB for repository data +Depending on the amount of selected software, {sles} as operating system can require considerably more disk space. + By default the {productname} Server container stores mirrored repository (packages or products), database, and other data in subdirectories of the [path]``/var/lib/containers/storage/volumes/`` directory. Repository synchronization fails if this directory runs out of disk space. Estimate how much space the [path]``/var/lib/containers/storage/volumes/`` directory requires based on the number and kind of clients and repositories you plan to mirror. @@ -253,6 +259,11 @@ We recommend you use XFS as the filesystem type for all volumes. The size of the disk for repositories storage is dependent on the number of distributions and channels you intend to manage with {productname}. See the tables in this section for guides to estimate the size required. +[IMPORTANT] +==== +Do not use NFS for storage because it does not support SELinux file labeling. +==== + On the {productname} Server, use this command to find all available storage devices: ---- @@ -288,10 +299,10 @@ The disk setup is virtual and separate disks for volumes are possible and recomm // container-deployment/suma/server-deployment-suma.adoc For other deployments, separate disks for volumes are also recommended. -On the {productname} Server, the [command]``mgr-storage-server`` command moves the complete content of the [path]``/var/lib/containers/storage/volumes`` directory to a separate disk and remounts it to [path]``/var/lib/containers/storage/volumes``. +On the container host of the {productname} Server, the [command]``mgr-storage-server`` command moves the complete content of the [path]``/var/lib/containers/storage/volumes`` directory to a separate disk and remounts it to [path]``/var/lib/containers/storage/volumes``. Optionally, if a second device name is specified, [command]``mgr-storage-server`` moves the content of the [path]``/var/lib/containers/storage/volumes/var-pgsql`` database directory to a second separate disk and remounts it to [path]``/var/lib/containers/storage/volumes/var-pgsql``. -Similarily on the {productname} Proxy, the [command]``mgr-storage-proxy`` command moves the complete content of the [path]``/var/lib/containers/storage/volumes`` directory to a separate disk and remounts it to [path]``/var/lib/containers/storage/volumes``. +Similarly, on the container host of the {productname} Proxy, the [command]``mgr-storage-proxy`` command moves the complete content of the [path]``/var/lib/containers/storage/volumes`` directory to a separate disk and remounts it to [path]``/var/lib/containers/storage/volumes``.