Setting devices online or offline

Red Hat Enterprise Linux 8.6 LPAR mode z/VM guest KVM guest

Use the chzcrypt command to set cryptographic devices and AP queues online or offline.

Before you begin

A cryptographic device must be configured for the LPAR before you can set the device or any associated AP queues online in Linux®, see Setting the LPAR configuration status.

Procedure

  • Preferably, use the chzcrypt command with the -e option to set cryptographic devices and AP queues online, or use the -d option to set them offline.
    For example:
    • To set cryptographic devices (in decimal notation) 0, 1, 4, 5, and 12 online issue:
      # chzcrypt -e 0 1 4 5 12
    • To set all available cryptographic devices offline issue:
      # chzcrypt -d -a
  • Alternatively, write 1 to the online sysfs attribute of a cryptographic device to set the device online, or write 0 to set the device offline.
    For example:
    • To set a cryptographic device with device ID 0x3e online issue:
      # echo 1 > /sys/bus/ap/devices/card3e/online
    • To set a cryptographic device with device ID 0x3e offline issue:
      # echo 0 > /sys/bus/ap/devices/card3e/online
    • To check the online status of the cryptographic device with device ID 0x3e issue:
      # cat /sys/bus/ap/devices/card3e/online
      The value is 1 if the device is online or 0 otherwise.