diff --git a/xml/art-quickstart.xml b/xml/art-quickstart.xml index 922cb94..27920ef 100644 --- a/xml/art-quickstart.xml +++ b/xml/art-quickstart.xml @@ -43,6 +43,14 @@ Administration + + 2024-06-27 + + + Add Minimal VM procedure. + + + 2024-03-27 @@ -80,7 +88,7 @@ - &rmtool; (&rmt;) on &sle; 15 + &rmtool; (&rmt;) @@ -90,38 +98,33 @@ - This guide describes how to register with &rmt; on &sle; 15. &rmt; is a proxy system for the + 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. - + Procedure overview - . Make sure you have everything - required for the following procedures. + If you already have an &rmt; server and only need to register your + &rhla; &productnumber; system, skip straight to + . - . This server must be installed on - &sles; 15. You can skip this step if you already have an &rmt; server in - your network. + If you already have an &rmt; server but still need to mirror the + &productname; &productnumber; repositories, go to + . - . You can skip this step if - &productname; is already enabled and mirrored on your &rmt; server. + If you still need to set up the &rmt; server, start with + and . - - - . &rmt; includes a setup script to - automate the registration process. - - - + Related information @@ -157,51 +160,7 @@ -
- Requirements - - - - You have a &productname; subscription. - - - - - You have a &scc; account. - - - - - The systems you want to register are up to date. &productname; only - supports the latest minor release of each &rhla; version. - - - - - &sles; (&slsa;) 15 is installed and up to date. This machine will be - the &rmt; server. You can use the &productname; subscription to - register &slsa;. To install &slsa; 15, see - - &instquick;. - - - - - The systems you want to register can reach the &rmt; server. - - - - - The &rmt; server has enough storage available for repository mirroring. - Downloaded packages are stored in /usr/share/rmt/public/repo, - which is a symbolic link to /var/lib/rmt/public/repo/. - The amount of storage required depends on the number of repositories you mirror. - We recommend at least 1.5 times the total size of all enabled repositories. - Be aware that these repositories will grow substantially over time. - - - -
+ diff --git a/xml/configure-rmt-server.xml b/xml/configure-rmt-server.xml index 0b0a257..bc0fab1 100644 --- a/xml/configure-rmt-server.xml +++ b/xml/configure-rmt-server.xml @@ -22,18 +22,23 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install - Use this procedure to configure the &rmtool; (&rmt;) on &sles; 15. + Use this procedure to configure the &rmtool; (&rmt;) on &sles; (&slsa;) 15. Requirements - &sles; 15 is installed and up to date. + A &slsa; 15 virtual machine is installed as described in . + + + The &slsa; machine has a static IP address and host name. + + - You have a &scc; account and organization credentials. + You have a &scc; account and organization credentials. @@ -42,13 +47,19 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install Configuring the &rmt; server - Install &rmt; on &sles; 15: + On the &slsa; machine, install &rmt;: &prompt.root;zypper in rmt-server + + + + Install the following packages, which are not installed by default on a &minvm;: + +&prompt.root;zypper install yast2-rmt mariadb nginx - Start the rmt module in &yast;: + Start the &yast; rmt module: &prompt.root;yast2 rmt @@ -75,18 +86,14 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install - If a password for the &mariadb; root user is already set, enter the password - when prompted, then select OK. - - - If no password is set for the &mariadb; root user, enter and confirm a new - password when prompted, then select OK. + When prompted, enter and confirm a new password for the &mariadb; root user, then select + OK. Enter a Common Name for the SSL certificates. The common - name is usually the FQDN of the server. + name is usually the host name of the server. @@ -110,8 +117,8 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install - &yast; displays the &rmt; Service Status. - Select Next. + &yast; displays the &rmt; Service Status. If there are no issues, + select Next. diff --git a/xml/html/rh-art-quickstart.html b/xml/html/rh-art-quickstart.html new file mode 100644 index 0000000..c2544dc --- /dev/null +++ b/xml/html/rh-art-quickstart.html @@ -0,0 +1,97 @@ + +Revision History: Registering RHEL 9 with RMT + + + + + + + + + + + + + + + + + + +

Revision History: Registering RHEL 9 with RMT

2024-06-27

+

+ Add Minimal VM procedure. +

+

2024-03-27

+

+ Clarify wording of requirements. +

+

2022-08-24

+

+ Initial release. +

