|Skip Navigation Links|
|Exit Print View|
|Sun Network QDR InfiniBand Gateway Switch HTML Document Collection for Firmware Version 2.0|
Sets the mkey for the Subnet Manager.
where m_key is a 12-digit hexadecimal number
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 M_Key will fail.
The 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 M_Key functionality or display the current M_Key value respectively.
Note - The same M_Key value must be configured on all Subnet Managers in the InfiniBand fabric. Additionally, you must disable the Subnet Manager before setting the M_Key value, and re-enable the Subnet Manager after setting the M_Key value.
Note - Once the M_Key is configured, the ibportstate command can no longer enable, disable, or reset a port. However, the enableswitchport and disableswitchport commands are still functional.
The setsmmkey command is available from the /SYS/Fabric_Mgmt Linux shell target of the Oracle ILOM CLI interface.
This example shows how to set the M_Key for the Subnet Manager with the setsmmkey command.
# setsmmkey 0xabbababe0001 Current SM settings: smpriority 1 controlled_handover FALSE subnet_prefix 0xfe80000000000000 M_Key 0xabbababe0001 #