art-quickstart.xml

<?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-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 &rhla; &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 explains how to register and update &rhel;&nbsp;&productnumber; with &rmtool; (&rmt;).
   </para>
   <para>
    To register with &smlm;, see
    <link xlink:href="https://documentation.suse.com/liberty/9/html/suma-quickstart/art-suma-quickstart.html">
    <citetitle>Registering &rhla; &productnumber; with &smlm;</citetitle></link>.
   </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>9</dm:version>
    <dm:assignee>tahliar</dm:assignee>
   </dm:bugtracker>
   <dm:editurl>https://github.com/SUSE/doc-liberty/edit/main/xml/</dm:editurl>
   <dm:translation>no</dm:translation>
  </dm:docmanager>
  <meta name="title" its:translate="yes">Registering &rhla; &productnumber; with &rmt;</meta>
  <meta name="description" its:translate="yes">How to use &productname; and &rmt; to update &rhel; &productnumber;.</meta>
  <meta name="social-descr" its:translate="yes">How to use &rmt; to update &rhla; &productnumber;.</meta>
  <meta name="task" its:translate="yes">
    <phrase>Upgrade &amp; Update</phrase>
    <phrase>Administration</phrase>
  </meta>
  <revhistory xml:id="rh-art-quickstart">
    <revision>
      <date>2025-12-18</date>
      <revdescription>
        <para>
          Added extended minor-version support (EMS)
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2025-12-04</date>
      <revdescription>
        <para>
          Simplified Source and Debug steps
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2025-10-27</date>
      <revdescription>
        <para>
          Added UEFI Secure Boot warning
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2025-08-01</date>
      <revdescription>
        <para>
          Changed SUSE Manager to SUSE Multi-Linux Manager where applicable
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-12-13</date>
      <revdescription>
        <para>
          Added Source and Debug appendix
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-12-11</date>
      <revdescription>
        <para>
          Changed SUSE Liberty Linux to SUSE Multi-Linux Support where applicable
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-12-06</date>
      <revdescription>
        <para>
          RMT is now available with all subscription levels
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-10-31</date>
      <revdescription>
        <para>
          Clarified the tools available with each subscription level
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-10-22</date>
      <revdescription>
        <para>
          Added more information about default and optional repositories
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-06-27</date>
      <revdescription>
        <para>
          Added Minimal VM procedure
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2024-03-27</date>
      <revdescription>
        <para>
          Clarified wording of requirements
        </para>
      </revdescription>
    </revision>
    <revision>
      <date>2022-08-24</date>
      <revdescription>
        <para>
          Initial release
        </para>
      </revdescription>
    </revision>
  </revhistory>
 </info>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml"/>

<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-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>&productname; does not 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 &productname; 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</package> because of
    package dependencies</term>
    <listitem>
     <para>
      &productname; only supports the latest minor version of each &rhla; release.
      If your system is running the latest version and <package>SUSEConnect</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>$DNF install SUSEConnect librepo <emphasis role="bold">--skip-broken</emphasis></screen>
      </listitem>
      <listitem>
       <para>
        Run the script and accept any proposed package changes.
        <package>SUSEConnect</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</package>.
       </para>
      </listitem>
     </orderedlist>
    </listitem>
   </varlistentry>
       <varlistentry>
      <term><command>dnf update</command> fails with <literal>Errors during downloading metadata
      for repository &mdash; Status code: 404</literal></term>
      <listitem>
        <para>
          The repository shown in the error message might not be mirrored on the &rmt; server.
          The optional <literal>Source</literal> and <literal>Debug</literal> repositories can be
          enabled with <command>dnf config-manager</command> even if they are not available from &rmt;.
        </para>
        <para>
        </para>
        <orderedlist>
          <listitem>
            <para>
              Run <command>dnf repolist all</command> to show the status of the repositories.
            </para>
          </listitem>
          <listitem>
            <para>
              If the repository shown in the error message has the status
              <literal>enabled</literal>, disable it with the following command:
            </para>
<screen>&prompt.root;<command>dnf config-manager --disable <replaceable>REPO_ID</replaceable></command></screen>
          </listitem>
          <listitem>
            <para>
              Run <command>dnf update</command> again to see if the issue is resolved.
            </para>
          </listitem>
          <listitem>
            <para>
              If you need the unavailable repository for your system, see
              <xref linkend="mirror-repositories-with-rmt"/>.
            </para>
          </listitem>
        </orderedlist>
      </listitem>
    </varlistentry>
  </variablelist>
 </section>
 <xi:include href="app-access-src-debug.xml"/>
 <xi:include href="app-switch-to-ems.xml"/>
 <xi:include href="common_legal.xml"/>
</article>