Add modular RMT documentation with Ansible-based configuration

DC-SAP-rmt-installing-configuring

@@ -0,0 +1,15 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-installing-configuring.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+PROFOS="sles4sap"
+#PROFCONDITION="16.0"
+#PROFCONDITION="suse-product;beta"
+#PROFCONDITION="community-project"
+
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"

DC-SAP-rmt-migrating-from-smt

@@ -0,0 +1,18 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-migrating-from-smt.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+## Profiling
+PROFOS="sles4sap"
+#PROFCONDITION="16.0"
+#PROFARCH="x86_64;zseries;power;aarch64"
+
+## stylesheet location
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"
+
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"

DC-SAP-rmt-mirroring-repositories

@@ -0,0 +1,18 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-mirroring-repositories.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+## Profiling
+PROFOS="sles4sap"
+#PROFCONDITION="16.0"
+#PROFARCH="x86_64;zseries;power;aarch64"
+
+## stylesheet location
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"
+
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"

DC-SLES-rmt-installing-configuring

@@ -0,0 +1,18 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-installing-configuring.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+## Profiling
+PROFOS="sles"
+#PROFCONDITION="16.0"
+#PROFARCH="x86_64;zseries;power;aarch64"
+
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
+
+## stylesheet location
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"

DC-SLES-rmt-migrating-from-smt

@@ -0,0 +1,18 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-migrating-from-smt.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+## Profiling
+PROFOS="sles"
+#PROFCONDITION="16.0"
+#PROFARCH="x86_64;zseries;power;aarch64"
+
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
+
+## stylesheet location
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"

DC-SLES-rmt-mirroring-repositories

@@ -0,0 +1,18 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+## Basics
+MAIN="rmt-mirroring-repositories.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+## Profiling
+PROFOS="sles"
+#PROFCONDITION="16.0"
+#PROFARCH="x86_64;zseries;power;aarch64"
+
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
+
+## stylesheet location
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2021-ns"

articles/rmt-installing-configuring.asm.xml

