diff --git a/xml/app-access-src-debug.xml b/xml/app-access-src-debug.xml
index 66f01c7..29a1563 100644
--- a/xml/app-access-src-debug.xml
+++ b/xml/app-access-src-debug.xml
@@ -51,7 +51,7 @@
- Your &rhla; system is registered with the &rmt; server.
+ Your &rhla; system is registered to the &rmt; server.
@@ -67,7 +67,11 @@
List the &productname; &productnumber; repositories:
-&prompt.root;rmt-cli repos list --all | grep &reponameshort; | grep &productnumber;-
+&prompt.root;rmt-cli repos list --all | grep &reponameshort; | grep &productnumber;[-.]
+
+ Depending on your subscription, this command shows the standard repositories,
+ the EMS repositories and the HA repositories.
+
If the repositories you need already have the status Mirror,
skip this procedure and go to .
diff --git a/xml/app-switch-to-ems.xml b/xml/app-switch-to-ems.xml
new file mode 100644
index 0000000..092e85f
--- /dev/null
+++ b/xml/app-switch-to-ems.xml
@@ -0,0 +1,208 @@
+
+
+
+ %entities;
+]>
+
+
+ Switching to &ems;
+
+
+
+ yes
+
+
+
+ 2025-12-18
+
+
+
+
+
+
+
+
+ Mirroring the &ems; (EMS) repositories and enabling them on your system is documented as part
+ of and .
+
+
+ However, if your &rhla; system is already registered to the &rmt; server under a standard
+ subscription and you need to switch to EMS, this section highlights the relevant steps.
+
+
+ Requirements
+
+
+ The &rmt; server is installed and up to date.
+
+
+
+
+ The &rmt; server has enough space to mirror the EMS repositories, which are separate
+ from the standard repositories. You can enable both, but this uses significantly more
+ disk space on the &rmt; server because of duplicate packages. Alternatively, you can
+ clean up the standard repositories before you mirror the EMS repositories.
+
+
+
+
+ Your &productname; subscription includes &ems; (EMS).
+
+
+
+
+
+ If you previously mirrored the standard repositories but now only need the EMS repositories,
+ use this procedure to clean up the standard repositories:
+
+
+ (Optional) Cleaning up the standard repositories on the &rmt; server
+
+
+ Disable the standard product. This disables all the associated repositories:
+
+&prompt.root;rmt-cli products disable 2538
+
+
+
+ If you no longer need the &ha; repositories, disable this product too:
+
+&prompt.root;rmt-cli products disable 2539
+
+
+ There is no &ems; for &ha;.
+
+
+
+
+
+ Free up space on the &rmt; server by cleaning up the packages from the disabled repositories:
+
+&prompt.root;rmt-cli repos clean
+
+
+
+
+ Repositories must be mirrored on the &rmt; server before you can access them on your &rhla;
+ system. Use this procedure to mirror the EMS repositories:
+
+
+ Mirroring the EMS repositories on the &rmt; server
+
+
+ On the &rmt; server, update the available product and repository metadata:
+
+&prompt.root;rmt-cli sync
+
+
+
+ Find the EMS version you need and enable it using the listed ID:
+
+&prompt.root;rmt-cli products list --all --name=SLL-EMS
+&prompt.root;rmt-cli products enable PRODUCT_ID
+
+ This enables all the default repositories.
+
+
+
+
+ If you need the Source or Debug repositories,
+ find and enable them with the following commands:
+
+
+
+
+ List all the repositories for your EMS version. For example:
+
+&prompt.root;rmt-cli repos list --all | grep &reponameshort; | grep &productnumber;[.]6
+
+ Enabled repositories have the status Mirror. Unenabled repositories
+ have the status Don't Mirror.
+
+
+
+
+ Enable the repositories you need with their numeric IDs. You can enable multiple
+ repositories at once:
+
+&prompt.root;rmt-cli repos enable REPO_ID1 REPO_ID2 REPO_ID3
+
+
+
+
+
+ Start package mirroring for the enabled repositories:
+
+&prompt.root;rmt-cli mirror
+
+ This will take some time to complete.
+
+
+
+
+
+ After the repositories finish mirroring, you can enable them on your &rhla; system.
+ This procedure registers the system if it was previously unregistered, or switches the
+ system to EMS if it was previously registered under a standard subscription.
+
+
+ Switching to EMS on &rhel;
+
+
+ On the &rhla; system, download the latest rmt-client-setup-res script:
+
+&prompt.root;curl --remote-name http://&rmt;_SERVER/tools/rmt-client-setup-res
+
+
+
+ Run the rmt-client-setup-res script with the URL of the &rmt; server
+ as a parameter, and specify the version you need with the
+ option. For example:
+
+&prompt.root;sh rmt-client-setup-res https://RMT_SERVER --product 9.6-EMS
+
+ You should see Successfully registered system.
+
+
+
+
+ Verify the installed product:
+
+&prompt.root;&suseconnect; --status-text
+
+
+
+ Verify the available repositories:
+
+&prompt.root;dnf repolist all
+
+ The default repositories should be enabled. You will also see optional
+ Source and Debug repositories with the status
+ disabled. These repositories are listed and can be enabled even if
+ they are not mirrored on the &rmt; server. However, you can only download content from
+ a repository if it is mirrored on the &rmt; server.
+
+
+
+
+ If you need the Source or Debug repositories, enable
+ them using their repo id. You can enable multiple repositories at once:
+
+&prompt.root;dnf config-manager --enable REPO_ID1REPO_ID2REPO_ID3
+
+
+
+ Run the update command to make sure there are no errors:
+
+&prompt.root;dnf update
+
+
+
+
diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml
index c852c0f..4ef8e2f 100644
--- a/xml/art-quickstart.xml
+++ b/xml/art-quickstart.xml
@@ -48,6 +48,14 @@
Administration
+
+ 2025-12-18
+
+
+ Added extended minor-version support (EMS)
+
+
+ 2025-12-04
@@ -200,7 +208,7 @@
package dependencies
- &productname; only supports the latest minor release of &rhla;.
+ &productname; only supports the latest minor version of each &rhla; release.
If your system is running the latest version and SUSEConnect
still has package dependency issues, try the following workaround:
@@ -269,5 +277,6 @@
+
diff --git a/xml/introduction.xml b/xml/introduction.xml
index 6fbb6e3..63d70bf 100644
--- a/xml/introduction.xml
+++ b/xml/introduction.xml
@@ -20,11 +20,25 @@
&productname; is a technology and support solution for mixed Linux environments. With a
- &productname; subscription, you can update &rhel; from repositories provided by &suse;.
- An optional &ha; extension is also available.
+ &productname; subscription, you can register and update &rhel; from repositories provided
+ by &suse;. Two extensions are also available:
+
+
+
+ The &ha; (HA) extension provides package updates for &rhla;'s &ha; and
+ Resilient Storage Add-Ons.
+
+
+
+
+ The &ems; (EMS) extension allows you to keep your systems on a specific minor version
+ (9.6 and later only) while still receiving critical updates.
+
+
+
- The following table shows which Linux distributions are supported by each subscription. These
+ The following table shows which Linux distributions are supported. &productname;
subscriptions also include an entitlement for a registration tool to manage package updates.
diff --git a/xml/mirror-repositories-with-rmt.xml b/xml/mirror-repositories-with-rmt.xml
index 39c9616..1eee6c0 100644
--- a/xml/mirror-repositories-with-rmt.xml
+++ b/xml/mirror-repositories-with-rmt.xml
@@ -63,40 +63,65 @@
- Enable &productname; &productnumber; using the product ID 2538:
+ Enable the &productname; &productnumber; product. This enables all the default repositories:
+
+
+
+ To enable the standard product, use the product ID 2538:
+ &prompt.root;rmt-cli products enable 2538
-
- This enables all the default repositories associated with the product.
-
+
+
+
+ To enable &ems; (EMS), find the version you need and enable it using the listed
+ ID:
+
+&prompt.root;rmt-cli products list --all --name=SLL-EMS
+&prompt.root;rmt-cli products enable PRODUCT_ID
+
+
+
+ EMS disk space requirement
+
+ The EMS repositories are separate from the standard repositories. You can enable both, but this uses significantly more disk space on the &rmt; server because of duplicate packages.
+
+
+ If you previously mirrored the standard repositories but now only need the EMS repositories,
+ you can clean up the standard repositories with the following commands:
+
+&prompt.root;rmt-cli products disable 2538 2539
+&prompt.root;rmt-cli repos clean
+
-
+
- If your subscription includes the &ha; extension, enable the extension using
- the product ID 2539:
-
-&prompt.root;rmt-cli products enable 2539
-
-
- To check whether the &ha; extension is available, run this
- command: rmt-cli products list --all --name=&reponameshort;-HA
+ If your subscription includes the &ha; extension, enable it using the
+ product ID 2539:
-
+&prompt.root;rmt-cli products enable 2539
+
+
+ There is no &ems; for &ha;.
+
+
-
+
- If you also need the Source or Debug
- repositories, find and enable them with the following commands:
+ If you need the Source or Debug repositories,
+ find and enable them with the following commands:
List all the repositories for &productname; &productnumber;:
-&prompt.root;rmt-cli repos list --all | grep &reponameshort; | grep &productnumber;-
+&prompt.root;rmt-cli repos list --all | grep &reponameshort; | grep &productnumber;[-.]
- Enabled repositories have the status Mirror. Unenabled repositories
- have the status Don't Mirror.
+ Depending on your subscription, this command shows the standard repositories,
+ the EMS repositories and the HA repositories. Enabled repositories have the
+ status Mirror. Unenabled repositories have the status
+ Don't Mirror.
@@ -104,7 +129,7 @@
Enable the repositories you need with their numeric IDs. You can enable multiple
repositories at once:
-&prompt.root;rmt-cli repos enable REPO_ID1REPO_ID2REPO_ID3
+&prompt.root;rmt-cli repos enable REPO_ID1 REPO_ID2 REPO_ID3
diff --git a/xml/product-entities.ent b/xml/product-entities.ent
index 9a72ac9..cec4d18 100644
--- a/xml/product-entities.ent
+++ b/xml/product-entities.ent
@@ -6,6 +6,8 @@
+
+
diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml
index 156a065..2c91621 100644
--- a/xml/register-with-rmt.xml
+++ b/xml/register-with-rmt.xml
@@ -21,6 +21,11 @@
Use this procedure to register &rhel; &productnumber; as a client of &rmt;.
+
+ A standard &productname; subscription only supports the latest minor version of
+ &rhla; &productnumber;. If your subscription includes &ems; (EMS), you can optionally keep your
+ system on a specific minor version (9.6 and later only) while still receiving critical updates.
+
¢os; Stream is not supported.
@@ -43,12 +48,6 @@
The system you want to register can access the &rmt; server.
-
-
- The system you want to register is up to date. &productname; only supports the latest
- minor release of &rhla; &productnumber;.
-
-
You have a &productname; subscription activated in the &scc;.
@@ -64,16 +63,38 @@
Registering &rhla; with &rmt;
- On the &rhla; system, download the rmt-client-setup-res script:
+ On the &rhla; system, download the latest rmt-client-setup-res script:
+
+&prompt.root;curl --remote-name http://&rmt;_SERVER/tools/rmt-client-setup-res
+
+ The option (or ) writes the output to a local
+ file with the same name as the remote file.
-&prompt.root;curl -O http://&rmt;_SERVER/tools/rmt-client-setup-res
- Run the rmt-client-setup-res script with
- the URL of the &rmt; server as a parameter:
+ Run the rmt-client-setup-res script with the URL of the &rmt; server
+ as a parameter:
+
+
+
+ To keep updating your system to the latest minor version, run the default script:
+ &prompt.root;sh rmt-client-setup-res https://RMT_SERVER
+
+
+
+ To keep your system on a specific minor version, run the script with the
+ option and specify the version you need. For example:
+
+&prompt.root;sh rmt-client-setup-res https://RMT_SERVER --product 9.6-EMS
+
+ Any command output will use this minor version number instead of the standard
+ 9 shown in the steps below.
+
+
+
The script installs &suseconnect; and its dependencies,
and replaces the existing release package with the &productname; release package.
@@ -136,18 +157,21 @@ Installed Products:
------------------------------------------
-
+
- If your subscription includes the &ha; extension, activate it with the
- following command:
+ If your subscription includes the &ha; extension, activate it with this command:
&prompt.root;&suseconnect; -p &reponameshort;-HA/&productnumber;/x86_64
- To check whether the extension is available, run the
- &suseconnect; --list-extensions command.
+ To check whether the extension is available, run &suseconnect; --list-extensions.
+
+
+ There is no &ems; for &ha;.
+
+
@@ -162,7 +186,7 @@ Installed Products:
should also be enabled.
- You will also see optional Source and Debug
+ You will also see optional 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
@@ -170,12 +194,12 @@ Installed Products:
or by logging in to the &rmt; server and running rmt-cli repos list.
-
+
- If you need the Source or Debug repositories,
- enable them with the following command:
+ If you need the Source or Debug repositories, enable
+ them using their repo id. You can enable multiple repositories at once:
-&prompt.root;dnf config-manager --enable REPO_ID
+&prompt.root;dnf config-manager --enable REPO_ID1 REPO_ID2 REPO_ID3