+
diff --git a/xml/install-rmt-vm.xml b/xml/install-rmt-vm.xml new file mode 100644 index 0000000..4b2537a --- /dev/null +++ b/xml/install-rmt-vm.xml @@ -0,0 +1,268 @@ + + + %entities; +]> + +
+ Installing a virtual machine to host &rmt; + + + + + no + + + + + Use this procedure to install a &minvm;, a preconfigured virtual machine image that contains a + slimmed-down version of &sles; (&slsa;). This machine will be the &rmtool; (&rmt;) server. + You can use your &productname; subscription to register this machine. + + + + If you would prefer to install a full &slsa; machine on bare metal, see + + &instquick;. + + + + Requirements + + + You have a &productname; subscription. + + + + + You have a &scc; account. + + + + + The VM must have a static IP address and host name. This guide includes steps for configuring + the VM's network setup, but you must have basic networking knowledge to fill in the details. + + + + + You have the infrastructure to run virtual machines. This guide explains + how to set up the VM to host &rmt;, but does not describe how to use different + virtualization products. See the relevant documentation for your product. + + + + + The &rmt; server needs enough available disk space to mirror the &reponame; &productnumber; + repositories. Downloaded packages are stored in /var/lib/rmt/public/repo/. + The amount of storage required depends on the number of repositories you mirror. + We recommend at least 1.5 times the total size of all enabled repositories. + + + &reponame; &productnumber; repository size + + The &reponame; repositories will grow substantially over time, because older package + versions are not removed. To meet the 1.5x size recommendation, based on the + currentAs of 27 June, 2024 + size of the &reponame; &productnumber; repositories, you will need approximately + 275 GB of disk space available for the &rmt; server. + + + + + + Installing a virtual machine to host &rmt; + + + Download the appropriate Minimal-VM image for your virtualization + infrastructure from . + + + + + Use the Minimal-VM image to start the virtual machine. + + + The default disk size for &minvm; is 24 GB. If you can customize the configuration + before the installation begins, increase the available storage so there is enough + disk space for repository mirroring. + + + + + When the &jeosfirstboot; screen appears, select Start. + + + + + Choose your keyboard layout and select OK. + + + + + Review the End User License Agreement and select EXIT. + To agree with the terms of the license, select Yes. + + + + + Choose your time zone and select OK. + + + + + Enter a &rootuser; password and select OK, then confirm the password + and select OK again. + + + + + &jeosfirstboot; shows the command to use to register this VM. You do not need to write this + down; the command is explained in this procedure. Select OK. + + + + + When the VM is ready, log in as the &rootuser; user with the password you entered + during setup. + + + + + Register the VM using your &scc; email address and the registration code for &productname;: + +&prompt.root;SUSEConnect -e EMAIL_ADDRESS -r REGISTRATION_CODE + + This activates the Basesystem, Server Applications, + and Python 3 modules. + + + + + 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. + + + + + You must also configure a static IP address and host name for the VM. If you are familiar + with any networking tools in &slsa;, configure the network with your preferred tool. + If not, use the &yast; graphical interface: + + + Setting a static IP address in &yast; + + + Install &yast; and the &yast; network module: + +&prompt.root;zypper install yast2 yast2-network + + + + Start the &yast; network module: + +&prompt.root;yast2 lan + + + + In the Overview tab, select Edit to change the settings + of the eth0 device. The Network Card Setup dialog opens. + + + + + In the Address tab, activate Statically Assigned IP Address. + + + + + Fill in the IP Address, Subnet Mask, and + Hostname fields. + + + + + Select Next. + + + + + Switch to the Hostname/DNS tab and fill in the + Static Hostname field. + + + + + Change Set Hostname via DHCP to no. + + + + + Fill in at least one Name Server field. + + + + + Switch to the Routing tab and select Add. A new + dialog opens. + + + + + Fill in the Gateway field. Make sure to remove the - + character. + + + + + From the Device drop-down list, select eth0. + + + + + Select OK to close the dialog. + + + + + Select OK to complete the configuration and close &yast;. + + + + + Check the network settings: + +&prompt.root;ip addr + + Check that the network interface can access external networks: + +&prompt.root;ping www.suse.com + + Cancel the ping with C. + + + + + You can now install &rmt; on the virtual machine. + + + More information + + + + Introduction to &minvm; + + + + + + &virtual; + + + +
diff --git a/xml/mirror-repositories-with-rmt.xml b/xml/mirror-repositories-with-rmt.xml index 868c7ee..6032be3 100644 --- a/xml/mirror-repositories-with-rmt.xml +++ b/xml/mirror-repositories-with-rmt.xml @@ -9,7 +9,7 @@ xmlns="http://docbook.org/ns/docbook" version="5.1" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink"> - Mirroring &productname; repositories with &rmt; + Mirroring &reponame; repositories with &rmt; @@ -18,18 +18,21 @@ - Use this procedure to mirror the &productname; repositories for &rhel; &productnumber;. + Use this procedure to mirror the &reponame; repositories for &rhel; &productnumber;. Requirements - + The &rmt; server is installed and up to date. - The &rmt; server has enough storage available for repository mirroring. + The &rmt; server has enough storage available for repository mirroring. The amount of storage + required depends on the number of repositories you mirror. We recommend at least 1.5 times + the total size of all enabled repositories. Be aware that the &reponame; repositories will + grow substantially over time. @@ -39,13 +42,13 @@ - You have a &productname; subscription activated in the &scc;. + You have a &productname; subscription activated in the &scc;. - Mirroring &productname; repositories with &rmt; + Mirroring the &reponame; repositories with &rmt; On the &rmt; server, update the available product and repository metadata: @@ -60,11 +63,11 @@ - Enable &productname; using the product ID 2538: + Enable &reponame; &productnumber; using the product ID 2538: &prompt.root;rmt-cli product enable 2538 - This enables all of the default repositories associated with the product. + This enables all the default repositories associated with the product. diff --git a/xml/product-entities.ent b/xml/product-entities.ent index 244c6de..d4198fb 100644 --- a/xml/product-entities.ent +++ b/xml/product-entities.ent @@ -3,6 +3,8 @@ + + diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml index bcb82f7..05c3abf 100644 --- a/xml/register-with-rmt.xml +++ b/xml/register-with-rmt.xml @@ -30,17 +30,12 @@ Requirements - - - - - - + The &rmt; server is running rmt-server version 2.10 or later. - The &rmt; server is running rmt-server version 2.10 or later. + The &reponame; &productnumber; repositories are available on the &rmt; server. @@ -50,18 +45,18 @@ - The system you want to register is running the latest minor release of &rhla; &productnumber;. + 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;. + You have a &productname; subscription activated in the &scc;. - You have removed the system from any &rh; subscription services it was - registered to. + You have removed the system from any &rh; subscription services it was registered to. @@ -172,6 +167,6 @@ Installed Products: - You can now update your system from repositories provided by &productname;. + You can now keep your system up to date from repositories provided by &productname;.