uplink command

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

Note: If an Flex System Enterprise Chassis is set up for redundant CMM operation and both CMMs experience an unrecoverable failure, the chassis will attempt to switch control between the CMMs indefinitely. If this condition occurs, replace one CMM to return the chassis to operation or replace both CMMs to return the chassis to redundant operation. Depending on how each CMM failed, you might need to configure the replacement CMM or restore its configuration from a backup, if one is available. A failure of both CMMs might be an indication of other problems with the Flex System Enterprise Chassis; make sure that the chassis is operating properly before replacing either CMM. See Troubleshooting chassis for information about diagnosing problems with a Flex System Enterprise Chassis.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or uplink command errors for a list of error messages that are specific to the uplink command.

Table 1. uplink command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display uplink failover status Displays the CMM uplink failover status (enabled or disabled) and the failover delay. uplink
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set physical network uplink failover delay Sets the amount of time between detection of a CMM physical uplink failure and failover to the standby CMM. 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable physical uplink failover Enables or disables failover to the standby CMM if the external physical network interface of the primary CMM 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set logical network uplink failover delay Sets the amount of time between detection of a CMM logical uplink failure and failover to the standby CMM. 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable logical uplink failover Enables or disables failover to the standby CMM if the external logical network interface of the primary CMM fails.

Failure is indicated when all of the following conditions occur:

  • Loss of CMM eth0 input and output packets
  • Network noise
  • Failures when pinging the CMM gateway and a designated station

You must enter a non-zero IPv4 IP address (-ip command option) and a non-zero IPv6 IP address (-ip6 command option) for a device that the CMM 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set IP address to check logical network uplink Sets the IPv4 IP address of the device that the CMM 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set IPv6 IP address to check logical network uplink Sets the IPv6 IP address of the device that the CMM accesses to check its logical network link. uplink -ip6 ip_address

where ip_address is a valid, non-zero, IPv6 IP address. You must enter a non-zero IPv6 IP address 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM 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.
  • Both IP addresses are non-zero.
  • IPv6 is enabled using the ifconfig command.
 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.
Flex System Enterprise Chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Example: To set the IPv4 IP address of the device that the CMM accesses to check its logical network link to 9.72.220.180 and the IPv6 IP address of this device to 1111::2222, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type 
uplink -ip 9.72.220.180 -ip6 1111::2222
To set the alert and failover policy for logical link loss to check for failures of both the IPv4 IP address and the IPv6 IP address, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type 
uplink -alert both
To enable logical link loss failover to the standby CMM if the external logical network interface of the primary CMM fails, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type 
uplink -el enabled
To display the uplink failover configuration, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type 
uplink

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

system:mm[2]> uplink -ip 9.72.220.180 -ip6 1111::2222
OK
system:mm[2]> uplink -alert both
OK
system:mm[2]> uplink -el enabled
OK
system:mm[2]> uplink
Failover on network uplink loss is disabled 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: 9.72.220.180
Destination IPv6 IP for MM to check its logical link: 1111::2222
Alert and failover if both IPv4 and IPv6 link checks fail
system:mm[2]>
Parent topic: Command reference