Article about configuring opensm (#237)

DC-subnet-manager-configuring

@@ -0,0 +1,7 @@
+MAIN="subnet-manager-configuring.asm.xml"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
+PROFOS="alp-dolomite"

articles/subnet-manager-configuring.asm.xml

@@ -0,0 +1,118 @@
+<?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;
+]>
+<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 -->
+  <resources>
+    <resource xml:id="_concept-opensm" href="../concepts/opensm.xml"/>
+    <resource xml:id="_task-opensm-configuring" href="../tasks/opensm-configuring.xml"/>
+    <resource href="../common/legal.xml" xml:id="_legal"/>
+    <resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl"/>
+  </resources>
+<!-- S T R U C T U R E -->
+  <structure renderas="article" xml:id="subnet-manager-configuring" xml:lang="en">
+    <merge>
+      <title>Configuring a &subnetmanager;</title>
+      <revhistory xml:id="rh-subnet-manager-configuring">
+        <revision><date>2023-11-14</date>
+          <revdescription>
+            <para>
+              Initial document
+            </para>
+          </revdescription>
+        </revision>
+      </revhistory>
+      <meta name="maintainer" content="[email protected]" its:translate="no"/>
+      <meta name="updated" content="2023-11-14" its:translate="no"/>
+<!-- this does not work yet. Use the dm tags listed below for now
+        <meta name="bugtracker" its:translate="no">
+          <phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>
+          <phrase role="component">Non-product-specific documentation</phrase>
+          <phrase role="product">Smart Docs</phrase>
+          <phrase role="assignee">[email protected]</phrase>
+        </meta>
+        -->
+<!-- not supported, yet. Use dm: tag for now
+        <meta name="translation" its:translate="no">
+        <phrase role="trans">yes</phrase>
+        <phrase role="language">de-de,cs-cz</phrase>
+        </meta>
+        -->
+<!-- enter the platform identifier or a list of
+        identifiers, separated by ; -->
+      <meta name="architecture" content="x86;power" its:translate="no"/>
+      <meta name="productname" its:translate="no"><productname version="15-SP5">&sles;</productname><productname version="1.0">&alpshort;</productname>
+      </meta>
+      <meta name="title" its:translate="yes">Configuring the &opensm; &subnetmanager;</meta>
+      <meta name="description" its:translate="yes">Configuring &opensm;&mdash;the &infiniband;
+      compliant implementation of &subnetmanager;</meta>
+      <meta name="social-descr" its:translate="yes">Configuring the &opensm; &subnetmanager;</meta>
+<!-- suitable category, comma-separated list of categories -->
+      <meta name="category" content="Networking" its:translate="no"/>
+      <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
+        <dm:bugtracker>
+          <dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
+          <dm:component>Smart Docs</dm:component>
+          <dm:product>Documentation</dm:product>
+          <dm:assignee>[email protected]</dm:assignee>
+        </dm:bugtracker>
+        <dm:translation>yes</dm:translation>
+      </dm:docmanager>
+      <abstract>
+        <variablelist>
+          <varlistentry>
+            <term>WHAT?</term>
+            <listitem>
+              <para>
+                &opensm; is an &infiniband; compliant implementation of the &subnetmanager;.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>WHY?</term>
+            <listitem>
+              <para>
+                To learn about the &opensm; implementation of the &subnetmanager; and how to configure
+                it.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>EFFORT</term>
+            <listitem>
+              <para>
+                Less than 30 minutes and basic knowledge of Linux administration.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+      </abstract>
+    </merge>
+<!-- pull in all the topic files you need -->
+<!-- pick the appropriate type of include to match your needs -->
+<!-- pull in a topic as is -->
+    <module resourceref="_concept-opensm" renderas="section"/>
+    <module resourceref="_task-opensm-configuring" renderas="section">
+      <merge>
+        <abstract>
+          <para/>
+        </abstract>
+      </merge>
+    </module>
+<!-- pull in a topic and switch the title -->
+    <module resourceref="_legal"/>
+    <module resourceref="_gfdl">
+      <output renderas="appendix"/>
+    </module>
+  </structure>
+</assembly>