25.3.2.2. Persistently adding an LCS device

Cio_ignore is handled transparently for persistent device configurations and you do not need to free devices from the ignore list manually.

To add an LCS device persistently, follow these steps:

Create a configuration script as file in /etc/sysconfig/network-scripts/ with a name like ifcfg-ethn where n is an integer starting with 0. The file should look similar to the following:

/etc/sysconfig/network-scripts/ifcfg-eth0
# IBM LCS
DEVICE=eth0
BOOTPROTO=static
IPADDR=10.12.20.136
NETMASK=255.255.255.0
ONBOOT=yes
NETTYPE=lcs
SUBCHANNELS=0.0.09a0,0.0.09a1
PORTNAME=0
OPTIONS=''
TYPE=Ethernet

Modify the value of PORTNAME to reflect the LCS port number (portno) you would like to use. You can add any valid lcs sysfs atttribute and its value to the optional OPTIONS parameter. Refer to Section 25.3.1.3, “Persistently adding a qeth device” for the syntax.
Set the DEVICE parameter as follows:
```
DEVICE=ethn
```
Issue an ifup command to activate the device:
```
# ifup ethn
```

Changes to an ifcfg file only become effective after rebooting the system. You can trigger the activation of a ifcfg file for network channels by executing the following commands:

Use the cio_ignore command to remove the LCS device adapter from the list of ignored devices and make it visible to Linux:
```
# cio_ignore -r read_device_bus_id,write_device_bus_id
```
Replace read_device_bus_id and write_device_bus_id with the device bus IDs of the LCS device. For example:
```
# cio_ignore -r 0.0.09a0,0.0.09a1
```

To trigger the uevent that activates the change, issue:

echo add > /sys/bus/ccw/devices/read-channel/uevent

For example:

echo add > /sys/bus/ccw/devices/0.0.09a0/uevent