From 6a1c2205dd0c602c3c13a43fc7cab0f9831aedf8 Mon Sep 17 00:00:00 2001 From: Tahlia Richardson <3069029+tahliar@users.noreply.github.com> Date: Thu, 31 Oct 2024 17:46:58 +1000 Subject: [PATCH] Add SUMA guide and clarify subscriptions (SLL9) (#37) * Add SUMA guide and clarify subscriptions jsc#DOCTEAM-1621 * Small fixes --- DC-quickstart | 2 +- DC-suma-quickstart | 12 ++ xml/art-quickstart.xml | 114 ++++++++++--- xml/art-suma-quickstart.xml | 242 +++++++++++++++++++++++++++ xml/configure-rmt-server.xml | 2 +- xml/install-rmt-vm.xml | 7 +- xml/mirror-repositories-with-rmt.xml | 2 +- xml/register-with-rmt.xml | 2 +- 8 files changed, 359 insertions(+), 24 deletions(-) create mode 100644 DC-suma-quickstart create mode 100644 xml/art-suma-quickstart.xml diff --git a/DC-quickstart b/DC-quickstart index 9097858..67f54f0 100644 --- a/DC-quickstart +++ b/DC-quickstart @@ -1,5 +1,5 @@ # -# DC file for SUSE Liberty Linux +# DC file for SUSE Liberty Linux with RMT # MAIN="art-quickstart.xml" ROOTID="art-quickstart" diff --git a/DC-suma-quickstart b/DC-suma-quickstart new file mode 100644 index 0000000..0c8b141 --- /dev/null +++ b/DC-suma-quickstart @@ -0,0 +1,12 @@ +# +# DC file for SUSE Liberty Linux with SUSE Manager +# +MAIN="art-suma-quickstart.xml" +ROOTID="art-suma-quickstart" + +PROFCONDITION="suse-product" +#PROFCONDITION="suse-product;beta" +#PROFCONDITION="community-project" + +STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns" +FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns" diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml index 5076edb..08de516 100644 --- a/xml/art-quickstart.xml +++ b/xml/art-quickstart.xml @@ -15,14 +15,19 @@ xmlns:xlink="http://www.w3.org/1999/xlink"> - Registering &rhla; &productnumber; with RMT + Registering &rhla; &productnumber; with &rmt; &productname; &productnameshort; - This guide describes how to use &productname; to update &rhel; &productnumber;. + This guide explains how to register and update &rhla; &productnumber; with &rmtool; (&rmt;). + + + To register with &suma;, see + + Registering &rhla; &productnumber; with &suma;. @@ -35,14 +40,22 @@ https://github.com/SUSE/doc-liberty/edit/main/xml/ no - Registering &rhla; &productnumber; with RMT - How to use SUSE Liberty Linux to update Red Hat Enterprise Linux 9. - How to use SUSE Liberty Linux to update RHEL 9. + Registering &rhla; &productnumber; with &rmt; + How to use SUSE Liberty Linux and RMT to update Red Hat Enterprise Linux 9. + How to use RMT to update RHEL 9. Upgrade & Update Administration + + 2024-10-31 + + + Clarify the tools available with each subscription level. + + + 2024-10-22 @@ -82,23 +95,74 @@ Introduction &productname; is a technology and support solution for mixed Linux environments. - With a &productname; subscription, you can register and receive updates for - &rhel; and &sles;. An optional &ha; extension is also available. + With a &productname; subscription, you can register and update &rhel;. + An optional &ha; extension is also available. + + + The following table shows which Linux distributions are supported by each subscription. These + subscriptions also include an entitlement for a registration tool to manage package updates. + + Supported distributions and registration options + + + + + + + SubscriptionThe Lite and + Basic subscriptions only support CentOS Linux, + so are not applicable to &productname; &productnumber;. + Supported distributionsThere is no CentOS Linux &productnumber;, so + CentOS Linux support is not applicable to &productname; &productnumber;. + Registration options + + + + + &productname; Enterprise + + CentOS Linux + &rhel; + &sles; + + + &suma; + &rmtool; + + + + &productname; Professional + + CentOS Linux + &rhel; + + &suma; + + + +
CentOS Stream is not supported. + + + Registering &rhla; directly with &scc; is not currently supported. + + - You can register &rhla; &productnumber; with either &suma; or the &rmtool; (&rmt;). - Registering directly with the &scc; is not currently supported. + This guide describes how to register with &rmtool; (&rmt;). &rmt; is a proxy system for + &scc;. The &rmt; server is registered with &scc;, and other systems are registered with + the &rmt; server and receive packages from it directly. - This guide describes how to register with an &rmt; server. &rmt; is a proxy system for the - &scc;. The &rmt; server is registered with the &scc;, and other systems in the network are - registered with the &rmt; server and receive packages from it directly. + To register with &suma;, see + + Registering &rhla; &productnumber; with &suma;. + Procedure overview @@ -132,22 +196,34 @@ - - Registering &rhla; 7 or CentOS Linux 7 with RMT + + Registering &rhla; 7 or CentOS Linux 7 with &suma; - - Registering &rhla; 8 or CentOS Linux 8 with RMT + + Registering &rhla; 7 or CentOS Linux 7 with &rmt; - - &suma; Client Configuration Guide: Registering &sliberty; Clients + + Registering &rhla; 8 or CentOS Linux 8 with &suma; + + + + Registering &rhla; 8 or CentOS Linux 8 with &rmt; + + + + + + Registering &rhla; 9 with &suma; + + @@ -175,7 +251,7 @@ - &productname; doesn't appear in rmt-cli products list + &productname; does not appear in rmt-cli products list after rmt-cli sync diff --git a/xml/art-suma-quickstart.xml b/xml/art-suma-quickstart.xml new file mode 100644 index 0000000..258d91d --- /dev/null +++ b/xml/art-suma-quickstart.xml @@ -0,0 +1,242 @@ + + + + %entities; +]> + +
+ + + Registering &rhla; &productnumber; with &suma; + &productname; + &productnameshort; + + + + + This guide explains how to register and update &rhla; &productnumber; with &suma;. + + + To register with &rmt;, see + Registering &rhla; &productnumber; with &rmt;. + + + + + https://github.com/SUSE/doc-liberty/issues/new + documentation,issue + 8 + tahliar + + https://github.com/SUSE/doc-liberty/edit/main/xml/ + no + Registering &rhla; &productnumber; with &suma; + How to use SUSE Liberty Linux and SUSE Manager to update RHEL 9. + Use SUSE Manager to update RHEL 9. + + Upgrade & Update + Administration + + + + 2024-10-31 + + + Initial guide creation. + + + + + + +
+ Introduction + + &productname; is a technology and support solution for mixed Linux environments. + With a &productname; subscription, you can register and update &rhel;. + An optional &ha; extension is also available. + + + The following table shows which Linux distributions are supported by each subscription. These + subscriptions also include an entitlement for a registration tool to manage package updates. + + + Supported distributions and registration options + + + + + + + SubscriptionThe Lite and + Basic subscriptions only support CentOS Linux, + so are not applicable to &productname; &productnumber;. + Supported distributionsThere is no CentOS Linux &productnumber;, so + CentOS Linux support is not applicable to &productname; &productnumber;. + Registration options + + + + + &productname; Enterprise + + CentOS Linux + &rhel; + &sles; + + + &suma; + &rmtool; + + + + &productname; Professional + + CentOS Linux + &rhel; + + &suma; + + + +
+ + + CentOS Stream is not supported. + + + + + Registering &rhla; directly with &scc; is not currently supported. + + + + This guide describes how to register with &suma;. &suma; is a lifecycle management system for + mixed Linux environments. The &suma; Server is registered with &scc;, and other systems are + registered as clients of &suma; and receive packages from it directly. + + + To register with &rmtool;, see + + Registering &rhla; 9 with &rmt;. + + + + Procedure overview + + + If &suma; is already set up and you only need to register your + &rhla; &productnumber; system, skip straight to + . + + + + + If you still need to set up &suma;, start with + . + + + + + Related information + + + &suma; documentation + + + + + + Registering &rhla; 7 or CentOS Linux 7 with &suma; + + + + + + Registering &rhla; 7 or CentOS Linux 7 with &rmt; + + + + + + Registering &rhla; 8 or CentOS Linux 8 with &suma; + + + + + + Registering &rhla; 8 or CentOS Linux 8 with &rmt; + + + + + + Registering &rhla; 9 with &rmt; + + + +
+ +
+ Deploying &suma; + + See the following guide to install &suma; on &slem;, a lightweight, immutable operating system + for containerized and virtual workloads: + + &suma; Quick Start: Deploy &suma; Server. + + + You can use your &productname; subscription to register this machine. + + + Other installation options + + For additional installation options, see the full + + &suma; Installation and Upgrade Guide. + + + To deploy &suma; in the public cloud, see + + &suma; Public Cloud Guide. + + + + &reponame; &productnumber; repository size + + The &reponame; &productnumber; repositories will grow over time because older package versions + are not removed. Based on the currentAs of 22 October, 2024 + size of the repositories, to meet the 1.5 times size recommendation you will need + approximately 335 GB of disk space for the default repositories. + + + If you need the optional Source and Debug + repositories, you will need an additional 665 GB available. + + +
+ +
+ Registering &rhla; with &suma; + + See the following guide to register &rhel; &productnumber; with &suma;: + + &suma; Client Configuration Guide: Registering &sliberty; Clients. + + + + CentOS Stream is not supported. + + +
+ + +
diff --git a/xml/configure-rmt-server.xml b/xml/configure-rmt-server.xml index bc0fab1..e0149c5 100644 --- a/xml/configure-rmt-server.xml +++ b/xml/configure-rmt-server.xml @@ -70,7 +70,7 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install - To find your organization credentials, log in to the + To find your organization credentials, log in to &scc;, select your organization from My Organizations, and click Proxies. Your organization's Mirroring diff --git a/xml/install-rmt-vm.xml b/xml/install-rmt-vm.xml index 28aeb48..e4ce928 100644 --- a/xml/install-rmt-vm.xml +++ b/xml/install-rmt-vm.xml @@ -21,7 +21,12 @@ Use this procedure to install a &minvm;, a preconfigured virtual machine image that contains a slimmed-down version of &sles; (&slsa;). This machine will be the &rmtool; (&rmt;) server. - You can use your &productname; subscription to register this machine. + + + You can use your &productname; Enterprise subscription to register + this machine. &productname; Professional does not include an entitlement + for &slsa;, so you will need a separate &slsa; subscription if you want to use &rmt; + instead of &suma;. Other installation options diff --git a/xml/mirror-repositories-with-rmt.xml b/xml/mirror-repositories-with-rmt.xml index ab32dd7..45e7b68 100644 --- a/xml/mirror-repositories-with-rmt.xml +++ b/xml/mirror-repositories-with-rmt.xml @@ -42,7 +42,7 @@ - You have a &productname; subscription activated in the &scc;. + You have a &productname; subscription activated in &scc;. diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml index 75a415f..f2b6b8b 100644 --- a/xml/register-with-rmt.xml +++ b/xml/register-with-rmt.xml @@ -51,7 +51,7 @@ - You have a &productname; subscription activated in the &scc;. + You have a &productname; subscription activated in &scc;.