Add info about default and optional repos (#34)

xml/art-quickstart.xml

@@ -43,6 +43,14 @@
     <phrase>Administration</phrase>
   </meta>
   <revhistory xml:id="rh-art-quickstart">
+    <revision>
+      <date>2024-10-23</date>
+      <revdescription>
+        <para>
+          Add more information about default and optional repositories.
+        </para>
+      </revdescription>
+    </revision>
     <revision>
       <date>2024-06-27</date>
       <revdescription>
@@ -260,6 +268,43 @@
      </orderedlist>
     </listitem>
    </varlistentry>
+   <varlistentry>
+      <term><command>dnf update</command> fails with <literal>Errors during downloading metadata for repository &mdash; Status code: 404</literal></term>
+      <listitem>
+        <para>
+          The repository shown in the error message might not be mirrored on the &rmt; server.
+          The optional <literal>Source</literal> and <literal>Debug</literal> repositories can be
+          enabled with <command>dnf config-manager</command> even if they are not available from &rmt;.
+        </para>
+        <para>
+        </para>
+        <orderedlist>
+          <listitem>
+            <para>
+              Run <command>dnf repolist all</command> to show the status of the repositories.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              If the repository shown in the error message has the status
+              <literal>enabled</literal>, disable it with the following command:
+            </para>
+<screen>&prompt.root;<command>dnf config-manager --disable <replaceable>REPO_ID</replaceable></command></screen>
+          </listitem>
+          <listitem>
+            <para>
+              Run <command>dnf update</command> again to see if the issue is resolved.
+            </para>
+          </listitem>
+          <listitem>
+            <para>
+              If you need the unavailable repository for your system, see
+              <xref linkend="mirror-repositories-with-rmt"/>.
+            </para>
+          </listitem>
+        </orderedlist>
+      </listitem>
+    </varlistentry>
   </variablelist>
  </section>
  <xi:include href="common_legal.xml"/>

xml/install-rmt-vm.xml

@@ -65,15 +65,14 @@
       <important>
         <title>&reponame; &productnumber; repository size</title>
         <para>
-          The &reponame; repositories will grow over time because older package
-          versions are not removed. To meet the 1.5x size recommendation, based on the
-          current<footnote><para>As of 17 September, 2024</para></footnote>
-          size of the &reponame; &productnumber; repositories, you will need approximately
-          495&nbsp;GB of disk space available for the &rmt; server.
+          The &reponame; &productnumber; repositories will grow over time because older package versions
+          are not removed. Based on the current<footnote><para>As of 22 October, 2024</para></footnote>
+          size of the repositories, to meet the 1.5 times size recommendation you will need
+          approximately 515&nbsp;GB of disk space for the default repositories.
         </para>
         <para>
-          If you also need the <literal>Source</literal> and <literal>Debug</literal>
-          repositories, you will need an additional 1335&nbsp;GB available.
+          If you need the optional <literal>Source</literal> and <literal>Debug</literal>
+          repositories, you will need an additional 1365&nbsp;GB available.
         </para>
       </important>
     </listitem>

xml/mirror-repositories-with-rmt.xml

@@ -66,7 +66,7 @@
    <para>
     Enable &reponame; &productnumber; using the product ID <literal>1921</literal>:
    </para>
-<screen>&prompt.root;<command>rmt-cli product enable 1921</command></screen>
+<screen>&prompt.root;<command>rmt-cli products enable 1921</command></screen>
    <para>
     This enables all the default repositories associated with the product.
    </para>
@@ -76,7 +76,7 @@
     If your subscription includes the &ha; extension, enable the extension using
     the product ID <literal>1922</literal>:
    </para>
-<screen>&prompt.root;<command>rmt-cli product enable 1922</command></screen>
+<screen>&prompt.root;<command>rmt-cli products enable 1922</command></screen>
    <tip role="compact">
     <para>
      To check whether the &ha; extension is available, run this
@@ -87,10 +87,30 @@
   <step>
    <para>
     If you also need the <literal>Source</literal> or <literal>Debug</literal>
-    repositories, find and enable them with the following commands:
+    repositories, enable them with the following commands:
    </para>
-<screen>&prompt.root;<command>rmt-cli repo list --all | grep RES-</command>
-&prompt.root;<command>rmt-cli repo enable <replaceable>REPO_ID</replaceable></command></screen>
+   <itemizedlist>
+     <listitem>
+       <para>
+         <literal>RES-8-Source-Updates</literal>, <literal>RES-AS-8-Source-Updates</literal> and
+         <literal>RES-CB-8-Source-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 3879 3922 3925</command></screen>
+     </listitem>
+     <listitem>
+       <para>
+         <literal>RES-8-Debug-Updates</literal>, <literal>RES-AS-8-Debug-Updates</literal> and
+         <literal>RES-CB-8-Debug-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 3881 3923 3926</command></screen>
+     </listitem>
+     <listitem>
+       <para>
+         <literal>RES-8-HA-Source-Updates</literal> and <literal>RES-8-HA-Debug-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 3883 3884</command></screen>
+     </listitem>
+   </itemizedlist>
   </step>
   <step>
    <para>

xml/register-with-rmt.xml

@@ -136,17 +136,6 @@ Installed Products:
 ------------------------------------------
 </screen>
   </step>
-  <step>
-   <para>
-    Verify the available repositories:
-   </para>
-<screen>&prompt.root;<command>dnf repolist</command></screen>
-   <para>
-    You should see <literal>RES-&productnumber;-Updates</literal>,
-    <literal>RES-AS-&productnumber;-Updates</literal>,
-    and <literal>RES-CB-&productnumber;-Updates</literal>.
-   </para>
-  </step>
   <step>
    <para>
     If your subscription includes the &ha; extension, activate it with the
@@ -160,6 +149,34 @@ Installed Products:
     </para>
    </tip>
   </step>
+  <step>
+   <para>
+    Verify the available repositories:
+   </para>
+<screen>&prompt.root;<command>dnf repolist all</command></screen>
+   <para>
+    The default repositories <literal>RES-&productnumber;-Updates</literal>,
+    <literal>RES-AS-&productnumber;-Updates</literal> and
+    <literal>RES-CB-&productnumber;-Updates</literal> should be <literal>enabled</literal>.
+    If you activated the &ha; extension, <literal>RES-8-HA-Updates</literal> should also be
+    <literal>enabled</literal>.
+   </para>
+   <para>
+     You will also see optional <literal>Source</literal> and <literal>Debug</literal>
+     repositories with the status <literal>disabled</literal>. Be aware that these
+     repositories are listed even if they are not mirrored on the &rmt; server.
+     You can check the mirrored repositories by browsing the directory listing at
+     <literal>https://<replaceable>RMT_SERVER</replaceable>/repo/SUSE/Updates/</literal>
+     or by logging in to the &rmt; server and running <command>rmt-cli repos list</command>.
+   </para>
+  </step>
+  <step>
+    <para>
+      If you need the <literal>Source</literal> or <literal>Debug</literal> repositories,
+      enable them with the following command:
+    </para>
+<screen>&prompt.root;<command>dnf config-manager --enable <replaceable>REPO_ID</replaceable></command></screen>
+  </step>
   <step>
    <para>
     Run the update command to make sure there are no errors: