Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add VM procedure for RMT (SLL7) #23

Merged
merged 3 commits into from
Jun 27, 2024
Merged

Add VM procedure for RMT (SLL7) #23

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dd6ed87
Restructure procedure overview
tahliar Jun 26, 2024
11bc290
Add VM procedure
tahliar Jun 27, 2024
a8b6dd1
Other minor improvements
tahliar Jun 27, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 25 additions & 64 deletions xml/art-quickstart.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,14 @@
<phrase>Administration</phrase>
</meta>
<revhistory xml:id="rh-art-quickstart">
<revision>
<date>2024-06-27</date>
<revdescription>
<para>
Add Minimal VM procedure.
</para>
</revdescription>
</revision>
<revision>
<date>2024-05-10</date>
<revdescription>
Expand Down Expand Up @@ -89,12 +97,12 @@
<itemizedlist>
<listitem>
<para>
&smtool; (&smt;) on &sle; 12
&smtool; (&smt;)
</para>
</listitem>
<listitem>
<para>
&rmtool; (&rmt;) on &sle; 15
&rmtool; (&rmt;)
</para>
</listitem>
<listitem>
Expand All @@ -104,39 +112,36 @@
</listitem>
</itemizedlist>
<para>
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.
</para>
<orderedlist>
<itemizedlist>
<title>Procedure overview</title>
<listitem>
<para>
<xref linkend="requirements-quickstart"/>. Make sure you have everything
required for the following procedures.
If you already have an &rmt; server and only need to <emphasis role="bold">register your
&rhla;&nbsp;&productnumber; or CentOS&nbsp;Linux&nbsp;&productnumber; system</emphasis>,
skip straight to <xref linkend="register-7-with-rmt"/>.
</para>
</listitem>
<listitem>
<para>
<xref linkend="configure-rmt-server"/>. 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 <emphasis role="bold">mirror the
&productname;&nbsp;&productnumber; repositories</emphasis>, go to
<xref linkend="mirror-repositories-with-rmt"/>.
</para>
</listitem>
<listitem>
<para>
<xref linkend="mirror-repositories-with-rmt"/>. You can skip this step if
&productname; is already enabled and mirrored on your &rmt; server.
If you still need to <emphasis role="bold">set up the &rmt; server</emphasis>, start with
<xref linkend="install-rmt-vm"/> and <xref linkend="configure-rmt-server"/>.
</para>
</listitem>
<listitem>
<para>
<xref linkend="register-7-with-rmt"/>. &rmt; includes a setup script to
automate the registration process.
</para>
</listitem>
</orderedlist>
<!-- Can delete this if/when all names have been changed-->

</itemizedlist>
<!-- Can delete this if/when all names have been changed
trichardson 2024-06-26: Repo names have changed but repo labels still include RES -->
<note>
<title><emphasis>&productname;</emphasis> and <emphasis>&sles; with Expanded Support</emphasis></title>
<para>
Expand Down Expand Up @@ -181,51 +186,7 @@
</itemizedlist>
</section>

<section xml:id="requirements-quickstart">
<title>Requirements</title>
<itemizedlist>
<listitem>
<para>
You have a &productname; subscription.
</para>
</listitem>
<listitem>
<para>
You have a <link xlink:href="&sccurl;">&scc;</link> account.
</para>
</listitem>
<listitem>
<para>
The systems you want to register are up to date. &productname; only
supports the latest minor release of each &rhla; or CentOS Linux version.
</para>
</listitem>
<listitem>
<para>
&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
<link xlink:href="https://documentation.suse.com/sles-15/html/SLES-all/article-installation.html">
<citetitle>&instquick;</citetitle></link>.
</para>
</listitem>
<listitem>
<para>
The systems you want to register can reach the &rmt; server.
</para>
</listitem>
<listitem>
<para>
The &rmt; server has enough storage available for repository mirroring.
Downloaded packages are stored in <filename>/usr/share/rmt/public/repo</filename>,
which is a symbolic link to <filename>/var/lib/rmt/public/repo/</filename>.
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.
</para>
</listitem>
</itemizedlist>
</section>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="install-rmt-vm.xml"/>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="configure-rmt-server.xml"/>

