Skip to content

Commit

Permalink
Add new SLL Lite guide
Browse files Browse the repository at this point in the history
  • Loading branch information
tahliar committed Jun 17, 2024
1 parent d17be89 commit 7d0e289
Show file tree
Hide file tree
Showing 10 changed files with 708 additions and 36 deletions.
13 changes: 13 additions & 0 deletions DC-lite-quickstart
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
#
# DC file for SUSE Liberty Linux
#
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"
1 change: 1 addition & 0 deletions DC-quickstart
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
MAIN="art-quickstart.xml"
ROOTID="art-quickstart"

PROFAUDIENCE="sll"
PROFCONDITION="suse-product"
#PROFCONDITION="suse-product;beta"
#PROFCONDITION="community-project"
Expand Down
189 changes: 189 additions & 0 deletions xml/art-lite-quickstart.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,189 @@
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook51-profile.xsl"
type="text/xml"
title="Profiling step"?>
<!DOCTYPE article
[
<!ENTITY % entities SYSTEM "generic-entities.ent">
%entities;
]>

<article xml:id="art-lite-quickstart" xml:lang="en"
xmlns="http://docbook.org/ns/docbook" version="5.1"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink">

<info>
<title>Registering CentOS Linux &productnumber; with &rmt;</title>
<productname>&productname;</productname>
<productname role="abbrev">&productnameshort;</productname>
<date><?dbtimestamp format="B d, Y"?></date>
<xi:include href="common_copyright_gfdl.xml"/>
<abstract>
<para>
This guide describes how to use &productname; to update CentOS&nbsp;Linux&nbsp;&productnumber;.
</para>
</abstract>
<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker>
<dm:url>https://github.com/SUSE/doc-liberty/issues/new</dm:url>
<dm:labels>documentation,issue</dm:labels>
<dm:version>7</dm:version>
<dm:assignee>tahliar</dm:assignee>
</dm:bugtracker>
<dm:editurl>https://github.com/SUSE/doc-liberty/edit/maintenance/SLL7/xml/</dm:editurl>
<dm:translation>no</dm:translation>
</dm:docmanager>
<meta name="description" its:translate="yes">How to use &productname; and RMT to update CentOS Linux 7.</meta>
<meta name="social-descr" its:translate="yes">Use &productname; to update CentOS 7.</meta>
<meta name="task" its:translate="yes">
<phrase>Upgrade &amp; Update</phrase>
<phrase>Administration</phrase>
</meta>
<revhistory xml:id="rh-art-lite-quickstart">
<revision>
<date>2024-06-18</date>
<revdescription>
<para>
Initial release.
</para>
</revdescription>
</revision>
</revhistory>
</info>

<section xml:id="introduction-lite-quickstart">
<title>Introduction</title>
<para>
&productname; is a technology and support solution for CentOS Linux &productnumber;.
With this one-year subscription, you can register and receive updates for
CentOS&nbsp;Linux&nbsp;&productnumber; with &suse;'s &rmtool; (&rmt;). The subscription also
includes one entitlement for &sles; 15 to host &rmt;.
</para>
<para>
&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>
<important role="compact">
<para>
CentOS&nbsp;Stream is not supported.
</para>
</important>
<itemizedlist>
<title>Procedure overview</title>
<listitem>
<para>
If you already have an &rmt; server and only need to <emphasis role="bold">register your
CentOS Linux 7 system</emphasis>, skip straight to <xref linkend="register-7-with-rmt"/>.
</para>
</listitem>
<listitem>
<para>
If you already have an &rmt; server but still need to <emphasis role="bold">mirror the &reponame;
&productnumber; repositories</emphasis>, go to <xref linkend="mirror-repositories-with-rmt"/>.
</para>
</listitem>
<listitem>
<para>
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>
</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"/>

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

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

