summaryrefslogtreecommitdiff
path: root/en/boot-installer/s390.xml
blob: 20bf9899bfb47e2cf5ad0d069dfb0307913f3301 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->

  <sect2 arch="s390"><title>s390 Limitations</title>
<para>

In order to run the installation system a working network setup and
ssh session is needed on S/390.

</para><para>

The booting process starts with a network setup that prompts you for
several network parameters. If the setup is successful, you will login
to the system by starting an ssh session which will launch the
standard installation system.

</para>
  </sect2>


  <sect2 arch="s390"><title>s390 Boot Parameters</title>
<para>

On S/390 you can append boot parameters in the parm file.  This file can
either be in ASCII or EBCDIC format. It needs to be fixed-width with
80 characters per line. A sample parm file
<filename>parmfile.debian</filename> is provided with the installation
images. If a parameter is too long to fit into the 80 characters limit
it can simply be continued in the first column of the next line. All
the lines are concatenated without spaces when being passed to the
kernel.

<!-- Link is bad; commented out for now
Please read
<ulink url="&url-s390-devices;">Device Drivers and Installation Commands</ulink>
for more information about S/390-specific boot parameters.
-->

</para><para>

If you boot the installer in a logical partition (LPAR) or
virtual machine (VM) where a lot of devices are visible, you can
instruct the kernel to restrict the list to a fixed set of devices.
This is advised for the installer's boot process if a lot of disks are
visible, most likely in LPAR mode. The <quote>cio_ignore</quote> option supports both
a blacklist (to only disallow a few devices) and a whitelist (to only
allow specific devices):

<informalexample role="example"><screen>
 # blacklist: just ignore the two devices 300 and 301
 cio_ignore=0.0.0300-0.0.0301
 # whitelist: ignore everything but 1150, FD00, FD01 and FD02
 cio_ignore=all,!0.0.1150,!0.0.fd00-0.0.fd02
</screen></informalexample>

Please note that all devices numbers' hex digits need to be specified in
lower case. Furthermore if this boot parameter is used all devices
need to be listed: this includes at least disks, network devices and
the console. To be considered during the installer's boot process the
above option needs to be added to <filename>parmfile.debian</filename>.

</para>
  </sect2>