Add SUMA guide and clarify subscriptions

jsc#DOCTEAM-1621
SUSE · Oct 31, 2024 · 1bcdb56 · 1bcdb56
1 parent 751ccfa
commit 1bcdb56
Show file tree

Hide file tree

Showing 8 changed files with 446 additions and 35 deletions.
diff --git 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
@@ -0,0 +1,13 @@
+#
+# DC file for SUSE Liberty Linux with SUMA
+#
+MAIN="art-suma-quickstart.xml"
+ROOTID="art-suma-quickstart"
+
+PROFAUDIENCE="sll"
+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
@@ -22,8 +22,12 @@
   <xi:include href="common_copyright_gfdl.xml"/>
   <abstract>
    <para>
-    This guide describes how to use &productname; to update &rhel;&nbsp;&productnumber;
-    or CentOS&nbsp;Linux&nbsp;&productnumber;.
+    This guide explains how to register and update &rhla;&nbsp;&productnumber; or
+    CentOS&nbsp;Linux&nbsp;&productnumber; with &rmtool; (&rmt;).
+   </para>
+   <para>
+    To register with &suma;, see <link xlink:href="https://documentation.suse.com/liberty/7/html/suma-quickstart/art-suma-quickstart.html">
+    <citetitle>Registering &rhla; &productnumber; or CentOS Linux &productnumber; with &suma;</citetitle></link>.
    </para>
   </abstract>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
@@ -37,12 +41,20 @@
    <dm:translation>no</dm:translation>
   </dm:docmanager>
     <meta name="description" its:translate="yes">How to use SUSE Liberty Linux and RMT to update Red Hat Enterprise Linux 7 or CentOS Linux 7.</meta>
-  <meta name="social-descr" its:translate="yes">Use SUSE Liberty Linux to update RHEL 7 or CentOS 7.</meta>
+  <meta name="social-descr" its:translate="yes">Use RMT to update RHEL 7 or CentOS 7.</meta>
   <meta name="task" its:translate="yes">
     <phrase>Upgrade &amp; Update</phrase>
     <phrase>Administration</phrase>
   </meta>
   <revhistory xml:id="rh-art-quickstart">
+    <revision>
+      <date>2024-10-31</date>
+      <revdescription>
+        <para>
+          Clarify the tools available with each subscription level.
+        </para>
+      </revdescription>
+    </revision>
     <revision>
       <date>2024-10-18</date>
       <revdescription>
@@ -126,8 +138,8 @@
      </para>
      <para>
        To register new &rhla;&nbsp;&productnumber; or CentOS&nbsp;Linux&nbsp;&productnumber;
-       systems, and to continue receiving new updates for existing systems, you must purchase a
-       <emphasis>&reponame; &productnumber;</emphasis> subscription.
+       systems, and to continue receiving new updates for existing systems, you must use an
+       <emphasis>LTSS</emphasis> subscription.
      </para>
      <para>
        Additionally, the optional &ha; extension is no longer supported with
@@ -142,23 +154,82 @@
    </important>
    <para>
     &productname; is a technology and support solution for mixed Linux environments.
-    With a &productname; subscription, you can register and receive updates for
-    &rhel;, CentOS Linux, and &sles;.
+    With a &productname; subscription, you can register and update &rhel; and CentOS Linux.
    </para>