@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- file: templates/articles/assembly.xml -->
+<?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc"
+            type="application/relax-ng-compact-syntax"?>
+<!DOCTYPE assembly
+[
+    <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
+    %entities;
+]>
+<!-- refers to legacy doc: https://github.com/SUSE/doc-sle/blob/main/xml/rmt_install.xml -->
+<!-- refer to README.md for file and id naming conventions -->
+<assembly version="5.2" xml:lang="en"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:trans="http://docbook.org/ns/transclusion"
+          xmlns:its="http://www.w3.org/2005/11/its"
+          xmlns="http://docbook.org/ns/docbook">
+  <!-- R E S O U R C E S -->
+  <!-- Glue files -->
+  <resources>
+    <resource href="../glues/rmt-installing-intro.xml" xml:id="_rmt-installing-intro">
+      <description>Introduction to installing RMT</description>
+    </resource>
+    <resource href="../glues/rmt-installing-more-info.xml" xml:id="_rmt-installing-more-info">
+      <description>For more information</description>
+    </resource>
+  </resources>
+  <!-- References -->
+  <resources>
+    <resource href="../references/rmt-storage-requirements.xml" xml:id="_rmt-storage-requirements">
+      <description>RMT storage requirements</description>
+    </resource>
+    <resource href="../references/rmt-configuration-files.xml" xml:id="_rmt-configuration-files">
+      <description>RMT configuration files</description>
+    </resource>
+  </resources>
+  <!-- Tasks -->
+  <resources>
+    <resource href="../tasks/rmt-installing-during-installation.xml" xml:id="_rmt-installing-during-installation">
+      <description>Installing RMT during system installation</description>
+    </resource>
+    <resource href="../tasks/rmt-installing-existing-system.xml" xml:id="_rmt-installing-existing-system">
+      <description>Installing RMT on an existing system</description>
+    </resource>
+    <resource href="../tasks/rmt-deploying-on-kubernetes.xml" xml:id="_rmt-deploying-on-kubernetes">
+      <description>Deploying RMT on Kubernetes</description>
+    </resource>
+    <resource href="../tasks/rmt-configuring-with-ansible.xml" xml:id="_rmt-configuring-with-ansible">
+      <description>Configuring RMT with Ansible</description>
+    </resource>
+    <resource href="../tasks/rmt-enabling-slp-announcements.xml" xml:id="_rmt-enabling-slp-announcements">
+      <description>Enabling SLP announcements</description>
+    </resource>
+    <resource href="../tasks/rmt-accessing-scc-behind-firewall.xml" xml:id="_rmt-accessing-scc-behind-firewall">
+      <description>Accessing SCC from behind a firewall</description>
+    </resource>
+    <resource href="../tasks/rmt-regenerating-certificates.xml" xml:id="_rmt-regenerating-certificates">
+      <description>Managing TLS/SSL certificates</description>
+    </resource>
+  </resources>
+  <!-- Legal -->
+  <resources>
+    <resource href="../common/legal.xml" xml:id="_legal">
+      <description>Legal Notice</description>
+    </resource>
+    <resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl">
+      <description>GNU Free Documentation License</description>
+    </resource>
+  </resources>
+  <!-- S T R U C T U R E -->
+  <structure renderas="article" xml:id="rmt-installing-configuring" xml:lang="en">
+    <merge>
+      <title>Installing and configuring an RMT server</title>
+      <revhistory xml:id="rh-rmt-installing-configuring">
+        <revision><date>2026-07-20</date>
+          <revdescription>
+            <para>
+              Initial version. Migrated from the SLE Repository Mirroring Tool
+              Guide and updated for the &ansible;-based configuration workflow.
+            </para>
+          </revdescription>
+        </revision>
+      </revhistory>
+      <meta name="maintainer" content="" its:translate="no"/>
+      <meta name="architecture" its:translate="no">
+        <phrase>&x86-64;</phrase>
+        <phrase>&power;</phrase>
+      </meta>
+      <meta name="productname" its:translate="no">
+        <productname version="&productnumber;" os="sles;sles4sap">&productname;</productname>
+      </meta>
+      <meta name="title" its:translate="yes">Install and configure an RMT server</meta>
+      <meta name="description" its:translate="yes">How to install the Repository Mirroring Tool and configure it with the Ansible playbook workflow</meta>
+      <meta name="social-descr" its:translate="yes">Install and configure RMT</meta>
+      <meta name="category" its:translate="no">
+        <phrase>Systems Management</phrase>
+      </meta>
+      <meta name="task" its:translate="no">
+        <phrase>Installation</phrase>
+        <phrase>Configuration</phrase>
+      </meta>
+      <meta name="series" its:translate="no">Products &amp; Solutions</meta>
+      <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
+        <dm:bugtracker>
+          <dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
+          <dm:component>Documentation</dm:component>
+          <dm:product>SUSE Linux Enterprise Server &productnumber;</dm:product>
+          <dm:assignee>amrita.sakthivel@suse.com</dm:assignee>
+        </dm:bugtracker>
+        <dm:translation>yes</dm:translation>
+      </dm:docmanager>
+      <abstract>
+        <variablelist>
+          <varlistentry>
+            <term>WHAT?</term>
+            <listitem>
+              <para>
+                &rmt; (Repository Mirroring Tool) is a proxy for &scc; that
+                mirrors software repositories and registers client systems in
+                your own network.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>WHY?</term>
+            <listitem>
+              <para>
+                A local &rmt; server saves bandwidth and time by downloading
+                updates once and serving them to all client systems, and keeps
+                registration inside your network.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>EFFORT</term>
+            <listitem>
+              <para>
+                It takes about 30 minutes to install &rmt; and run the
+                &ansible; configuration playbook on a freshly installed system.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>GOAL</term>
+            <listitem>
+              <para>
+                A running &rmt; server, configured with &ansible; and ready to
+                mirror repositories and register clients.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>REQUIREMENTS</term>
+            <listitem>
+              <itemizedlist>
+                <listitem><para>A newly installed &productname; system or &minvm; image.</para></listitem>
+                <listitem><para>&scc; organization credentials for mirroring.</para></listitem>
+                <listitem><para>Sufficient storage for the repositories you plan to mirror.</para></listitem>
+              </itemizedlist>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+      </abstract>
+    </merge>
+    <module resourceref="_rmt-installing-intro" renderas="section"/>
+    <module resourceref="_rmt-storage-requirements" renderas="section"/>
+    <module resourceref="_rmt-installing-during-installation" renderas="section"/>
+    <module resourceref="_rmt-installing-existing-system" renderas="section"/>
+    <module resourceref="_rmt-deploying-on-kubernetes" renderas="section"/>
+    <module resourceref="_rmt-configuring-with-ansible" renderas="section"/>
+    <module resourceref="_rmt-enabling-slp-announcements" renderas="section"/>
+    <module resourceref="_rmt-accessing-scc-behind-firewall" renderas="section"/>
+    <module resourceref="_rmt-configuration-files" renderas="section"/>
+    <module resourceref="_rmt-regenerating-certificates" renderas="section"/>
+    <module resourceref="_rmt-installing-more-info" renderas="section"/>
+    <module resourceref="_legal" renderas="section"/>
+    <module resourceref="_gfdl" renderas="appendix"/>
+  </structure>
+</assembly>