ahfctl switch

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.

Parent topic: Running AHFCTL Commands to Manage InfiniBand and RoCE Switches