9.2.15.1 ahfctl switch

Use the ahfctl switch command to manage manage InfiniBand and RoCE switches.

Syntax

ahfctl switch 
[-h] 
[-configure] 
[-switches SWITCHES] 
[-status] 
[-json] 
[-deconfigure] 
[-debug]

Parameters

Table 9-42 ahfctl switch Command Parameters

Parameter	Description
-configure	Specify to configure InfiniBand and RoCE switches.
-switches SWITCHES	Specify a comma-delimited list of switches to configure. For example: switch1,switch2,switch3
-status	Specify to get configuration details of InfiniBand and RoCE switches.
-json	Specify to get configuration details of InfiniBand and RoCE switches in JSON format.
-deconfigure	Specify to remove configuration details of InfiniBand and RoCE switches from AHF.
-debug	Specify to run the debug script.

Example 9-41 ahfctl switch examples

• To configure InfiniBand and RoCE switches:

  ahfctl switch -configure

• To store configuration details of the switches specified:

  ahfctl switch -configure -switches sw1,sw2,sw3

• To get configuration details of a switch:

  ahfctl switch -status

• To get configuration details of a switch in JSON format:

  ahfctl switch -status -json

• To remove configuration details of a switch from AHF:

  ahfctl switch -deconfigure

If security policies do not permit connection to an InfiniBand switch as the default user root, then specify a different user by setting the RAT_IBSWITCH_USER environment variable:

export RAT_IBSWITCH_USER=user

If security policies do not permit connection to a RoCE switch as the default user admin, then specify a different user by setting the RAT_IBSWITCH_USER environment variable:

export RAT_IBSWITCH_USER=user

Note:

AHF does not discover RoCE switches automatically. You must provide a list of available switches using the RAT_SWITCHES environment variable or while running the ahfctl switch -configure command.

export RAT_SWITCHES="scaqap06sw-roceb1,scaqap06sw-rocea1"

ahfctl switch -configure -switches sw1,sw2,sw3

You can also configure RoCE switches by running the ahfctl switch -configure command without specifying a comma-delimited list of RoCE switches. When you run the ahfctl switch -configure command, AHF will prompt you to enter a comma-delimited list switch names.