<section xml:id="troubleshoot-lite-quickstart">
<title>Troubleshooting</title>
<variablelist>
<varlistentry>
<term><systemitem>nginx.service</systemitem> is inactive after installing the
<package>rmt-server</package> package</term>
<listitem>
<para>
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.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&reponame; doesn't appear in <command>rmt-cli products list</command>
after <command>rmt-cli sync</command></term>
<listitem>
<para>
Check your network. If the network is down, <command>rmt-cli sync</command> fails without
showing an error.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mirroring completes with errors</term>
<listitem>
<para>
If some packages could not be downloaded because of timeouts, rerun the
<command>rmt-cli mirror</command> command until all packages are downloaded.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Setup script cannot access the &reponame; repository</term>
<listitem>
<para>
The <filename>repodata</filename> directory on the &rmt; server will not
be available until all of the packages for that repository are downloaded.
If some packages could not be downloaded to the &rmt; server because of timeouts
during the first mirroring, rerun the <command>rmt-cli mirror</command>
command until all packages are downloaded.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Setup script cannot install <package>suseconnect-ng</package> because of
package dependencies</term>
<listitem>
<para>
&productname; only supports the latest minor release
of <phrase audience="sll">&rhla; or </phrase>CentOS Linux <phrase audience="sll-l">7</phrase>.
If your system is running the latest version and <package>suseconnect-ng</package>
still has package dependency issues, try the following workaround:
</para>
<orderedlist>
<listitem>
<para>
Edit the <filename>rmt-client-setup-res</filename> script to add
<literal>--skip-broken</literal> to the following line:
</para>
<screen>$YUM install sles_es-release-server suseconnect-ng librepo <emphasis role="bold">--skip-broken</emphasis></screen>
</listitem>
<listitem>
<para>
Run the script and accept any proposed package changes.
<package>suseconnect-ng</package> will be skipped.
</para>
</listitem>
<listitem>
<para>
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 <package>suseconnect-ng</package>.
</para>
</listitem>
</orderedlist>
</listitem>
</varlistentry>
</variablelist>
</section>
<xi:include href="common_legal.xml"/>
</article>
32 changes: 24 additions & 8 deletions xml/configure-rmt-server.xml
Original file line number Diff line number Diff line change
Expand Up @@ -22,18 +22,28 @@ 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.
<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>
</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 @@ -44,11 +54,17 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
<para>
Install &rmt; on &sles; 15:
</para>
<screen>&prompt.root;<command>zypper in rmt-server</command></screen>
<screen>&prompt.root;<command>zypper install rmt-server</command></screen>
</step>
<step audience="sll-l">
<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> module:
</para>
<screen>&prompt.root;<command>yast2 rmt</command></screen>
</step>
Expand Down Expand Up @@ -86,7 +102,7 @@ https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-install
<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 +126,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
89 changes: 89 additions & 0 deletions xml/html/rh-art-lite-quickstart.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
<?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 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="Initial release."/>
<meta name="product-name" content="SUSE Liberty LinuxSUSE Liberty Linux Lite"/>
<meta name="book-title" content="Registering CentOS Linux 7 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="7"/>
<meta name="publisher" content="SUSE"/><meta property="og:title" content="Revision History | SLLSLL-L"/>
<meta property="og:description" content="Use SUSE Liberty LinuxSUSE Liberty Linux Lite to update Cent"/>
<meta property="og:type" content="article"/>
<meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="Revision History | SLLSLL-L"/>
<meta name="twitter:description" content="Use SUSE Liberty LinuxSUSE Liberty Linux Lite to update Cent"/>
<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-18T00:00+02:00",

"datePublished": "2024-06-18T00: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-lite-quickstart"><h1 class="title">Revision History: Registering CentOS Linux 7 with RMT</h1><section class="revision"><h2><span class="revision date">2024-06-18</span></h2>
<p>
Initial release.
</p>
</section></div></body></html>
Loading

0 comments on commit 7d0e289

Please sign in to comment.