Setup FCP device(s) for agent node of storage provider

If you use the boot from volume feature to deploy virtual machines on persistent storage via Fibre Channel Protocal in the IBM® Cloud Infrastructure Center, one or more FCP devices need to be allocated and enabled on the agent node of storage provider. It is used to attach the target root volume to the agent node of storage provider to deploy the specified image onto this target volume.

Using KVM LPAR linux as the agent node of storage provider

If the agent node of a storage provider is one KVM compute node, the FCP devices must be defined in the KVM LPAR definition.

Then you can SSH onto the agent node of the storage provider and use the following command to online the FCP devices:

chzdev zfcp-host <FCP devices> -e -a -p

Where:

  • <FCP devices>: are the FCP device(s) assigned to the agent node of storage provider, separated by space character.

Finally ensure the port_state is Online for each FCP device with the following command:

[root@agentnode ~]# systool -c fc_host -v | egrep "Class Device path|port_state"
Class Device path = "/sys/devices/css0/0.0.0001/0.0.1a00/host0/fc_host/host0"
   port_state          = "Online"
Class Device path = "/sys/devices/css0/0.0.0000/0.0.1b00/host1/fc_host/host1"
   port_state          = "Online"
[root@agentnode ~]#

Using z/VM virtual machine as the agent node of storage provider

If the agent node of a storage provider is one of the z/VM compute nodes, refer to the following steps to setup the FCP device(s).

Note:

  • The FCP devices used for the agent node of the storage provider must not be included in any of the FCP multipath templates created for the compute node.

  1. Dedicate and attach the FCP device(s) to the agent node of storage provider by using corresponding DIRMAINT commands or executing the following smcli commands on the compute node of the same z/VM system:

    smcli Image_Device_Dedicate_DM -T <userid> -v <fcp> -r <fcp> -R 0
    smcli Image_Device_Dedicate -T <userid> -v <fcp> -r <fcp> -R 0

    Where:

    • <userid>: is the userid of the the agent node of the storage provider.

    • <fcp>: is the FCP device to be used by the the agent node of the storage provider.

    These steps are required to be done for each FCP device.

    Note:

    Make sure the FCP device(s) are dedicated to the user ID definition of the agent node of the storage provider, otherwise the FCP device(s) maybe lost after the agent node of the storage provider restarts. For example, the following two entries should be included in the user ID definition of the agent node of the storage provider when the FCP devices to be used are 5C40 and 5D40:

    DEDICATE 5C40 5C40
    DEDICATE 5D40 5D40
  2. SSH onto the agent node of the storage provider and use the following command to update configuration:

    chzdev zfcp-host <FCP devices> -e -a -p

    Where:

    • <FCP devices>: are the FCP device(s) assigned to the agent node of storage provider, separated by space character. The FCP device(s) need to be different from the ones added for the compute node.

    Following is an example for this commad:

     [root@agentnode ~]# chzdev zfcp-host 5c02 5d02 -e -a -p
     FCP device 0.0.5c02 configured
     FCP device 0.0.5d02 configured
  3. Verify the FCP device(s) are setup successfully by checking the port_state is Online with the following command on the agent node of the storage provider:

    [root@agentnode ~]# systool -c fc_host -v | egrep "Class Device path|port_state"
    Class Device path = "/sys/devices/css0/0.0.0001/0.0.5c02/host0/fc_host/host0"
       port_state          = "Online"
    Class Device path = "/sys/devices/css0/0.0.0000/0.0.5d02/host1/fc_host/host1"
       port_state          = "Online"
    [root@agentnode ~]#