Skip to content

Commit

Permalink
Z WIP
Browse files Browse the repository at this point in the history
  • Loading branch information
@cwickert
cwickert committed Feb 25, 2025
1 parent e44ec2a commit e3d57b3
Showing 1 changed file with 91 additions and 23 deletions.
114 changes: 91 additions & 23 deletions tasks/agama-manual-installation.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@
[
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
%entities;
<!ENTITY install.iso "SLES-16.0-<phrase xmlns='http://docbook.org/ns/docbook' arch='power'>ppc64le</phrase><phrase arch='zseries'>s390x</phrase><phrase arch='x86_64'>x86_64</phrase>-Beta1.install.iso">
<!ENTITY packages.iso "SLES-Packages-16.0-<phrase xmlns='http://docbook.org/ns/docbook' arch='power'>&ppc64le;</phrase><phrase arch='zseries'>s390x</phrase><phrase arch='x86_64'>x86_64</phrase>-Beta1.iso">
]>
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
<!-- point back to this document with a similar comment added to your legacy doc piece -->
Expand Down Expand Up @@ -64,11 +66,13 @@
</para>
<procedure>
<title>Manual installation of &sle; using &agama;</title>

<!-- s390x-specific steps -->
<step arch="power">
<para>
Copy the ISO image to the VIOS server:
</para>
<screen>&prompt.user;<command>scp</command> <filename>SLES-16.0-ppc64le-Beta1.install.iso</filename> padmin@<replaceable>VIOS_SERVER</replaceable></screen>
<screen>&prompt.user;<command>scp</command> <filename>&install.iso;</filename> padmin@<replaceable>VIOS_SERVER</replaceable></screen>
<para>
Replace <replaceable>VIOS_SERVER</replaceable> with the hostname or IP address of your
VIOS server.
Expand All @@ -79,7 +83,7 @@
Create a virtual optical device and load the ISO in the virtual device at the VIOS
server:
</para>
<screen><prompt>(VIOS)$</prompt> <command>mkvopt</command> -name sles16-offline -file SLES-16.0-ppc64le-Beta1.install.iso -ro
<screen><prompt>(VIOS)$</prompt> <command>mkvopt</command> -name sles16-offline -file <filename>&install.iso;</filename> -ro
<prompt>(VIOS)$</prompt> <command>loadopt</command> -f -release -disk sles16-offline -vtd <replaceable>vcdXY</replaceable></screen>
<para>
Replace <replaceable>vcdXY</replaceable> with your virtual device unit attached to the
Expand Down Expand Up @@ -219,7 +223,7 @@
</step>
</substeps>
</step>
<step arch="power;zseries">
<step arch="power">
<para>
Log into the console to get the root password and IP address.
</para>
Expand All @@ -229,8 +233,7 @@
Select <guimenu>agama&dash;installer</guimenu> and press
<keycap function="enter"/> to boot the machine.
</para>
<!-- FIXME: cwickert 2025-02-25: we need a s390x version of this file.-->
<informalfigure arch="power">
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Pre&dash;installation boot menu</phrase>
</textobject>
Expand All @@ -247,8 +250,7 @@
<para>
When booting finishes, the IP address and root password are displayed.
</para>
<!-- FIXME: cwickert 2025-02-25: we need a s390x version of this file.-->
<informalfigure arch="power">
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Pre&dash;installation boot menu</phrase>
</textobject>
Expand All @@ -263,26 +265,90 @@
</step>
</substeps>
</step>
<step os="power;zeries">
<!-- End of s390-specific steps -->

<!-- Z Series steps-->
<step arch="zseries">
<para>
Open a browser pointing to the given URL in the console. Insert the
root password and proceed with the installation.
Download &install.iso; <filename>&install.iso;</filename> and mount it:
</para>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Pre&dash;installation boot menu</phrase>
</textobject>
<imageobject role="fo">
<imagedata fileref="agama-installation-sles-ppc-boot-confirm.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="agama-installation-sles-ppc-boot-confirm.png" width="100%"/>
</imageobject>
</mediaobject>
</informalfigure>
<screen>&prompt.sudo;<command>mount</command> -o loop <filename>&install.iso;</filename> ./install/agama/</screen>
</step>
<step arch="zseries" performance="optional">
<para>
For installation in an air-gapped environment or without registration, also
download <filename>&packages.iso;</filename> and mount it.
</para>
<screen>&prompt.sudo;<command>mount</command> -o loop <filename>&packages.iso;</filename> ./install/agama-offline/install/</screen>
</step>
<step arch="zseries">
<para>
Use the following parmfile to start the installation:
</para>
<example>
<title>Example parmfile</title>
<screen>root=live:ftp://10.144.55.15<co xml:id="co-parmfile-source"/>/install/online.iso
ip=10.144.136.2<co xml:id="co-parmfile-ip"/>::10.144.136.254:24<co xml:id="co-parmfile-gw"/>:SLE16-Beta1:enc800:none
rd.zdev=qeth,0.0.0800:0.0.0801:0.0.0802,layer2=1,portno=0
cio_ignore=all,!condev,!0.0.0160 nameserver=10.144.53.53<co xml:id="co-parmfile-dns"/>
live.password=linux<co xml:id="co-parmfile-pw"/> rd.zdev=dasd,0.0.0160</screen>
</example>
<para>
Adjust your network configuration accordingly.
</para>
<calloutlist>
<callout arearefs="co-parmfile-source">
<para>
IP address of the FTP server that holds the installer ISO
</para>
</callout>
<callout arearefs="co-parmfile-ip">
<para>
IP address of the system you install
</para>
</callout>
<callout arearefs="co-parmfile-gw">
<para>
IP address of the gateway for the system
</para>
</callout>
<callout arearefs="co-parmfile-dns">
<para>
IP address the DNS server for the system
</para>
</callout>
<callout arearefs="co-parmfile-pw">
<para>
installation password.
</para>
</callout>
<callout arearefs="co-parmfile-source">
<para>
</para>
</callout>
</calloutlist>
</step>
<step performance="optional">
<para>
For installation in an air-gapped environment or without registration, add
<literal>agama.install_url</literal> to the parmfile.
</para>
<screen>root=live:ftp://<replaceable>10.144.55.15</replaceable>/install/online.iso
agama.install_url=ftp://<replaceable>10.144.55.15</replaceable>/install/agama-offline/install
ip=<replaceable>10.144.136.2::10.144.136.254:24:SLE16-Beta1:enc800:none</replaceable>
rd.zdev=qeth,0.0.0800:0.0.0801:0.0.0802,layer2=1,portno=0
cio_ignore=all,!condev,!0.0.0160 nameserver=<replaceable>10.144.53.53</replaceable>
live.password=linux rd.zdev=dasd,0.0.0160</screen>
</step>
<step>
<para>
Open a browser pointing to the given URL in the console. Insert the
root password and proceed with the installation.
</para>
</step>
<!-- End of Z Series steps -->


<!-- Begin x_86_64 steps -->
<step arch="x86_64">
<para>
Select a bootable media and start the installation process.
Expand Down Expand Up @@ -318,6 +384,8 @@
</mediaobject>
</informalfigure>
</step>
<!-- End of x86_64 steps -->

<step>
<para>
Select the product that you want to install, accept the license and click
Expand Down

0 comments on commit e3d57b3

Please sign in to comment.