+   <para>
+    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.
+   </para>
+   <table xml:id="supported-distros-and-reg-tools">
+     <title>Supported distributions and registration options</title>
+     <tgroup cols="3">
+     <colspec colname="c1" colwidth="31%"/>
+     <colspec colname="c2" colwidth="38%"/>
+     <colspec colname="c3" colwidth="31%"/>
+       <thead>
+         <row>
+           <entry>Subscription</entry>
+           <entry>Supported distributions</entry>
+           <entry>Registration options</entry>
+         </row>
+       </thead>
+       <tbody>
+         <row>
+           <entry><para><emphasis>&productname; Enterprise</emphasis></para></entry>
+           <entry>
+            <para>CentOS Linux</para>
+            <para>&rhel;</para>
+            <para>&sles;</para>
+           </entry>
+           <entry>
+            <para>&suma;</para>
+            <para>&rmtool;</para>
+           </entry>
+         </row>
+         <row>
+           <entry><para><emphasis>&productname; Professional</emphasis></para></entry>
+           <entry>
+            <para>CentOS Linux</para>
+            <para>&rhel;</para>
+           </entry>
+           <entry><para>&suma;</para></entry>
+         </row>
+         <row>
+           <entry><para><emphasis>&productname; Basic</emphasis></para></entry>
+           <entry><para>CentOS Linux</para></entry>
+           <entry><para>&suma;</para></entry>
+         </row>
+         <row>
+           <entry><para><emphasis>&productname; Lite</emphasis></para></entry>
+           <entry>
+            <para>CentOS Linux</para>
+            <para>Includes <emphasis>one</emphasis> entitlement for &slsa; to host &rmt;</para>
+           </entry>
+           <entry><para>&rmtool;</para></entry>
+         </row>
+       </tbody>
+     </tgroup>
+   </table>
    <important role="compact">
     <para>
      CentOS&nbsp;Stream is not supported.
     </para>
    </important>
+   <important role="compact">
+    <para>
+      Registering &rhla; or CentOS Linux directly with &scc; is not currently supported.
+    </para>
+   </important>
    <para>
-    You can register &rhla; &productnumber; or CentOS Linux &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.
    </para>
    <para>
-    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 <link xlink:href="https://documentation.suse.com/liberty/7/html/suma-quickstart/art-suma-quickstart.html">
+    <citetitle>Registering &rhla; &productnumber; or CentOS Linux &productnumber; with &suma;</citetitle></link>.
    </para>
+
    <itemizedlist>
     <title>Procedure overview</title>
     <listitem>
@@ -202,24 +273,36 @@
       <citetitle>&rmtguide;</citetitle></link>
      </para>
     </listitem>
+    <listitem>
+      <para>
+        <link xlink:href="https://documentation.suse.com/liberty/7/html/suma-quickstart/art-suma-quickstart.html">
+        <citetitle>Registering &rhla; 7 or CentOS Linux 7 with &suma;</citetitle></link>
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        <link xlink:href="https://documentation.suse.com/liberty/8/html/suma-quickstart/art-suma-quickstart.html">
+        <citetitle>Registering &rhla; 8 or CentOS Linux 8 with &suma;</citetitle></link>
+      </para>
+    </listitem>
     <listitem>
      <para>
       <link xlink:href="https://documentation.suse.com/liberty/8/html/quickstart/art-quickstart.html">
       <citetitle>Registering &rhla; 8 or CentOS Linux 8 with RMT</citetitle></link>
      </para>
     </listitem>
+    <listitem>
+      <para>
+        <link xlink:href="https://documentation.suse.com/liberty/9/html/suma-quickstart/art-suma-quickstart.html">
+        <citetitle>Registering &rhla; 9 with &suma;</citetitle></link>
+      </para>
+    </listitem>
     <listitem>
      <para>
       <link xlink:href="https://documentation.suse.com/liberty/9/html/quickstart/art-quickstart.html">
       <citetitle>Registering &rhla; 9 with RMT</citetitle></link>
      </para>
     </listitem>
-    <listitem>
-      <para>
-        <link xlink:href="https://documentation.suse.com/suma/4.3/en/suse-manager/client-configuration/clients-sleses.html">
-        <citetitle>&suma; Client Configuration Guide: Registering &sliberty; Clients</citetitle></link>
-      </para>
-    </listitem>
    </itemizedlist>
  </section>
 
@@ -247,7 +330,7 @@
       </listitem>
     </varlistentry>
     <varlistentry>
-      <term>&productname; doesn't appear in <command>rmt-cli products list</command>
+      <term>&productname; does not appear in <command>rmt-cli products list</command>
       after <command>rmt-cli sync</command></term>
       <listitem>
       <para>