Expand Down
19 changes: 5 additions & 14 deletions xml/configure-rmt-server.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,7 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
<title>Requirements</title>
<listitem>
<para>
<phrase audience="sll">&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
<link xlink:href="https://documentation.suse.com/sles-15/html/SLES-all/article-installation.html">
<citetitle>&instquick;</citetitle></link>.</phrase>
<phrase audience="sll-l">A &slsa; 15 virtual machine is installed as described in
<xref linkend="install-rmt-vm"/>.</phrase>
A &slsa; 15 virtual machine is installed as described in <xref linkend="install-rmt-vm"/>.
</para>
</listitem>
<listitem>
Expand All @@ -52,11 +47,11 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
<title>Configuring the &rmt; server</title>
<step>
<para>
Install &rmt; on &sles; 15:
On the &slsa; machine, install &rmt;:
</para>
<screen>&prompt.root;<command>zypper install rmt-server</command></screen>
</step>
<step audience="sll-l">
<step>
<para>
Install the following packages, which are not installed by default on a &minvm;:
</para>
Expand Down Expand Up @@ -91,12 +86,8 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
</step>
<step>
<para>
If a password for the &mariadb; root user is already set, enter the password
when prompted, then select <guimenu>OK</guimenu>.
</para>
<para>
If no password is set for the &mariadb; root user, enter and confirm a new
password when prompted, then select <guimenu>OK</guimenu>.
When prompted, enter and confirm a new password for the &mariadb; root user, then select
<guimenu>OK</guimenu>.
</para>
</step>
<step>
Expand Down
10 changes: 7 additions & 3 deletions xml/html/rh-art-quickstart.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>Revision History: Registering RHEL 7 or CentOS Linux 7 with RMT</title><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"/><link rel="stylesheet" type="text/css" href="static/css/style.css"/>
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"/><link rel="schema.DCTERMS" href="http://purl.org/dc/terms/"/>
<meta name="title" content="Revision History | SLLSLL-L"/>
<meta name="description" content="RMT script and requirements update."/>
<meta name="description" content="Add Minimal VM procedure."/>
<meta name="product-name" content="SUSE Liberty LinuxSUSE Liberty Linux Lite"/>
<meta name="book-title" content="Registering RHEL 7 or CentOS Linux 7 with RMT"/>
<meta name="chapter-title" content="Revision History"/>
Expand Down Expand Up @@ -40,7 +40,7 @@
}
],

"dateModified": "2024-05-10T00:00+02:00",
"dateModified": "2024-06-27T00:00+02:00",

"datePublished": "2024-03-14T00:00+02:00",

Expand Down Expand Up @@ -82,7 +82,11 @@
useBR: false
});

</script></head><body><div class="revhistory" id="rh-art-quickstart"><h1 class="title">Revision History: Registering RHEL 7 or CentOS Linux 7 with RMT</h1><section class="revision"><h2><span class="revision date">2024-05-10</span></h2>
</script></head><body><div class="revhistory" id="rh-art-quickstart"><h1 class="title">Revision History: Registering RHEL 7 or CentOS Linux 7 with RMT</h1><section class="revision"><h2><span class="revision date">2024-06-27</span></h2>
<p>
Add Minimal VM procedure.
</p>
</section><section class="revision"><h2><span class="revision date">2024-05-10</span></h2>
<p>
RMT script and requirements update.
</p>
Expand Down
23 changes: 12 additions & 11 deletions xml/install-rmt-vm.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,21 +19,22 @@
</info>

<para>
Use this procedure to install a &minvm;. This machine will be the &rmtool; (&rmt;) server.
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.
</para>
<para>
&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
<link xlink:href="https://documentation.suse.com/sles-15/html/SLES-all/article-installation.html">
<citetitle>&instquick;</citetitle></link>.
</para>
<tip role="compact">
<para>
If you would prefer to install a full &slsa; machine on bare metal, see
<link xlink:href="https://documentation.suse.com/sles-15/html/SLES-all/article-installation.html">
<citetitle>&instquick;</citetitle></link>.
</para>
</tip>
<itemizedlist>
<title>Requirements</title>
<listitem>
<para>
You have a &productname; subscription. This subscription entitles you to one
&slsa; machine to host &rmt;.
You have a &productname; subscription.
<phrase audience="sll-l">This subscription entitles you to one &slsa; machine to host &rmt;.</phrase>
</para>
</listitem>
<listitem>
Expand Down Expand Up @@ -88,13 +89,13 @@
</para>
<para>
The default disk size for &minvm; is 24&nbsp;GB. If you can customize the configuration
before the installation begins, increase the available storage so that there is enough
before the installation begins, increase the available storage so there is enough
disk space for repository mirroring.
</para>
</step>
<step>
<para>
When the &jeosfirstboot; screen appears, select <guimenu>Start</guimenu>.
When the <literal>&jeosfirstboot;</literal> screen appears, select <guimenu>Start</guimenu>.
</para>
</step>
<step>
Expand Down
2 changes: 1 addition & 1 deletion xml/mirror-repositories-with-rmt.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@
</listitem>
<listitem>
<para>
You have a &productname; subscription activated in the &scc;.
You have a &productname; subscription activated in the <link xlink:href="&sccurl;">&scc;</link>.
</para>
</listitem>
</itemizedlist>
Expand Down
10 changes: 5 additions & 5 deletions xml/register-with-rmt.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,17 +31,17 @@
<title>Requirements</title>
<listitem>
<para>
The system you want to register can access the &rmt; server.
The &rmt; server is running <package>rmt-server</package> version 2.15 or later.
</para>
</listitem>
<listitem>
<para>
The &rmt; server is running <package>rmt-server</package> version 2.15 or later.
The &reponame; &productnumber; repositories are available on the &rmt; server.
</para>
</listitem>
<listitem>
<listitem>
<para>
The &reponame; &productnumber; repositories are available on the &rmt; server.
The system you want to register can access the &rmt; server.
</para>
</listitem>
<listitem>
Expand Down Expand Up @@ -175,6 +175,6 @@ Installed Products:
</step>
</procedure>
<para>
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;.
</para>
</section>
Loading