Merge remote-tracking branch 'origin/main' into tbazant-ai-update-deployment-jsc#SUSEAI-121

tbazant · tbazant · commit d88c0a5cbd1c · 2025-04-17T11:13:13.000+02:00
diff --git a/DC-Micro-zseries-deployment-pxe b/DC-Micro-zseries-deployment-pxe
@@ -0,0 +1,10 @@
+MAIN="deployment-pxe-boot.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="slmicro"
+PROFARCH="zseries"
+PROFCONDITION="x86-64;pxe-boot;zseries"
+
diff --git a/articles/deployment-pxe-boot.asm.xml b/articles/deployment-pxe-boot.asm.xml
@@ -80,6 +80,7 @@
   <structure renderas="article" xml:id="deployment-pxe-boot" xml:lang="en">
     <merge>
       <title>Deploying &productname; Using Network PXE Boot</title>
+      <subtitle arch="zseries">on &zseries;</subtitle>
       
       <!-- Create revision history to enable versioning; add most recent entries at the top. -->
       <!-- Check https://documentation.suse.com/style/current/single-html/docu_styleguide/#sec-revhistory for detailed instructions-->
diff --git a/references/systemd-securing-techniques.xml b/references/systemd-securing-techniques.xml
@@ -98,7 +98,7 @@
         <para>
           You can use <emphasis>resource limits</emphasis> to apply security limits on services.
           Two of them can disable specific operating system features:
-          <option>RLIMIT_NPROC=1</option> disables precess forking, while
+          <option>RLIMIT_NPROC=1</option> disables process forking, while
           <option>RLIMIT_FSIZE=0</option> disables creating non-empty files on the file system.
         </para>
       </listitem>
diff --git a/tasks/deployment-network-tftp.xml b/tasks/deployment-network-tftp.xml
@@ -111,9 +111,8 @@ SL-Micro.<replaceable>ARCH</replaceable>-<replaceable>VERSION</replaceable>.xz
       </step>
       <step performance="optional">
         <para>
-          Create directories for the first boot configuration:
+          Create directories for the first boot configuration:        
           
-          for &combustion; and/or &ignition; configuration:
         </para>
         <substeps>
           <step>
@@ -138,15 +137,29 @@ SL-Micro.<replaceable>ARCH</replaceable>-<replaceable>VERSION</replaceable>.xz
         <para>
           Place the &combustion; and/or &ignition; configuration to corresponding directories.
         </para>        
-      </step>
+      </step>      
       <step>
         <para>
-          Adjust/add the following parameters in the <filename>SL-Micro.<replaceable>ARCH</replaceable>-&productnumber;.append</filename> file:
+          Adjust the <filename>/srv/tftpboot/grub2/grub.cfg
+          </filename> file to include &productname;:
         </para>
-        <itemizedlist>
-          <listitem>
-            <para>
-              <literal>rd.kiwi.install.image</literal> &ndash; provide the path to the
+        <screen>
+menuentry 'Install SUSE Linux Micro' {
+    linux sl-micro/linux <replaceable>PARAMETERS_TO_PASS_TO_KERNEL</replaceable>
+    initrd sl-micro/initrd
+}
+        </screen>
+        <para>
+          The <replaceable>PARAMETERS_TO_PASS_TO_KERNEL</replaceable> are listed in the file
+          <filename>SL-Micro.<replaceable>ARCH</replaceable>-&productnumber;.append</filename>.
+          Their explanations follow:
+        </para>
+        <variablelist>
+          <varlistentry>
+            <term><literal>rd.kiwi.install.image</literal></term>
+            <listitem>
+              <para>
+              Provide the path to the
               installation image
               <literal>SL-Micro.<replaceable>ARCH</replaceable>&productnumber;.xz</literal>. The
               path must include the protocol, IP address and the relative path to the installation
@@ -160,51 +173,52 @@ SL-Micro.<replaceable>ARCH</replaceable>-<replaceable>VERSION</replaceable>.xz
               in a service unit file attribute that defines the binary to run using the 
               <literal>-s</literal> option.
             </para>
-
-          </listitem>
-          <listitem>
-            <para>
-              <literal>rd.kiwi.oem.installdevice</literal> &ndash; enables you to perform
-              unattended installation.
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>rd.kiwi.install.pass.bootparam</literal> &ndash; after the image is copied
-              to the target disk, kiwi performs a kexec. This parameter instructs kiwi that it must
-             pass additional parameters to the kernel. For example, the below described ones.
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              <literal>combustion.url</literal> &ndash; if needed, provide a full URL to the
-              &combustion; script that is passed to the kernel CLI. 
-            </para>
-          </listitem>
-          <listitem>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><literal>rd.kiwi.oem.installdevice</literal></term>
+            <listitem>
+              <para>
+                Passing this parameter enables you to perform unattended installation.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><literal>rd.kiwi.install.pass.bootparam</literal></term>
+            <listitem>
             <para>
-              <literal>ignition.config.url</literal> &ndash; if needed, provide a full URL to the
-              &ignition; configuration file that is passed to the kernel CLI. Can be used along with &combustion;.
+              After the image is copied to the target disk, kiwi performs a kexec. This parameter instructs kiwi that it must
+             pass additional parameters to the kernel. For example, the ones described below.
             </para>
-          </listitem>
-          <listitem arch="zseries">
-            <para>
-<literal>rd.zdev=qeth,<replaceable>READ_CHANNEL</replaceable><replaceable>WRITE_CHANNEL</replaceable>:<replaceable>DATA_CHANNEL</replaceable></literal>
-           &ndash; the attribute specifies booting from network over a network device.</para>
-          </listitem>
-        </itemizedlist>        
-      </step>
-      <step>
-        <para>
-          Adjust the <filename>/srv/tftpboot/grub2/grub.cfg
-          </filename> file to include &productname;:
-        </para>
-        <screen>
-menuentry 'Install SUSE Linux Micro' {
-    linux sl-micro/linux root=/dev/ram0 <replaceable>PARAMETERS_TO_PASS_TO_KERNEL</replaceable>
-    initrd sl-micro/initrd
-}
-        </screen>                
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term><literal>combustion.url</literal></term>
+            <listitem>
+              <para>
+                If needed, provide a full URL to the
+              &combustion; script that is passed to the kernel CLI.
+              </para>
+            </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>ignition.config.url</literal></term>
+              <listitem>
+                <para>
+                  If needed, provide a full URL to the
+                  &ignition; configuration file that is passed to the kernel CLI. Can be used along with &combustion;.
+                </para>
+              </listitem>
+            </varlistentry>
+            <varlistentry arch="zseries">
+              <term><literal>rd.zdev=qeth</literal></term>
+              <listitem>
+                <para>    
+               The attribute specifies booting from a network over a network device. Define it as follows:</para>
+             <screen>rd.zdev=qeth,<replaceable>READ_CHANNEL</replaceable><replaceable>WRITE_CHANNEL</replaceable>:<replaceable>DATA_CHANNEL</replaceable></screen>
+              </listitem>
+            </varlistentry>         
+        </variablelist>                
       </step>
     </procedure>
 </topic>
diff --git a/tasks/pam-config-tool.xml b/tasks/pam-config-tool.xml
@@ -45,7 +45,7 @@
   <procedure>
     <step>
       <formalpara>
-        <title>Auto-generate a fresh unix-style PAM configuration.</title>
+        <title>Auto-generate a fresh Unix-style PAM configuration.</title>
         <para>
           Let <command>pam-config</command> create the simplest possible setup
           which you can extend later on. The <command>pam-config
