setsmmkey Command

Sets the readable M_Key for the Subnet Manager.

Syntax

setsmmkey m_key|none|list

where m_key is a 12-digit hexadecimal number

Description

This hardware command adds an extra layer of security to administering the Subnet Managers of the InfiniBand fabric. The Management Key (M_Key) is a 48-bit value that is used like a password to authorize access to the Subnet Manager Agent, thereby regulating control of the HCAs, switches, and other InfiniBand devices within the fabric. Any attempt to initialize or configure an InfiniBand node without the correct readable M_Key will fail.

The readable M_Key provides for two specific security features:

• Any unauthorized host-based Subnet Manager cannot assume control of the InfiniBand fabric.

• Prevents unauthorized modification of the Subnet Manager Agent from outside of the Subnet Manager.

The none and list arguments of the setsmmkey command disable the readable M_Key functionality or display the current readable M_Key value respectively.

The setsmmkey command is available from the /SYS/Fabric_Mgmt Linux shell target of the Oracle ILOM CLI interface.

Example

This example shows how to set the readable M_Key for the Subnet Manager with the setsmmkey command.

FabMan@switch_name->setsmmkey 0xabbababe0001
Current SM settings:
smpriority 1
controlled_handover FALSE
subnet_prefix 0xfe80000000000000
M_Key 0xabbababe0001
Routing engine FatTree
FabMan@switch_name->

Related Information

• disablesm Command

• enablesm Command

• Linux Shells for Hardware Commands