1.5. Installing under z/VM
Log onto z/VM as the Linux guest account. You can use x3270 or c3270 (from the x3270-text package in Red Hat Enterprise Linux) to log in to z/VM from other Linux systems. Alternatively, use the OS/2 3270 terminal emulator on the S/390 management console. If you are working from a Windows based machine, Jolly Giant (http://www.jollygiant.com/) offers an SSL-enabled 3270 emulator.
If you are not in CMS mode, enter it now.
i cms |
If necessary, add the device containing z/VM's TCP/IP tools to your CMS disk list. For example:
vmlink tcpmaint 592 592 |
If using any of the qdio/qeth based network connection types (such as OSA express or hipersockets), set the VM guest qioassist parameter off:
set qioassist off |
FTP to the machine containing the Red Hat Enterprise Linux boot images (kernel.img and initrd.img), log in, and execute the following commands (use the (repl option if you are overwriting existing kernel.img and initrd.img image files):
cd /location/of/boot/images/
locsite fix 80
bin
get kernel.img (repl
get initrd.img (repl
ascii
get redhat.parm (repl
quit
You may now create the parameter file (for example, redhat.parm). Refer to Appendix B Sample Parameter Files for sample parm files. Below is an explanation of the parm file contents.
There is a limit of 32 total parameters in the parameter file. In order to accommodate limitations with parameter files, a new configuration file on a CMS DASD should be used to configure the initial network setup and the DASD specification.
A .parm file is still required for the real kernel parameters, such as root=/dev/ram0 ro ip=off ramdisk_size=40000, and single parameters which are not assigned to variables, such as vnc. Two new parameters which point the installation program at the new configuration file need to be added to the .parm file:
CMSDASD=191 CMSCONFFILE=redhat.conf |
CMSDASD is the device ID of the CMS formatted DASD which contains the configuration file. CMSDASD is usually the '$HOME' DASD 191 of the mainframe user. The name of the configuration file must be set with CMSCONFFILE and needs to be all lowercase.
The syntax of the CMSCONFFILE is bash style with variable="value" pairs, one on each line.
Example redhat.parm file:
root=/dev/ram0 ro ip=off ramdisk_size=40000 CMSDASD=191 CMSCONFFILE=redhat.conf vnc |
Example redhat.exec file:
/* */ 'cl rdr' 'purge rdr all' 'spool punch * rdr' 'PUNCH KERNEL IMG A (NOH' 'PUNCH REDHAT PARM A (NOH' 'PUNCH INITRD IMG A (NOH' 'ch rdr all keep nohold' 'i 00c' |
Example redhat.conf file:
HOSTNAME="foobar.zSeries.example.com" DASD="200-203" NETTYPE="qeth" IPADDR="192.168.17.115" SUBCHANNELS="0.0.0600,0.0.0601,0.0.0602" PORTNAME="FOOBAR" NETWORK="192.168.17.0" NETMASK="255.255.255.0" BROADCAST="192.168.17.255" SEARCHDNS="example.com:zSeries.example.com" GATEWAY="192.168.17.254" DNS="192.168.17.1" MTU="4096" |
The following parameters are required and must be included in the parameter file:
DASD=<dasd-list>
Where <dasd-list> represents the list of DASD devices to be used by Red Hat Enterprise Linux.
Although autoprobing for DASDs is done if this parameter is omitted, it is highly recommended to include the DASD= parameter, as the device numbers (and therefore the device names) can vary when a new DASD is added to the Red Hat Enterprise Linux guest. This can result in an unusable system.
root=<file-system>
where <file-system> represents the device on which the root file system can be found. For installation purposes, it should be set to /dev/ram0, which is the ramdisk containing the Red Hat Enterprise Linux installation program.
The following parameters are required to set up networking:
SUBCHANNELS=
Provides required device bus IDs for the various network interfaces.
qeth: SUBCHANNELS="<read_device_bus_id>,<write_device_bus_id>, <data_device_bus_id>" lcs: SUBCHANNELS="<read_device_bus_id>,<write_device_bus_id>" ctc: SUBCHANNELS="<read_device_bus_id>,<write_device_bus_id>"
For example (a sample qeth SUBCHANNEL statement):
SUBCHANNELS=0.0.0600,0.0.0601,0.0.0602
To force a specific CTC protocol, additionals parameters can be added. For example:
CTCPROT=<n>
Where <n> is one of the following:
· 0 for compatibility mode (used with non-Linux peers other than S/390 and zSeries operating systems)
· 1 for extended mode
· 2 for CTC-based tty (only supported on Linux-to-Linux connections)
· 3 for compatibility mode with S/390 and zSeries operating systems
PEERID=<userid>
Where <userid> represents the ID of the guest machines you want to connect to. Note that the ID must be written in capital letters. For example, a PEERID connection to a z/VM TCP/IP service machine should be written as:
PEERID=TCPIP
Note that the PEERID parameter replaces the IUCV parameter used with the Linux kernel version 2.4.
The following parameters are optional:
HOSTNAME=<string>
Where <string> is the hostname of the newly-installed Linux guest.
NETTYPE=<type>
Where <type> must be one of the following: ctc, iucv, lcs, or qeth.
IPADDR=<IP>
Where <IP> is the IP address of the new Linux guest.
NETWORK=<network>
Where <network> is the address of your network.
NETMASK=<netmask>
Where <netmask> is the netmask.
BROADCAST=<broadcast>
Where <broadcast> is the broadcast address.
GATEWAY=<gw>
Where <gw> is either the gateway-IP for your eth device or the IP address of the ctc/escon/iucv point-to-point partner.
MTU=<mtu>
Where <mtu> is the Maximum Transmission Unit (MTU) for this connection.
DNS=<server1>:<server2>:…:<serverN>
Where <server1>:<server2>:…:<serverN> is a list of DNS servers, separated by colons. For example:
DNS=10.0.0.1:10.0.0.2
SEARCHDNS=<domain1>:<domain2>:…:<domainN>
Where <domain1>:<domain2>:…:<domainN> is a list of the search domains, separated by colons. For example:
SEARCHDNS=example.com:example.org
PORTNAME=<osa_portname> | <lcs_portnumber>
This variable supports OSA devices operating in qdio mode or non-qdio mode.
When using qdio mode: <qeth_portname> is the portname specified on the OSA device when operating in qeth mode. PORTNAME is only required for z/VM 4.3 or older without APARs VM63308 and PQ73878.
When using non-qdio mode: <lcs_portnumber> is used to pass the relative port number as integer in the range of 0 through 15.
FCP_<n>="<device_number> <SCSI_ID> <WWPN> <SCSI_LUN> <FCP_LUN>"
The variables can be used on systems with FCP devices to preconfigure the FCP setup and can be subsequently edited in anaconda during the installation. An example value may look similar to:
FCP_1="0.0.5000 0x01 0x5105074308c212e9 0x0 4010"
<n> is an integer value (e.g. FCP_1, FCP_2, ...).
<device_number> is used to specify the address of the FCP device ( 0.0.5000 for device 5000, for example).
<SCSI_ID> is specified in hex-value, typically sequential values (e.g. 0x01, 0x02 ... ) are used over multiple FCP_ variables.
<WWPN> is the world wide port name used for routing (often in conjunction with multipathing) and is as a 16-digit hex value (e.g. 0x5105074308c212e9).
<SCSI_LUN> refers to the local SCSI logical unit value and is specified as a hex-value, typically sequential values (e.g. 0x00, 0x01, ...) are used over multiple FCP_ variables.
<FCP_LUN> refers to the storage logical unit identifier and is specified as a hex-value (such as 0x4010).
Note Each of the values used in the FCP parameters (FCP_1, FCP_2, ...) are site-specific and are normally supplied by the FCP storage administrator.
The following parameter for kickstart installations is optional:
RUNKS=<value>
Where <value> is defined as 1 if you want to run the installation program in noninteractive mode in the 3270 terminal, or 0 otherwise.
Note Make sure that your kickstart file contains all required parameters before you use this option.
If any of the network parameters required to make the network operate correctly are omitted from the parm file, a prompt appears during the installation boot process.
If you logged off, reconnect and log in using z/VM guest ID you configured for installation. If you are not in CMS mode, enter it now.
i cms |
Create an executable script containing the commands necessary to IPL the kernel image and start the installation. The following sample script is a typical initial start-up script:
/* */ 'CL RDR' 'PURGE RDR ALL' 'SPOOL PUNCH * RDR' 'PUNCH KERNEL IMG A (NOH' 'PUNCH REDHAT PARM A (NOH' 'PUNCH INITRD IMG A (NOH' 'CH RDR ALL KEEP NOHOLD' 'IPL 00C CLEAR' |
The initial installation start-up script prompts you for information about your networking and DASDs unless you have specified all necessary information in the parm file.
Once all questions have been answered, you are ready to begin the core installation program, loader. To continue with the installation, refer to Chapter 2 Installing Red Hat Enterprise Linux for further instructions.