diff --git a/DC-lite-quickstart b/DC-lite-quickstart new file mode 100644 index 0000000..d8c5ec0 --- /dev/null +++ b/DC-lite-quickstart @@ -0,0 +1,13 @@ +# +# DC file for SUSE Liberty Linux Lite +# +MAIN="art-lite-quickstart.xml" +ROOTID="art-lite-quickstart" + +PROFAUDIENCE="sll-l" +PROFCONDITION="suse-product" +#PROFCONDITION="suse-product;beta" +#PROFCONDITION="community-project" + +STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns" +FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns" diff --git a/DC-quickstart b/DC-quickstart index 9097858..a80724c 100644 --- a/DC-quickstart +++ b/DC-quickstart @@ -4,6 +4,7 @@ MAIN="art-quickstart.xml" ROOTID="art-quickstart" +PROFAUDIENCE="sll" PROFCONDITION="suse-product" #PROFCONDITION="suse-product;beta" #PROFCONDITION="community-project" diff --git a/xml/art-lite-quickstart.xml b/xml/art-lite-quickstart.xml new file mode 100644 index 0000000..3a49254 --- /dev/null +++ b/xml/art-lite-quickstart.xml @@ -0,0 +1,189 @@ + + + + %entities; +]> + +
+ + + Registering CentOS Linux &productnumber; with &productname; + &productname; + &productnameshort; + + + + + This guide describes how to use &productname; and &rmt; to update + CentOS Linux &productnumber;. + + + + + https://github.com/SUSE/doc-liberty/issues/new + documentation,issue + 7 + tahliar + + https://github.com/SUSE/doc-liberty/edit/maintenance/SLL7/xml/ + no + + How to use &productname; and RMT to update CentOS Linux 7. + Use &productname; to update CentOS 7. + + Upgrade & Update + Administration + + + + 2024-06-18 + + + Initial release. + + + + + + +
+ Introduction + + &productname; is a technology and support solution for CentOS Linux &productnumber;. + With this one-year subscription, you can register and receive updates for + CentOS Linux &productnumber; with &suse;'s &rmtool; (&rmt;). The subscription also + includes one entitlement for &sles; 15 to host &rmt;. + + + &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. + + + + CentOS Stream is not supported. + + + + Procedure overview + + + If you already have an &rmt; server and only need to register your + CentOS Linux 7 system, skip straight to . + + + + + If you already have an &rmt; server but still need to mirror the &reponame; + &productnumber; repositories, go to . + + + + + If you still need to set up the &rmt; server, + start with and . + + + +
+ + + + + + + + + +
+ Troubleshooting + + + nginx.service is inactive after installing the + rmt-server package + + + Continue the procedure to configure &rmt; in &yast;. This often resolves + the issue. If that fails, Apache might be installed on your server, and + must be disabled. Apache conflicts with NGINX because both web servers + listen on port 80. + + + + + &reponame; does not appear in rmt-cli products list + after rmt-cli sync + + + Check your network. If the network is down, rmt-cli sync fails without + showing an error. + + + + + Mirroring completes with errors + + + If any packages could not be downloaded because of timeouts, rerun the + rmt-cli mirror command until all packages are downloaded. + + + + + Setup script cannot access the &reponame; repository + + + The repodata directory on the &rmt; server is not + available until all the packages for that repository are downloaded. + If any packages could not be downloaded to the &rmt; server because of timeouts + during the first mirroring, rerun the rmt-cli mirror + command until all packages are downloaded. + + + + + Setup script cannot install suseconnect-ng because of + package dependencies + + + &productname; only supports the latest minor release + of &rhla; or CentOS Linux 7. + If your system is running the latest version and suseconnect-ng + still has package dependency issues, try the following workaround: + + + + + Edit the rmt-client-setup-res script to add + --skip-broken to the following line: + +$YUM install sles_es-release-server suseconnect-ng librepo --skip-broken + + + + Run the script and accept any proposed package changes. + suseconnect-ng will be skipped. + + + + + Run the script a second time. The package changes from the first attempt + can sometimes resolve the package dependency issues, allowing the second + attempt to successfully install suseconnect-ng. + + + + + + +
+ +
diff --git a/xml/configure-rmt-server.xml b/xml/configure-rmt-server.xml index 0b0a257..2d99f59 100644 --- a/xml/configure-rmt-server.xml +++ b/xml/configure-rmt-server.xml @@ -22,18 +22,28 @@ 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. + &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;. + 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. @@ -44,11 +54,17 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install Install &rmt; on &sles; 15: -&prompt.root;zypper in rmt-server +&prompt.root;zypper install 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 @@ -86,7 +102,7 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install 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 +126,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-lite-quickstart.html b/xml/html/rh-art-lite-quickstart.html new file mode 100644 index 0000000..d8d955b --- /dev/null +++ b/xml/html/rh-art-lite-quickstart.html @@ -0,0 +1,89 @@ + +Revision History: Registering CentOS Linux 7 with SUSE Liberty LinuxSUSE Liberty Linux Lite + + + + + + + + + + + + + + + + + + +

