Replacing a Stack Unit with stack interactive-setup

You must use stack interactive-setup to replace stack units in the following cases:

  • The replacement is not a clean unit.
  • You do not want the active controller to trigger an automatic replacement.
  • You are replacing multiple units simultaneously.

Note: If you are replacing more than one unit simultaneously, you may also use stack zero-touch provisioning to discover the units; however, stack interactive-setup allows interactive control of the process.
Note: If you use stack interactive-setup to assign a new unit an ID that has mismatched static configuration, the utility displays a warning message that the new unit will be put in a non-operational state after it joins the stack.
Note: You can return a configuration-mismatched unit to operation by configuring the no stack unit command for the nonoperational unit from the active controller. This removes the entire stack configuration so the active controller can learn the configuration-mismatched unit as a new unit. The active controller triggers an election and learns the unit. Refer to Recovering from a stack unit configuration mismatch for more information.

To replace a stack unit with stack interactive-setup, perform the following steps.

  1. (Optional) Enter the show stack command on the active controller, and check for an "S" beside the unit to confirm that the configuration for the unit you are replacing is static.
  2. If the configuration is not static, enter the write memory command to change all dynamic configurations to static. A static configuration remains after the unit is removed.
  3. Remove the old stack unit from the stack.
  4. Connect the new unit to the existing stack using the same stacking ports as the old unit.
  5. Enter the stack interactive‐setup command. Select interactive-setup option 2 if the replacement unit is a clean unit. Select interactive-setup option 3 if the replacement unit contains configuration. Stack interactive-setup suggests an ID based on matching the new unit with the static configurations. You can overwrite the suggested ID by entering the ID of the old unit.
    The active controller resets the unit, and it joins the stack.

In the following example, units 3 and 4 are removed and replaced. Because unit configuration has been saved, once the units are removed, the show stack command displays the state of both units as "reserve." This indicates that provisional configuration is stored for the two units.

ICX7850-48FS Router# show stack
T=7m3.7: alone: standalone, D: dynamic cfg, S: static
ID   Type          Role    Mac Address    Pri State   Comment
1  S ICX7850-48FS  active  d4c1.9e18.83e1 128 local   Ready
2  S ICX7850-48F   standby d4c1.9e17.7daf   0 remote  Ready
3  S ICX7850-48F   member  0000.0000.0000   0 reserve
4  S ICX7850-48F   member  0000.0000.0000   0 reserve

    active       standby
     +---+        +---+
  2/5| 1 |2/1==2/5| 2 |2/1
     +---+        +---+
Standby u2 - protocols ready, can failover
Current stack management MAC is d4c1.9e18.83e1

If you connect two clean units matching the physical modules of the units you removed, you can use the stack interactive-setup Option 2 command. If the units have configuration, use Option 3.

ICX7850-48FS Router(config)# stack interactive-setup
Invalid input ->interactive-setup
Type ? for a list
Node doesn't exist
ICX7850-48FS Router(config)# exit
ICX7850-48FS Router# stack interactive-setup
You can abort stack interactive-setup at any stage by <ctrl-c>
0: quit
1: change stack unit IDs
2: discover and convert new units (no startup-config flash) to members
3: discover and convert existing/new standalone units to members
2&3 can also find new links and auto-trunk or convert chain(s) to ring.
Please type your selection: 3
Probing topology to find standalone units...
T=5m22.6: Sending probes to ports: u1: 1/2/5 1/2/8, u2: 2/2/1 2/2/4,
Probing in progress ...
Probing in progress ...
Existing stack: ============================================================
    active       standby
     +---+        +---+
  2/5| 1 |2/1==2/5| 2 |2/1
     +---+        +---+


Horizontal bars link to discovered units. Vertical bars link to stack units.


Chain #0: ==================================================================
SN: serial #, H: hostname, IP, T: up time, (diff: image mismatch)
#1: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H="ICX7850-48F Router" T=21h40m
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="ICX7850-48F Router" T=21h40m

     1/2/5        2/2/1
       |            |
       |            |
      2/5          2/1
     +---+        +---+
     |#1 |2/1--2/5|#2 |
     +---+        +---+

