Add info about default and optional repos

SUSE · Oct 22, 2024 · 93107e2 · 93107e2
1 parent debde33
commit 93107e2
Show file tree

Hide file tree

Showing 4 changed files with 104 additions and 23 deletions.
diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml
@@ -43,6 +43,14 @@
     <phrase>Administration</phrase>
   </meta>
   <revhistory xml:id="rh-art-quickstart">
+    <revision>
+      <date>2024-10-22</date>
+      <revdescription>
+        <para>
+          Add more information about default and optional repositories.
+        </para>
+      </revdescription>
+    </revision>
     <revision>
       <date>2024-06-27</date>
       <revdescription>
@@ -241,6 +249,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"/>

diff --git a/xml/install-rmt-vm.xml b/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
-          320&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 21 October, 2024</para></footnote>
+          size of the repositories, to meet the 1.5 times size recommendation you will need
+          approximately 335&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 625&nbsp;GB available.
+          If you need the optional <literal>Source</literal> and <literal>Debug</literal>
+          repositories, you will need an additional 665&nbsp;GB available.
         </para>
       </important>
     </listitem>

diff --git a/xml/mirror-repositories-with-rmt.xml b/xml/mirror-repositories-with-rmt.xml
@@ -65,7 +65,7 @@
    <para>
     Enable &reponame; &productnumber; using the product ID <literal>2538</literal>:
    </para>
-<screen>&prompt.root;<command>rmt-cli product enable 2538</command></screen>
+<screen>&prompt.root;<command>rmt-cli products enable 2538</command></screen>
    <para>
     This enables all the default repositories associated with the product.
    </para>
@@ -75,7 +75,7 @@
     If your subscription includes the &ha; extension, enable the extension using
     the product ID <literal>2539</literal>:
    </para>
-<screen>&prompt.root;<command>rmt-cli product enable 2539</command></screen>
+<screen>&prompt.root;<command>rmt-cli products enable 2539</command></screen>
    <tip role="compact">
     <para>
      To check whether the &ha; extension is available, run this
@@ -86,10 +86,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 SLL-</command>
-&prompt.root;<command>rmt-cli repo enable <replaceable>REPO_ID</replaceable></command></screen>
+   <itemizedlist>
+     <listitem>
+       <para>
+         <literal>SLL-9-Source-Updates</literal>, <literal>SLL-AS-9-Source-Updates</literal> and
+         <literal>SLL-CB-9-Source-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 5964 5967 5970</command></screen>
+     </listitem>
+     <listitem>
+       <para>
+         <literal>SLL-9-Debug-Updates</literal>, <literal>SLL-AS-9-Debug-Updates</literal> and
+         <literal>SLL-CB-9-Debug-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 5965 5968 5971</command></screen>
+     </listitem>
+     <listitem>
+       <para>
+         <literal>SLL-9-HA-Source-Updates</literal> and <literal>SLL-9-HA-Debug-Updates</literal>:
+       </para>
+<screen>&prompt.root;<command>rmt-cli repos enable 5973 5974</command></screen>
+     </listitem>
+   </itemizedlist>
   </step>
   <step>
    <para>

diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml
@@ -135,17 +135,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>SLL-&productnumber;-Updates</literal>,
-    <literal>SLL-AS-&productnumber;-Updates</literal>,
-    and <literal>SLL-CB-&productnumber;-Updates</literal>.
-   </para>
-  </step>
   <step>
    <para>
     If your subscription includes the &ha; extension, activate it with the
@@ -159,6 +148,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>SLL-&productnumber;-Updates</literal>,
+    <literal>SLL-AS-&productnumber;-Updates</literal> and
+    <literal>SLL-CB-&productnumber;-Updates</literal> should be <literal>enabled</literal>.
+    If you activated the &ha; extension, <literal>SLL-9-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: