22.6.2.2. Working With the QETH Device Driver

The QETH network device driver supports IBM System z HiperSockets, OSA-Express Fast Ethernet, Gigabit Ethernet (including 1000Base-T), High Speed Token Ring, and ATM features (running Ethernet LAN emulation) in QDIO mode.

Based on the type of interface being added, the QETH driver assigns one of three base interface names:

hsin for HiperSocket devices
ethn for OSA-Express Fast Ethernet and Gigabit Ethernet
trn for Token Ring

The value n is an integer that uniquely identifies the device. n is 0 for the first device of that type, 1 for the second, and so on.

Load the device driver:
```
# modprobe qeth
```

Create the group device:

# echo read_device_bus_id,write_device_bus_id,data_device_bus_id >
/sys/bus/ccwgroup/drivers/qeth/group

Due to the length of this command, it has been broken into two lines.

Configure the device.

For more information about configuration of the QETH driver, refer to the following:

http://oss.software.ibm.com/developerworks/opensource/linux390/docu/lx26apr04dd01.pdf (Linux for IBM System z and S/390 Device Drivers, Features, and Commands)

Set the device online:

# echo 1 > /sys/bus/ccwgroup/drivers/qeth/read_device_bus_id/online

Define the alias.

Based on the type interface being added, add a line to /etc/modprobe.conf that is like one of the following:
```
hsin alias qeth
ethn alias qeth
trn alias qeth
```

Create a configuration script.

Create a file in /etc/sysconfig/network-scripts/ with a name like one of the following:

ifcfg-hsin 
ifcfg-ethn
ifcfg-trn

The file should look like this:

/etc/sysconfig/network-scripts/ifcfg-eth0
# IBM QETH
DEVICE=eth0
BOOTPROTO=static
HWADDR=00:06:29:FB:5F:F1
IPADDR=9.12.20.136
NETMASK=255.255.255.0
ONBOOT=yes
NETTYPE=qeth
SUBCHANNELS=0.0.09a0,0.0.09a1,0.0.09a2
TYPE=Ethernet

Based on the type interface being added, the DEVICE parameter should be like one of the following:

DEVICE=hsin
DEVICE=ethn
DEVICE=trn

Activate the device.

Based on the type interface being added, issue an ifup command:
```
# ifup hsin
# ifup ethn
# ifup trn
```