From 000e1977e50b30799bc0c7c1cff917d861c6a815 Mon Sep 17 00:00:00 2001
From: Tahlia Richardson <3069029+tahliar@users.noreply.github.com>
Date: Fri, 18 Oct 2024 17:31:22 +1000
Subject: [PATCH] More info about default and optional repos (#32)
* BASE-Updates repo is not enabled by default
* Standardise rmt-cli commands
They all still worked as written though so idk
* More info about default and optional repos
* Add revision history entries
---
xml/art-lite-quickstart.xml | 46 ++++++++++++++++++++++
xml/art-quickstart.xml | 46 ++++++++++++++++++++++
xml/install-rmt-vm.xml | 21 ++++++----
xml/mirror-repositories-with-rmt.xml | 59 ++++++++++++++++++++--------
xml/register-with-rmt.xml | 28 +++++++++++--
5 files changed, 173 insertions(+), 27 deletions(-)
diff --git a/xml/art-lite-quickstart.xml b/xml/art-lite-quickstart.xml
index 036b020..c6932af 100644
--- a/xml/art-lite-quickstart.xml
+++ b/xml/art-lite-quickstart.xml
@@ -43,6 +43,14 @@
Administration
+
+ 2024-10-18
+
+
+ Add more information about default and optional repositories.
+
+
+
2024-08-01
@@ -207,6 +215,44 @@
+
+ yum update fails with [Errno 14] HTTPS Error 404 - Not Found
+
+
+ The repository shown in the error message might not be mirrored on the &rmt; server.
+ The optional BASE, Source and Debug
+ repositories can be enabled with yum-config-manager even if they are
+ not available from &rmt;.
+
+
+
+
+
+
+ Run yum repolist all to show the status of the repositories.
+
+
+
+
+ If the repository shown in the error message has the status
+ enabled, disable it with the following command:
+
+&prompt.root;yum-config-manager --disable REPO_ID
+
+
+
+ Run yum update again to see if the issue is resolved.
+
+
+
+
+ If you need the unavailable repository for your system, see
+ .
+
+
+
+
+
diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml
index a7736a5..4868ca5 100644
--- a/xml/art-quickstart.xml
+++ b/xml/art-quickstart.xml
@@ -43,6 +43,14 @@
Administration
+
+ 2024-10-18
+
+
+ Add more information about default and optional repositories.
+
+
+
2024-08-01
@@ -302,6 +310,44 @@
+
+ yum update fails with [Errno 14] HTTPS Error 404 - Not Found
+
+
+ The repository shown in the error message might not be mirrored on the &rmt; server.
+ The optional BASE, Source and Debug
+ repositories can be enabled with yum-config-manager even if they are
+ not available from &rmt;.
+
+
+
+
+
+
+ Run yum repolist all to show the status of the repositories.
+
+
+
+
+ If the repository shown in the error message has the status
+ enabled, disable it with the following command:
+
+&prompt.root;yum-config-manager --disable REPO_ID
+
+
+
+ Run yum update again to see if the issue is resolved.
+
+
+
+
+ If you need the unavailable repository for your system, see
+ .
+
+
+
+
+
diff --git a/xml/install-rmt-vm.xml b/xml/install-rmt-vm.xml
index c5f2ee6..5aeedf9 100644
--- a/xml/install-rmt-vm.xml
+++ b/xml/install-rmt-vm.xml
@@ -65,15 +65,20 @@
&reponame; &productnumber; repository size
- The &reponame; repositories will grow over time because older package
- versions are not removed. To meet the 1.5x size recommendation, based on the
- currentAs of 17 September, 2024 size of the default
- &reponame; &productnumber; repositories, you will need approximately 225 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 currentAs of 17 September, 2024
+ size of the repositories, to meet the 1.5 times size recommendation
+ you will need approximately 15 GB of disk space for the default
+ LTSS-Updates repository.
+ If you need the optional LTSS-Source and LTSS-Debug
+ repositories, you will need an additional 39 GB.
- If you also need the Source and Debug
- repositories, you will need an additional 770 GB available.
+ &reponame; &productnumber; also has optional frozen BASE repositories
+ that contain the packages from the non-LTSS
+ repositories. If you need these repositories, to meet the 1.5 times size recommendation you will need approximately
+ 210 GB for the BASE-Updates repository and 730 GB for the
+ BASE-Source and BASE-Debug repositories.
@@ -149,7 +154,7 @@
If you did not already increase the VM's disk space before the installation began,
increase it now. You might need to shut down the VM to do so. The VM must have enough
- space to mirror the &reponame; &productnumber; repository.
+ space to mirror the &reponame; &productnumber; repositories.
diff --git a/xml/mirror-repositories-with-rmt.xml b/xml/mirror-repositories-with-rmt.xml
index e1226f1..ca0ba06 100644
--- a/xml/mirror-repositories-with-rmt.xml
+++ b/xml/mirror-repositories-with-rmt.xml
@@ -51,13 +51,16 @@
New repository structure for &reponame; &productnumber;
- The repository structure has changed in &reponame; &productnumber;. Previously, there was
- one default repository and one optional Source repository. Now there are
- two default repositories, BASE and LTSS, along with
- optional Source and Debug repositories for both.
- The BASE repositories are frozen and contain the existing packages from
- the original &productname; repositories. The LTSS repositories contain
- new packages for &reponame; &productnumber;.
+ The repository structure has changed in &reponame; &productnumber;. The non-LTSS subscription
+ had one default repository and one optional Source repository. The LTSS
+ subscription has a default LTSS-Updates repository, an optional
+ BASE-Updates repository, and optional Source and
+ Debug repositories for both LTSS and BASE.
+
+
+ BASE repositories are frozen and contain the existing packages from the
+ non-LTSS repositories. LTSS repositories contain new packages for
+ &reponame; &productnumber;.
There are no new &ha; repositories. &ha; is not supported with &reponame; &productnumber;.
@@ -71,13 +74,13 @@
Disable the original product. This also disables all repositories associated with the product:
-&prompt.root;rmt-cli product disable 1251
+&prompt.root;rmt-cli products disable 1251
If your previous subscription included the &ha; extension, disable this product too:
-&prompt.root;rmt-cli product disable 1252
+&prompt.root;rmt-cli products disable 1252
&ha; is not supported with &reponame; &productnumber;.
@@ -109,19 +112,43 @@
Enable &reponame; &productnumber; using the product ID 2702:
-&prompt.root;rmt-cli product enable 2702
+&prompt.root;rmt-cli products enable 2702
- This enables all the default repositories associated with the product.
+ This enables the default RES-7-LTSS-Updates repository.
- If you also need the Source or Debug repositories,
- find and enable them with the following commands:
+ If you also need the BASE, Source or
+ Debugrepositories, enable them with the following commands:
-&prompt.root;rmt-cli repo list --all | grep RES-7-BASE
-&prompt.root;rmt-cli repo list --all | grep RES-7-LTSS
-&prompt.root;rmt-cli repo enable REPO_ID
+
+
+
+ RES-7-BASE-Updates:
+
+&prompt.root;rmt-cli repos enable 6986
+
+
+
+ RES-7-LTSS-Source-Updates and RES-7-BASE-Source-Updates:
+
+&prompt.root;rmt-cli repos enable 6748 6987
+
+
+
+ RES-7-LTSS-Debug-Updates and RES-7-BASE-Debug-Updates:
+
+&prompt.root;rmt-cli repos enable 6985 6988
+
+
+
+
+ BASE repositories are frozen and contain the existing packages from the
+ non-LTSS &productname; repositories. LTSS repositories contain new
+ packages for &reponame; &productnumber;.
+
+
diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml
index f3767b5..468eed4 100644
--- a/xml/register-with-rmt.xml
+++ b/xml/register-with-rmt.xml
@@ -175,11 +175,33 @@ Installed Products:
Verify the available repositories:
-&prompt.root;yum repolist
+&prompt.root;yum repolist all
- You should see RES-&productnumber;-BASE-Updates and
- RES-&productnumber;-LTSS-Updates.
+ The default repository RES-&productnumber;-LTSS-Updates should be
+ enabled.
+
+ You will also see optional BASE, Source and
+ Debug repositories with the status disabled.
+ 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
+ https://RMT_SERVER/repo/SUSE/Updates/ or by
+ logging in to the &rmt; server and running rmt-cli repos list.
+
+
+
+ BASE repositories are frozen and contain the existing packages from the
+ non-LTSS &productname; repositories. LTSS repositories contain new
+ packages for &reponame; &productnumber;.
+
+
+
+
+
+ If you need any of the BASE, Source or
+ Debugrepositories, enable them with the following command:
+
+&prompt.root;yum-config-manager --enable REPO_ID