F.6.2.2. Working With the QETH Device Driver

The QETH network device driver supports zSeries 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:

hsi<n> for HiperSocket devices
eth<n> for OSA-Express Fast Ethernet and Gigabit Ethernet
tr<n> 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 zSeries and S/390 Device Drivers, Features, and Commands)

Set the device online:

# echo 1 /sys/bus/ccwgroup/drivers/qeth/<read_device_bus_id>/nline

Define the alias.

Based on the type interface being added, add a line to /etc/modprobe.conf that is like one of the following:
```
hsi<n> alias qeth
eth<n> alias qeth
tr<n> alias qeth
```

Create a configuration script.

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

ifcfg-hsi<n> 
ifcfg-eth<n>
ifcfg-tr<n>

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=hsi<n>
DEVICE=eth<n>
DEVICE=tr<n>

Activate the device.

Based on the type interface being added, issue an ifup command:
```
# ifup hsi<n>
# ifup eth<n>
# ifup tr<n>
```