Discovered 1 chain/ring
Chain #0: Do you want to select this chain? (enter 'y' or 'n'): y
#1: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H="ICX7850-48F Router" T=21h40m, type an ID (No: 0, default: 4): 4
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="ICX7850-48F Router" T=21h40m, type an ID (No: 0, default: 3): 3

You selected 2 unit(s): #1: ID=4, #2: ID=3,

stack interactive-setup detects the following links:
Links U1--U4, #=1: 2/5--2/5
Links U4--U3, #=1: 2/1--2/5
Links U3--U2, #=1: 2/1--2/1

    standby      active         #1           #2
     +---+        +---+        +---+        +---+
 -2/1| 2 |2/5==2/1| 1 |2/5--2/5| 4 |2/1--2/5| 3 |2/1-
 |   +---+        +---+        +---+        +---+   |
 |                                                  |
 |--------------------------------------------------|

 U1: MAC=d4c1.9e18.83e1 SN=FLV3333P018 running stack interactive-setup
 U2: MAC=d4c1.9e17.7daf SN=FLW3331P008 standby
 U3: MAC=d4c1.9e17.8907 SN=FLW3331P019 H="ICX7850-48F Router" T=21h40m
 U4: MAC=d4c1.9e17.7e07 SN=FLW3331P009 H="ICX7850-48F Router" T=21h40m
Proceeding will produce the above topology. Do you accept it? (enter 'y' or 'n'): y
stack interactive-setup discovers 2 unit(s) and sends stack-port/trunk to chain 0:
 #1 d4c1.9e17.7e07 U4, D0: 2/1, D1: 2/5
 #2 d4c1.9e17.8907 U3, D0: 2/1, D1: 2/5

T=6m23.5: Please wait for background job to finish.
ICX7850-48FS Router# show running-config
Current configuration:
!
ver 09.0.00_b385T233
!
stack unit 1
  module 1 icx7850-48fs-port-management-module
  module 2 icx7800-100g-8port-800g-module
  priority 128
  stack-trunk ethernet 1/2/1 to 1/2/3
  stack-port ethernet 1/2/5
stack unit 2
  module 1 icx7850-48f-sf-port-management-module
  module 2 icx7800-100g-8port-800g-module
  stack-port ethernet 2/2/1
  stack-trunk ethernet 2/2/5 to 2/2/7
stack unit 3
  module 1 icx7850-48f-sf-port-management-module
  module 2 icx7800-100g-8port-800g-module
  stack-port ethernet 3/2/1
  stack-port ethernet 3/2/5
stack unit 4
  module 1 icx7850-48f-sf-port-management-module
  module 2 icx7800-100g-8port-800g-module
  stack-port ethernet 4/2/1
  stack-port ethernet 4/2/5
stack enable
stack mac d4c1.9e18.83e1
!
hitless-failover enable
!
!

When the interactive-setup process is complete, output for the show stack command confirms that the configuration is the same. The provisional configuration has been applied to the two replacement units, 3 and 4, and the state has changed to "remote" for both units.

ICX7850-48FS Router# show stack
T=26m22.0: alone: standalone, D: dynamic cfg, S: static
ID   Type          Role    Mac Address    Pri State   Comment
1  S ICX7850-48FS  active  d4c1.9e18.83e1 128 local   Ready
2  S ICX7850-48F   standby d4c1.9e17.7daf   0 remote  Ready
3  S ICX7850-48F   member  d4c1.9e17.8907   0 remote  Ready
4  S ICX7850-48F   member  d4c1.9e17.7e07   0 remote  Ready

    active       standby
     +---+        +---+        +---+        +---+
 -2/5| 1 |2/1==2/5| 2 |2/1--2/1| 3 |2/5--2/1| 4 |2/5-
 |   +---+        +---+        +---+        +---+   |
 |                                                  |
 |--------------------------------------------------|
Standby u2 - protocols ready, can failover
Current stack management MAC is d4c1.9e18.83e1
ICX7850-48FS Router#