Disable Hardware Components

How to use the xtcli command to disable physical system components.

If links, nodes, or Cray ASICs have hardware problems, the system administrator can direct the system to ignore the components with the xtcli disable command.

By default, when disabling a component, this command takes into consideration the hierarchy of components, performs the action upon the identified component(s) and cascades that action to any subcomponent of the identified component(s), unless the -n option is specified.

The xtcli disable command has the following form, where idlist is a comma-separated list of components (in cname format) that the system is to ignore. The system disregards these links or nodes.
xtcli disable [{-t type [-a] } | -n] [-f] idlist
Important: The -n option with the xtcli disable command must be used carefully because this may create invalid system state configurations.

Disabling of a cabinet, chassis, or blade will fail if any nodes under the component are in the ready state, unless the force option (-f) is used. An error message will indicate the reason for the failure.

Disabling of a node in the ready state will fail, unless the force option (-f) is used. An error message will indicate the reason for the failure.

The state of empty components will not change when using the disable command, unless the force option (-f) is used.

For detailed information about using the xtcli disable command, see the xtcli(8) man page.

Disable the Aries ASIC c0-0c1s3a0

  1. Determine that the ASIC is in the OFF state. 
    crayadm@smw> xtcli status -t aries c0-0c1s3a0
  2. If the ASIC is not in the OFF state, power down the blade that contains the ASIC.
    crayadm@smw> xtcli power down c0-0c1s3
  3. Disable the ASIC.
    crayadm@smw> xtcli disable c0-0c1s3a0
  4. Power up the blade that contains the ASIC.
    crayadm@smw> xtcli power up c0-0c1s3