Agama-based install: Complete overhaul of the storate step

Author: cwickert

Diff for: DC-SLES-s390-agama-based-installation

@@ -17,3 +17,6 @@ DOCBOOK5_RNG_URI="urn:x-suse:rng:v2:geekodoc-flat"
 
 STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
 FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"
+
+# Disable arch-specific markup such as in <para arch="foo">
+XSLTPARAM='--param para.use.arch=0'

Diff for: tasks/agama-manual-installation.xml

@@ -411,9 +411,9 @@ live.password=linux rd.zdev=dasd,0.0.0160</screen>
           </mediaobject>
         </informalfigure>
       </step>
-      <step arch="zseries">
+      <step>
         <para>
-          Configure your storage
+          Select a storage device for installation.
         </para>
         <informalfigure>
           <mediaobject>
@@ -427,6 +427,75 @@ live.password=linux rd.zdev=dasd,0.0.0160</screen>
             </imageobject>
           </mediaobject>
         </informalfigure>
+        <para>
+          Currently installations on single discs or LVM are supported. To change the disk,
+          click the <guilabel>Change</guilabel> button in the <guilabel>Installation device</guilabel>
+          section.
+        </para>
+        <para>
+          To use DASD, &iscsi; or zFCP devices, you need configure them first. Click
+          <guilabel>Advanced storage techs</guilabel> and select the desired technology. The DASD
+          and zFCP options are only available if the corresponding devices are attached.
+        </para>
+        <para arch="zseries">
+          To activate a DASD disk, select it from the list and click
+          <menuchoice><guilabel>Perform am action</guilabel><guimenu>Activate</guimenu></menuchoice>. Once
+          the disk is activated, you can select it for installation in the previous screen.
+        </para>
+        <para arch="zseries">
+          To activate a zFCP disk, select it from the list and activate it by clicking on the three-dot
+          menu.
+        </para>
+        <para>
+          To detect an &iscsi; disk, select the &iscsi; initiator and click
+          <guimenu>Discover &iscsi; tagets</guimenu>.
+        </para>
+        <para>
+          By default, the file
+          systems will be allocated as new partitions on the selected device. You can change this
+          behavior by clicking the <guimenu>Change</guimenu> in the <guimenu>Actions</guimenu>
+          section. The following space policies are available:
+        </para>
+        <variablelist>
+          <title>Space policies</title>
+          <varlistentry>
+            <term>Delete current content</term>
+            <listitem>
+              <para>
+                All partitions will be removed and any data on the disks will be lost.
+              </para>
+              </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>Shrink existing partitions</term>
+            <listitem>
+              <para>
+                The data is kept, but current partitions will be shrinked as needed.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+             <term>Use available space</term>
+            <listitem>
+              <para>
+                The data is kept. Only the space not assigned to any partition will be used.
+              </para>
+            </listitem>
+          </varlistentry>
+          <varlistentry>
+            <term>Custom</term>
+            <listitem>
+              <para>
+                Select what to do with each partition.
+              </para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+        <para>
+          To edit individual partitions, expand the
+          <guilabel>Partitions and file systems</guilabel> section by clicking on the <guimenu>&gt;</guimenu>
+          Optionally, you can configure Btrfs snapshots, boot options and enable full disk encryption (FDE).
+        </para>
       </step>
       <step performance="optional">
         <para>