Product SiteDocumentation Site

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:
  1. 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
  2. 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.
  3. Set the DEVICE parameter as follows:
    DEVICE=ethn
  4. 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:
  1. 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
  2. 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