This document you are now reading, in plain ASCII, HTML or PDF format.
Often contains useful information on configuring or using your hardware.
Documentation of S/390-specific boot sequence, commands and device drivers (e.g. DASD, FCP, QETH (OSA, HiperSockets), Console and z/VM interaction)
IBM Redbook describing how Linux can be combined with z/VM on zSeries and S/390 hardware.
IBM Redbook describing the Linux distributions available for the mainframe. It has no chapter about Ubuntu but the basic installation concepts are the same across all S/390 distributions.
In many cases, the installer will be able to automatically detect your hardware. But to be prepared, we do recommend familiarizing yourself with your hardware before the install.
Hardware information can be gathered from:
The manuals that come with each piece of hardware.
The Hardware Management Console (HMC) and the Support Element (SE). You either need physical access to these sytems or one needs to enable the remote access. Special privileges are usually needed for the HMC and SE access - you may need to consult your system administrator / system programmer. Epsecially the Activation Profile for LPARs the and user direct (for z/VM guests) provide information about physical and virtual hardware.
The cases and boxes for each piece of hardware.
System commands or tools in another operating system, including file manager displays. This source is especially useful for information about RAM and hard drive memory.
Your system administrator, network administrator or Internet Service Provider. These sources can tell you the settings you need to set up your networking and e-mail.
Table 3.1. Hardware Information Helpful for an Install
Hardware | Information You Might Need |
---|---|
DASD Storage | Device number(s). |
Available free space. | |
FCP Storage | FCP host (bus) adapter(s). |
WWPN (16 digit). | |
LUN(s) (16 digit). | |
QETH Network | Type of adapter. |
Device numbers. | |
Relative adapter number for OSA cards (Port number). |
Many products work without trouble on Linux. Moreover, hardware support in Linux is improving daily. However, Linux still does not run as many different types of hardware as some operating systems.
Drivers in Linux in most cases are not written for a certain “product” or “brand” from a specific manufacturer, but for a certain hardware/chipset. Many seemingly different products/brands are based on the same hardware design; it is not uncommon that chip manufacturers provide so-called “reference designs” for products based on their chips which are then used by several different device manufacturers and sold under lots of different product or brand names.
This has advantages and disadvantages. An advantage is that a driver for one chipset works with lots of different products from different manufacturers, as long as their product is based on the same chipset. The disadvantage is that it is not always easy to see which actual chipset is used in a certain product/brand. Unfortunately sometimes device manufacturers change the hardware base of their product without changing the product name or at least the product version number, so that when having two items of the same brand/product name bought at different times, they can sometimes be based on two different chipsets and therefore use two different drivers or there might be no driver at all for one of them.
For PCI-Express/PCIe devices, a good way to find out on which chipset they are based is to look at their device IDs. All PCI-Express/PCIe devices have so called “vendor” and “product” IDs, and the combination of these two is usually the same for any product based on the same chipset. The traditional s390x I/O layer provides CCW (Channel Command Word) devices, which are DASDs disks, FCP disks and QETH devices (OSA adapters or Hipersockets).
On Linux systems, the devices and their IDs can be read using:
lszdev command for CCW devices
lspci -nn command for PCI-Express/PCIe devices
The vendor and product IDs (if available) are usually given in the form of two hexadecimal numbers, seperated by a colon, such as “1d6b:0001”.
An example for the output of lszdev:
dasd-eckd 0.0.160a yes yes dasdb
qeth 0.0.c000:0.0.c001:0.0.c002 yes yes enc600
zfcp-host 0.0.e000 yes yes
zfcp-lun 0.0.e000:0x54320763060b160b:0x4044400200000000 yes yes sda sg1
Whereby 160a indicated an ECKD DASD disk, c000 or the triple c000-c002 a QETH network device (OSA adapter) and e000 and FCP host (bus) adapter, with a WWPN 0x54320763060b160b and LUN 0x4044400200000000.
An example for the output of lspci -nn for a RoCE Express adapter:
0001:00:00.0 Ethernet controller [0200]: Mellanox Technologies MT27500/MT27520 Family [ConnectX-3/ConnectX-3 Pro Virtual Function] [15b3:1004]
.
The IDs are given inside the rightmost square brackets, i.e. here 15b3 is the vendor- and 1004 is the product ID.
Searching on the internet with the vendor/product ID, “Linux” and “driver” as the search terms often results in information regarding the driver support status for a certain chipset. If a search for the vendor/product ID does not yield usable results, a search for the chip code names, which are also often provided by lspci , can help.
If your computer is connected to a fixed network (i.e. an Ethernet or equivalent connection) which is administered by somebody else, you should ask your network's system administrator for this information:
Your host name (you may be able to decide this on your own).
Your domain name.
Your computer's IP address.
The netmask to use with your network.
The IP address of the default gateway system you should route to, if your network has a gateway.
The system on your network that you should use as a DNS (Domain Name Service) server.
If the system is connected to a VLAN trunk port the VLAN Id is needed.
To display the VLAN configuration settings, the debian-installer's debconf priority needs to be switched from high (default) to medium.
If the network you are connected to uses DHCP (Dynamic Host Configuration Protocol) for configuring network settings, you don't need this information because the DHCP server will provide it directly to your computer during the installation process.