Revision History: Registering CentOS Linux 7 with SUSE Liberty LinuxSUSE Liberty Linux Lite

2024-06-18

+

+ Initial release. +

+
diff --git a/xml/html/rh-art-quickstart.html b/xml/html/rh-art-quickstart.html new file mode 100644 index 0000000..a004f61 --- /dev/null +++ b/xml/html/rh-art-quickstart.html @@ -0,0 +1,97 @@ + +Revision History: Registering RHEL 7 or CentOS Linux 7 with RMT + + + + + + + + + + + + + + + + + + +

Revision History: Registering RHEL 7 or CentOS Linux 7 with RMT

2024-05-10

+

+ RMT script and requirements update. +

+

2024-03-27

+

+ Clarify wording of requirements. +

+

2024-03-14

+

+ Initial release. +

+
diff --git a/xml/install-rmt-vm.xml b/xml/install-rmt-vm.xml new file mode 100644 index 0000000..ef25fca --- /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;. This machine will be the &rmtool; (&rmt;) server. + You can use your &productname; subscription to register this machine. + + + &minvm; is a slimmed-down version of &sles; (&slsa;), available as a preconfigured + virtual machine image. If you would prefer to install a full &slsa; machine on bare metal, see + + &instquick;. + + + Requirements + + + You have a &productname; subscription. This subscription entitles you to one + &slsa; machine to host &rmt;. + + + + + 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 20 May, 2024 + size of the &reponame; &productnumber; repository, you will need approximately 710 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 that 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.example.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 1807b8d..633ab61 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,19 +18,22 @@ - Use this procedure to mirror the &productname; repositories for &rhel; &productnumber; - and CentOS Linux &productnumber;. + Use this procedure to mirror the &reponame; repositories for + &rhel; &productnumber; and CentOS Linux &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. @@ -46,7 +49,7 @@ - Mirroring &productname; repositories with &rmt; + Mirroring the &reponame; repositories with &rmt; On the &rmt; server, update the available product and repository metadata: @@ -61,14 +64,14 @@ - Enable &productname; using the product ID 1251: + Enable &reponame; &productnumber; using the product ID 1251: &prompt.root;rmt-cli product enable 1251 - This enables all of the default repositories associated with the product. + This enables all the default repositories associated with the product. - + If your subscription includes the &ha; extension, enable the extension using the product ID 1252: @@ -83,8 +86,8 @@ - If you also need the Source or Debug - repositories, find and enable them with the following commands: + If you also need the Source repository, find and enable it with the + following commands: &prompt.root;rmt-cli repo list --all | grep RES- &prompt.root;rmt-cli repo enable REPO_ID diff --git a/xml/product-entities.ent b/xml/product-entities.ent index 1802ee9..f1512ec 100644 --- a/xml/product-entities.ent +++ b/xml/product-entities.ent @@ -1,7 +1,9 @@ - +SUSE Liberty LinuxSUSE Liberty Linux Lite"> +SLLSLL-L"> - + + diff --git a/xml/register-with-rmt.xml b/xml/register-with-rmt.xml index 2be5480..ea8f96a 100644 --- a/xml/register-with-rmt.xml +++ b/xml/register-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"> - Registering &rhla; or CentOS Linux with &rmt; + Registering <phrase audience="sll">&rhla; or </phrase>CentOS Linux with &rmt; @@ -19,8 +19,8 @@ - Use this procedure to register &rhel; &productnumber; or CentOS Linux &productnumber; - with the &rmt; server. + Use this procedure to register &rhel; &productnumber; or + CentOS Linux &productnumber; with the &rmt; server. @@ -31,12 +31,7 @@ Requirements - - - - - - + The system you want to register can access the &rmt; server. @@ -46,13 +41,14 @@ - The system you want to register can access the &rmt; server. + The &reponame; &productnumber; repositories are available on the &rmt; server. - The system you want to register is running the latest minor release of &rhla; &productnumber; - or CentOS Linux &productnumber;. + The system you want to register is up to date. &productname; only supports the latest minor + release of &rhla; &productnumber; or + CentOS Linux &productnumber;. @@ -64,10 +60,10 @@ - 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. @@ -75,7 +71,7 @@ - Registering &rhla; or CentOS Linux with &rmt; + Registering <phrase audience="sll">&rhla; or </phrase>CentOS Linux with &rmt; Download the rmt-client-setup-res script: @@ -158,7 +154,7 @@ Installed Products: You should see RES-&productnumber;-Updates. - + If your subscription includes the &ha; extension, activate it with the following command: