Skip to content

Commit

Permalink
Add VM procedure (#24)
Browse files Browse the repository at this point in the history
  • Loading branch information
tahliar authored Jun 27, 2024
1 parent 33f34fe commit 9636fd1
Show file tree
Hide file tree
Showing 7 changed files with 433 additions and 98 deletions.
86 changes: 23 additions & 63 deletions xml/art-quickstart.xml
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-03-27</date>
<revdescription>
Expand Down Expand Up @@ -89,7 +97,7 @@
<itemizedlist>
<listitem>
<para>
&rmtool; (&rmt;) on &sle; 15
&rmtool; (&rmt;)
</para>
</listitem>
<listitem>
Expand All @@ -99,39 +107,35 @@
</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-8-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-8-with-rmt"/>. &rmt; includes a setup script to
automate the registration process.
</para>
</listitem>
</orderedlist>
<note><!-- Can delete this if/when all names have been changed -->
</itemizedlist>
<note><!-- Can delete this if/when all names have been changed
trichardson 2024-06-26: Repo names have changed but repo labels still include RES -->
<title><emphasis>&productname;</emphasis> and <emphasis>&sles; with Expanded Support</emphasis></title>
<para>
<emphasis>&productname;</emphasis> now provides what used to be covered by
Expand Down Expand Up @@ -175,51 +179,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
35 changes: 21 additions & 14 deletions xml/configure-rmt-server.xml
Original file line number Diff line number Diff line change
Expand Up @@ -22,18 +22,23 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
</info>

<para>
Use this procedure to configure the &rmtool; (&rmt;) on &sles; 15.
Use this procedure to configure the &rmtool; (&rmt;) on &sles; (&slsa;) 15.
</para>
<itemizedlist>
<title>Requirements</title>
<listitem>
<para>
&sles; 15 is installed and up to date.
A &slsa; 15 virtual machine is installed as described in <xref linkend="install-rmt-vm"/>.
</para>
</listitem>
<listitem>
<para>
The &slsa; machine has a static IP address and host name.
</para>
</listitem>
<listitem>
<para>
You have a &scc; account and organization credentials.
You have a <link xlink:href="&sccurl;">&scc;</link> account and organization credentials.
</para>
</listitem>
</itemizedlist>
Expand All @@ -42,13 +47,19 @@ 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 in rmt-server</command></screen>
</step>
<step>
<para>
Install the following packages, which are not installed by default on a &minvm;:
</para>
<screen>&prompt.root;<command>zypper install yast2-rmt mariadb nginx</command></screen>
</step>
<step>
<para>
Start the <literal>rmt</literal> module in &yast;:
Start the &yast; <literal>rmt</literal>:
</para>
<screen>&prompt.root;<command>yast2 rmt</command></screen>
</step>
Expand All @@ -75,18 +86,14 @@ 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>
<para>
Enter a <guimenu>Common Name</guimenu> for the SSL certificates. The common
name is usually the FQDN of the server.
name is usually the host name of the server.
</para>
</step>
<step>
Expand All @@ -110,8 +117,8 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
</step>
<step>
<para>
&yast; displays the <guimenu>&rmt; Service Status</guimenu>.
Select <guimenu>Next</guimenu>.
&yast; displays the <guimenu>&rmt; Service Status</guimenu>. If there are no issues,
select <guimenu>Next</guimenu>.
</para>
</step>
<step>
Expand Down
101 changes: 101 additions & 0 deletions xml/html/rh-art-quickstart.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>Revision History: Registering RHEL 8 or CentOS Linux 8 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 | SLL"/>
<meta name="description" content="Add Minimal VM procedure."/>
<meta name="product-name" content="SUSE Liberty Linux"/>
<meta name="book-title" content="Registering RHEL 8 or CentOS Linux 8 with RMT"/>
<meta name="chapter-title" content="Revision History"/>
<meta name="tracker-url" content="https://github.com/SUSE/doc-liberty/issues/new"/>
<meta name="tracker-type" content="gh"/>
<meta name="tracker-gh-assignee" content="tahliar"/>
<meta name="tracker-gh-labels" content="documentation,issue"/>
<meta name="tracker-gh-milestone" content="8"/>
<meta name="publisher" content="SUSE"/><meta property="og:title" content="Registering RHEL 8 or CentOS Linux 8 with RMT"/>
<meta property="og:description" content="Use SUSE Liberty Linux to update RHEL 8 or CentOS 8."/>
<meta property="og:type" content="article"/>
<meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="Registering RHEL 8 or CentOS Linux 8 with RMT"/>
<meta name="twitter:description" content="Use SUSE Liberty Linux to update RHEL 8 or CentOS 8."/>
<script type="application/ld+json">{
"@context": "http://schema.org",
"@type": ["TechArticle"],
"image": "https://www.suse.com/assets/img/suse-white-logo-green.svg",

"isPartOf": {
"@type": "CreativeWorkSeries",
"name": "Product &amp; Solutions"
},

"inLanguage": "en",


"headline": "",

"author": [
{
"@type": "Corporation",
"name": "SUSE Product &amp; Solution Documentation Team",
"url": "https://www.suse.com/assets/img/suse-white-logo-green.svg"
}
],

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

"datePublished": "2022-04-01T00:00+02:00",


"about": [

],

"sameAs": [
"https://www.facebook.com/SUSEWorldwide/about",
"https://www.youtube.com/channel/UCHTfqIzPKz4f_dri36lAQGA",
"https://twitter.com/SUSE",
"https://www.linkedin.com/company/suse"
],
"publisher": {
"@type": "Corporation",
"name": "SUSE",
"url": "https://documentation.suse.com",
"logo": {
"@type": "ImageObject",
"url": "https://www.suse.com/assets/img/suse-white-logo-green.svg"
}
}
}</script>
<script type="text/javascript">

if ( window.location.protocol.toLowerCase() != 'file:' ) {
document.write('<link rel="stylesheet" type="text/css" href="https://documentation.suse.com/docserv/res/fonts/poppins/poppins.css"></link>');
};

</script><noscript><link rel="stylesheet" type="text/css" href="https://documentation.suse.com/docserv/res/fonts/poppins/poppins.css"/></noscript><script src="static/js/script-purejs.js" type="text/javascript"> </script><script src="static/js/highlight.min.js" type="text/javascript"> </script><script>

$(document).ready(function() {
$('.verbatim-wrap.highlight').each(function(i, block) {
hljs.highlightBlock(block);
});
});
hljs.configure({
useBR: false
});

</script></head><body><div class="revhistory" id="rh-art-quickstart"><h1 class="title">Revision History: Registering RHEL 8 or CentOS Linux 8 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-03-27</span></h2>
<p>
Clarify wording of requirements.
</p>
</section><section class="revision"><h2><span class="revision date">2023-01-09</span></h2>
<p>
Update with changes for new registration script.
</p>
</section><section class="revision"><h2><span class="revision date">2022-04-01</span></h2>
<p>
Initial release.
</p>
</section></div></body></html>
Loading

0 comments on commit 9636fd1

Please sign in to comment.