uplink (management module failover) command

This command displays and configures the management-module uplink failover feature. If the external network interface of the primary management module fails, this feature forces a failover to the standby management module, if one is installed.

Note: This command does not apply to the BladeCenter S unit.
Table 1. uplink command
Function What it does Command Valid targets
Display uplink failover status Displays the management-module uplink failover status (enabled or disabled) and the failover delay. uplink
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set physical network uplink failover delay Sets the amount of time between detection of a management-module physical uplink failure and failover to the standby management module. uplink -dps delay

where delay is from 10 to 172800 seconds, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Enable / disable physical uplink failover Enables or disables failover to the standby management module if the external physical network interface of the primary management module fails. uplink -ep state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set logical network uplink failover delay Sets the amount of time between detection of a management-module logical uplink failure and failover to the standby management module. uplink -dls delay

where delay is from 60 to 172800 seconds, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Enable / disable logical uplink failover Enables or disables failover to the standby management module if the external logical network interface of the primary management module fails.

You must enter a non-zero IP address (-ip command option) or IPv6 IP address (-ip6 command option) for a device that the management module can access to check its logical network link before you can enable logical uplink failover.

uplink -el state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set IP address to check logical network uplink Sets the IPv4 IP address of the device that the management module accesses to check its logical network link. uplink -ip ip_address

where ip_address is a valid IPv4 IP address. You must enter a non-zero IPv4 IP address, in dotted decimal IP address format, before you can enable logical uplink failover.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set IPv6 IP address to check logical network uplink Sets the IPv6 IP address of the device that the management module accesses to check its logical network link. uplink -ip6 ip_address

where ip_address is a valid IPv6 IP address. You must enter a non-zero IP address, in IPv6 format, before you can enable logical uplink failover.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set logical link loss alert and failover policy Sets the alert and failover policy for logical link loss to check either the IPv4 IP address, the IPv6 IP address, or both of these IP addresses.
Note: The -alert command option applies only when both the -ip and -ip6 command options are set.
uplink -alert setting
where setting is:
  • either to check either the IPv4 IP address or the IPv6 IP address.
  • both to check both the IPv4 IP address and the IPv6 IP address.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system
                        
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Example: To enable failover to the standby management module if the external physical network interface of a primary management module fails, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  uplink -ep enabled
               
To display the uplink failover configuration, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  uplink
               

The following example shows the information that is returned from these commands:

               system:mm[1]> uplink -ep enabled
OK
system:mm[1]> uplink
Failover on network uplink loss is enabled for physical detection
Uplink delay for physical detection: 60 seconds
 
Failover on network uplink loss is enabled for logical detection
Uplink delay for logical detection: 1800 seconds
Destination IP for MM to check its logical link: 1.1.1.0
Destination IPv6 IP for MM to check its logical link: 1::2
Alert and failover if both IPv4 and IPv6 link checks fail
system:mm[1]>