configure stacking alternate-ip-address

configure stacking alternate-ip-address [ipaddress netmask | ipNetmask] gateway automatic configure stacking [node-address node-address | slot slot_number] alternate-ip-address [ipaddress netmask | ipNetmask] gateway

Description

Configures an alternate management IP address, subnetwork, and gateway.

Syntax Description

node-address

Specifies the MAC address of a node in the stack. To view the MAC addresses for all nodes in a stack, enter the show stacking command. A node address or slot number is required unless the automatic keyword is specified.

slot_number

Specifies the slot number of the target node. To view the slot numbers, enter the show stacking command.

ipaddress netmask

Specifies the unique address that exists on the Management VLAN subnet as configured on the initial master node together with the subnetwork mask specified for the Management subnetwork.

Example: 66.77.88.1 255.255.255.0.

ipNetmask

Specifies the unique address that exists on the Management VLAN subnet as configured on the initial master node, followed by a slash (/) character, followed by a decimal number that represents the number of leading one bits in the subnetwork address. An example is 66.77.88.1/24.

gateway

The address of an IP router. A default route is set up to reach this gateway.

Default

No alternate IP address is configured.

Usage Guidelines

If a Management subnetwork is configured and the alternate IP subnetwork does not exactly match the configured Management subnetwork, the information configured by one of the commands specified above is not used. The previously configured alternate IP address is removed if it was installed and subsequently a Management subnetwork is configured that does not exactly match the alternate IP subnetwork. In either case, an error message is logged. The alternate IP address is used if there is no configured Management subnetwork.

To use the command with the node address, the node must be in the stack topology; and to use the command with the slot number, the node must be in the active topology. This form of the command operates only on one node at a time. There are no checks to verify that the address is the one configured in the management VLAN subnet.

The command that does not require a node address or slot number specifies the automatic keyword. Usage of this form of the command causes an alternate IP address to be assigned to every node in the stack topology. The first address is the address specified in the [ipaddress netmask | ipNetmask] parameter. The next address is the IP address plus one, and so on. Since there is a specified subnet mask, the address is checked to insure that the block of IP addresses fits within the specified subnet given the number of nodes in the stack topology. The range of addresses is tested to insure that each one is a valid IP unicast address. If the test fails, no node is configured and an error message is printed. Assignment is in the order in which nodes would currently appear in the show stacking display.

The configuration takes effect after the command is successfully executed.

The alternate IP address, subnetwork, and gateway are only used when the node is operating in stacking mode.

Example

To configure an alternate IP address for every node in the stack with a single command:

configure stacking alternate-ip-address 10.120.1.10/24 10.120.1.1 automatic

To configure an alternate IP address on a single node in the stack topology:

configure stacking node-address 00:04:96:26:6b:ed alternate-ip-address 10.120.1.1/24 10.120.1.1

You may configure an alternate IP address using a slot number for a node that is currently occupying the related slot:

configure stacking slot 4 alternate-ip-address 10.120.1.13/24 10.120.1.1

History

This command was first available in ExtremeXOS 12.0.

Platform Availability

This command is available with all licenses and platforms that support the SummitStack feature. For information about which licenses and platforms support the SummitStack feature, see the Feature License Requirements document.