Skip to content

Commit

Permalink
Replace SMT install file with RMT install file
Browse files Browse the repository at this point in the history
jsc#PED7585
  • Loading branch information
tahliar committed Jan 19, 2024
1 parent 494d53b commit d8797f6
Show file tree
Hide file tree
Showing 5 changed files with 150 additions and 170 deletions.
29 changes: 12 additions & 17 deletions xml/art-quickstart.xml
Original file line number Diff line number Diff line change
Expand Up @@ -51,18 +51,13 @@
</para>
</important>
<para>
To register &rhla; &productnumber; or CentOS Linux &productnumber;, use &suse;'s
&smtool; (&smt;) for &sle; 12. &smt; is a proxy system for the &scc;. The &smt;
To register &rhel; &productnumber;, use
&suse;'s &rmtool; (&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 &smt; server and receive packages from it directly.
registered with the &rmt; server and receive packages from it directly.
</para>
<important role="compact">
<para>
The &rmtool; (&rmt;) for &sle; 15 does not support &rhla;/CentOS &productnumber; registration.
</para>
</important>
<para>
Registering &rhla; or CentOS Linux with &smt; involves the following steps:
Registering &rhla; or CentOS Linux with &rmt; involves the following steps:
</para>
<orderedlist>
<listitem>
Expand All @@ -73,8 +68,8 @@
</listitem>
<listitem>
<para>
<xref linkend="configure-smt-server"/>. This server must be installed on
&sles; 12. You can skip this step if you already have an &smt; server in
<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.
</para>
</listitem>
Expand Down Expand Up @@ -104,8 +99,8 @@
<title>Related information</title>
<listitem>
<para>
<link xlink:href="&dsc-sles;-12/html/SLES-all/book-smt.html">
<citetitle>&smtool; Guide</citetitle></link>
<link xlink:href="&dsc-sles;-15/html/SLES-all/book-rmt.html">
<citetitle>&rmtguide;</citetitle></link>
</para>
</listitem>
<listitem>
Expand Down Expand Up @@ -144,10 +139,10 @@
</listitem>
<listitem>
<para>
&sles; (&slsa;) 12 is installed and running in the same network as the
&sles; (&slsa;) 15 is installed and running in the same network as the
systems you want to register. You can use the &productname; subscription to
register &slsa;. To install &slsa; 12, see
<link xlink:href="&dsc-sles;-12/html/SLES-all/art-sle-installquick.html">
register &slsa;. To install &slsa; 15, see
<link xlink:href="&dsc-sles;-15/html/SLES-all/article-installation.html">
<citetitle>&instquick;</citetitle></link>.
</para>
</listitem>
Expand All @@ -163,7 +158,7 @@
</itemizedlist>
</section>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="configure-smt-server.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-smt.xml"/>

Expand Down
136 changes: 136 additions & 0 deletions xml/configure-rmt-server.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section
[
<!ENTITY % entities SYSTEM "generic-entities.ent">
%entities;
]>

<section xml:id="configure-rmt-server" xml:lang="en"
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">
<title>Configuring the &rmt; server</title>

<!-- There is also a version of this in doc-sle, file rmt_install.xml
https://documentation.suse.com/sles/15-SP3/single-html/SLES-rmt/#sec-rmt-installation-yast-configuration -->

<info>
<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
<dm:bugtracker></dm:bugtracker>
<dm:translation>no</dm:translation>
</dm:docmanager>
</info>

<para>
Use this procedure to configure the &rmtool; (&rmt;) on &sles; 15.
</para>
<itemizedlist>
<title>Requirements</title>
<listitem>
<para>
&sles; 15 is installed and up to date.
</para>
</listitem>
<listitem>
<para>
You have a &scc; account and organization credentials.
</para>
</listitem>
</itemizedlist>

<procedure xml:id="pro-configure-rmt-server">
<title>Configuring the &rmt; server</title>
<step>
<para>
Install &rmt; on &sles; 15:
</para>
<screen>&prompt.root;<command>zypper in rmt-server</command></screen>
</step>
<step>
<para>
Start the <literal>rmt</literal> module in &yast;:
</para>
<screen>&prompt.root;<command>yast2 rmt</command></screen>
</step>
<step>
<para>
Enter your <guimenu>Organization Credentials</guimenu>, then select
<guimenu>Next</guimenu>.
</para>
<tip role="compact">
<para>
To find your organization credentials, log in to the
<link xlink:href="https://scc.suse.com">&scc;</link>, select your
organization from <guimenu>My Organizations</guimenu>, and click
<guimenu>Proxies</guimenu>. Your organization's <guimenu>Mirroring
credentials</guimenu> are in the top right corner.
</para>
</tip>
</step>
<step>
<para>
Enter <guimenu>Database Credentials</guimenu> for a new MariaDB database user,
then select <guimenu>Next</guimenu>. The new user is created.
</para>
</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>.
</para>
</step>
<step>
<para>
Enter a <guimenu>Common Name</guimenu> for the SSL certificates. The common
name is usually the FQDN of the server.
</para>
</step>
<step>
<para>
If the server has other domain names or IP addresses, enter these as
<guimenu>Alternative common names</guimenu>. Select <guimenu>Add</guimenu>
to add new names. When all common names are entered, select <guimenu>Next</guimenu>.
</para>
</step>
<step>
<para>
If prompted, enter and confirm a password for the CA private key, then select
<guimenu>OK</guimenu>.
</para>
</step>
<step>
<para>
Activate the check box <guimenu>Open Ports for HTTP and HTTPS in Firewall</guimenu>,
then select <guimenu>Next</guimenu>.
</para>
</step>
<step>
<para>
&yast; displays the <guimenu>&rmt; Service Status</guimenu>.
Select <guimenu>Next</guimenu>.
</para>
</step>
<step>
<para>
Review the <guimenu>Configuration Summary</guimenu>, then select
<guimenu>Finish</guimenu> to close &yast;.
</para>
</step>
</procedure>
<para>
&yast; enables and starts all &rmt; &systemd; services and timers.
</para>
<itemizedlist>
<title>More information</title>
<listitem>
<para>
<link xlink:href="&dsc-sles;-15/html/SLES-all/cha-rmt-installation.html">
&rmt; installation and configuration</link>
</para>
</listitem>
</itemizedlist>
</section>
151 changes: 0 additions & 151 deletions xml/configure-smt-server.xml

This file was deleted.

2 changes: 1 addition & 1 deletion xml/mirror-repositories-with-smt.xml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
<title>Requirements</title>
<listitem>
<para>
<xref linkend="configure-smt-server"/>
<xref linkend="configure-rmt-server"/>
</para>
</listitem>
<listitem>
Expand Down
2 changes: 1 addition & 1 deletion xml/register-rhel-with-smt.xml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
<title>Requirements</title>
<listitem>
<para>
<xref linkend="configure-smt-server"/>
<xref linkend="configure-rmt-server"/>
</para>
</listitem>
<listitem>
Expand Down

0 comments on commit d8797f6

Please sign in to comment.