Scenario 1 - Using Stack Interactive-setup to Create a Stack

The following are connection requirements for discovering new units:

  • A port in a valid-stack-port set must be connected; otherwise, the stack interactive-setup utility treats the stack as an invalid topology. For example, one valid-stack-port set for ICX 7850 48-port devices is (x/2/1, x/2/5, 4). You must connect either x/2/1 or x/2/5.

    Note: The valid-stack-port requirement does not apply to the process of discovering new links between existing units, which enlarges stack-trunks or converts a chain to a ring.

  • The connections must form a contiguous stack-trunk even if there are "holes" in the connections. For the previous ICX 7850 example, the two links 1/2/1 to 2/2/4 and 1/2/3 to 2/2/6 will form stack-trunk 1/2/1 to 1/2/3 and stack-trunk 2/2/4 to 2/2/6.
  • The connecting ports must not have data port configuration.

Note: The active controller of a stack or a standalone with stacking enabled can initiate interactive setup to discover new stack units. The following procedure is performed from a standalone unit.
Note: Stack interactive-setup can discover new units and new links between existing units. If the process detects both new units and new links, it first handles the new links between existing units and terminates. The system then requests that you run stack interactive-setup again to discover new units.

Perform these steps to create a stack using the stack interactive-setup utility.

  1. Connect the devices using the stacking ports and stack cabling. For more information, refer to the stacking overview for the device and to the appropriate hardware installation guide.
  2. Power on the units.
  3. Connect your console to the intended active controller. The unit through which you run stack interactive-setup becomes the active controller by default.
  4. (Optional) Enter the show stack and the show running-config commands to check the current configuration of the standalone from which you plan to construct the stack. The configuration must include stack enable.

    The following example shows that stacking is not enabled (and stacking probes are not being sent) on the standalone from which the stack is to be discovered.

    ICX7850-48FS Router> en
No password has been assigned yet...
ICX7850-48FS Router# show stack

***** Warning! stack is not enabled. *****

T=3m56.7: alone: standalone, D: dynamic cfg, S: static
ID   Type          Role    Mac Address    Pri State   Comment
1  S ICX7850-48FS  alone   d4c1.9e18.83e1   0 local   None:0

     +---+
  2/1| 1 |2/5
     +---+
Current stack management MAC is d4c1.9e18.83e1

    The following example indicates the stacking ports as 1/2/1 and 1/2/5. 

    ICX7850-48FS Router# show running-config
Current configuration:
!
ver 09.0.00_b417T233
!
stack unit 1
  module 1 icx7850-48fs-port-management-module
  module 2 icx7800-100g-8port-800g-module
  stack-port ethernet 1/2/1
  stack-port ethernet 1/2/5
!
  5. If stacking is not enabled on the unit, enter the stack enable command in global configuration mode. 
    ICX7850-48FS Router# configure terminal
ICX7850-48FS Router(config)# stack enable
Enable stacking. This unit actively participates in stacking
ICX7850-48FS Router(config)# end
  6. Enter the stack interactive-setup command in Privileged EXEC mode on the standalone that will serve as the active controller for the stack.
    Note: The stack secure-setup command has been deprecated and replaced by the stack interactive-setup command. If you enter the stack secure-setup command, the system responds with an error and instructs you to use the new command.
    Note: The stack interactive-setup process can be initiated by a standalone unit or by the active controller of a stack. In the following example, the process is initiated by a standalone.
  7. Select from the available options as shown in the following example. If you are building a stack for the first time and the attached units are clean units with no startup configuration, select 2.
    Note: Units with any startup configuration in flash memory are not discovered by option 2.
    Note: If the connected units contain configuration, you can select option 3, which saves the manual steps of removing configuration from the units (using the erase startup-config and reload commands for each one).
    Note: An ICX 7650 device with startup-config flash using 40-Gbps stacking ports but no other configuration is treated as a clean unit. Because an ICX 7650 device that uses 40-Gbps stacking requires the rear-module stack-40g command followed by the write memory and reload commands to change the default 100-Gbps stacking ports to 40-Gbps stacking ports, the related startup-config flash must be present. 
    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=10m58.2: Sending probes to ports: u1: 1/2/1 to 1/2/5 1/2/8,

    Note: Stack interactive-setup option 3 can discover a password-protected production standalone unit and propose that it be joined to a stack. From FastIron release 09.0.00, you are not required to enter the password of the candidate stacking unit. Use the displayed descriptions of discovered units, which include serial number, hostname, IP address, and system uptime, to avoid unintentionally annexing a production standalone into a stack system. As shown in the following example, stack interactive-setup option 3 displays identifying information for discovered units for your review before you confirm their annexation.
    The stack interactive-setup command followed by the option selection triggers a RUCKUS proprietary discovery protocol that begins the discovery process in both upstream and downstream directions. The discovery process produces a list of upstream and downstream devices that are available to join the stack. Interactive-setup can detect up to 11 units in each direction (22 units total); however, you must select a total number of units that is less than the maximum stack size for the device because the controller is also part of the stack.
    Note: Probes are sent through all qualified ports, that is, ports that are up but have no configuration, excluding any stacking port or stacking trunk connected to a live neighbor.
    Note: During the stack interactive-setup process, after two minutes of inactivity, authentication for stack members expires, forcing you to restart the process.

    Note: To exit the stack interactive-setup process, enter Control-C at any time.

    In the example, the user has selected option 3, which initiates probes to discover other potential stack units and links as shown in the following example. Because the initiating standalone in the example has no live neighbors, it sends stacking probes through ports 1/2/1 and 1/2/5 to 1/2/8, assuming these ports are up and have no configuration. 

    Existing stack: ============================================================
                                                                               
     +---+
  2/1| 1 |2/5
     +---+    <-- Initial topology shows the standalone and the active stacking ports.
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.7daf SN=FLW3331P008 H="ICX7850-48F Router" T=12m
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="1st floor" mgmt-IP=192.168.1.1 T=12m
#3: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H=engineering mgmt-IP=10.176.131.113 T=12m

     1/2/1                     1/2/5
      ||                         |
      ||                         |
      2/5                       2/5
     +---+        +---+        +---+
     |#1 |2/1--2/1|#2 |2/5--2/1|#3 |
     +---+        +---+        +---+
    Discovered units and their connections to the standalone (unit 1 at top) are displayed.

    In the example, three connected units are discovered. The first is connected to the standalone through standalone port 1/2/1 and discovered device port x/2/5. The 1/2/1 to x/2/5 connection contains multiple links, so it is represented as a double bar '||'. The 1/2/5 to x/2/5 connection contains a single link, so it is represented by a single bar '|'. The device is shown as #1 to indicate the order of discovery in the discovered topology but ultimately receives another stack unit ID, as the standalone retains stack ID 1.

    Note: You can use the MAC address, serial number, hostname, IP address, and up-time provided for each discovered unit to track its identity prior to stack unit ID assignment. If a unit has no IP address, it is not displayed as show in the #1 example.

    In this example, the system reports a single chain/ring discovered. In fact, the potential connection will form a continuous ring, which is presented as a single entity for selection as shown in the following steps.

  8. As each discovered unit connection is re-displayed, enter y when prompted to accept the connection as shown in the following example (or enter n to decline the connection). In the example, note the connecting module type, serial number, and MAC address for discovered units as well as the proposed stack unit IDs. 
    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.7daf SN=FLW3331P008 H="ICX7850-48F Router" T=12m, type an ID (No: 0, default: 2):
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="1st floor" mgmt-IP=192.168.1.1 T=12m, type an ID (No: 0, default: 3):
#3: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H=engineering mgmt-IP=10.176.131.113 T=12m, type an ID (No: 0, default: 4):
    The example shows the connections and identifying information for three accepted stack units, along with the proposed IDs assigned by default, stack units 2, 3, and 4.
  9. As the full topology is re-displayed for confirmation, enter y when prompted to confirm the topology (or n to decline the topology and terminate the process).
    After you accept the topology, the active controller is confirmed, the members are reloaded, the stack is formed, and a standby controller is designated.
    During the interactive-setup process, be sure to execute the write memory command if there are any changes to the stack-port or stack-trunk configuration on the active controller. At the end of the process, after new units join the stack, execute the write memory command to save the configuration of the other units.
    Note: If you do not issue the write memory command, you may lose the configuration the next time the stack reboots. 
    You selected 3 unit(s): #1: ID=2, #2: ID=3, #3: ID=4,

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

                   #1           #2           #3
     +---+        +---+        +---+        +---+
 -2/5| 1 |2/1==2/5| 2 |2/1--2/1| 3 |2/5--2/1| 4 |2/5-
 |   +---+        +---+        +---+        +---+   |
 |                                                  |
 |--------------------------------------------------|<-- The proposed topology is displayed 
                                               with assigned stack IDs, followed by identifying
                                               information for the discovered units.

 U1: MAC=d4c1.9e18.83e1 SN=FLV3333P018 running stack interactive-setup
 U2: MAC=d4c1.9e17.7daf SN=FLW3331P008 H="ICX7850-48F Router" T=12m
 U3: MAC=d4c1.9e17.8907 SN=FLW3331P019 H="1st floor" mgmt-IP=192.168.1.1 T=12m
 U4: MAC=d4c1.9e17.7e07 SN=FLW3331P009 H=engineering mgmt-IP=10.176.131.113 T=12m
Proceeding will produce the above topology. Do you accept it? (enter 'y' or 'n'): y
stack interactive-setup discovers 3 unit(s) and sends stack-port/trunk to chain 0: 
 #1 d4c1.9e17.7daf U2, D0: 2/1, D1: 2/5 to 2/8
 #2 d4c1.9e17.8907 U3, D0: 2/1, D1: 2/5
 #3 d4c1.9e17.7e07 U4, D0: 2/1, D1: 2/5 <-- Stack ports and trunks form so stack units can join.

T=11m30.9: Please wait for background job to finish.
stack-trunk ethernet 1/2/1 to 1/2/4 replaces stack-port ethernet 1/2/1
T=11m41.0: stack interactive-setup enlarges stack-port ethernet 1/2/1 to stack-trunk ethernet 1/2/1 to 1/2/4 to match links.

Configuration changed. Please do "write memory".

    In the example, a four-unit stacking ring is formed. The direction of each link formed is indicated in the final topology as D0 or D1.

    Note: To form a stack, the original stacking port and stacking trunk configuration may be modified or deleted, or new stacking port or trunk configuration may be added. Although the original configuration is not required in discovering units, the system attempts to keep the original configuration, when possible, to respect the user's intentions.

    After you confirm the configuration, all stack units except the active controller are reloaded.

    The active controller is promoted to a priority of 128. This priority is used in hitless switchover and failover negotiations as described in Hitless Stacking.

  10. Note: The active controller may learn new configuration after the other units reload and join the stack, so be sure to issue the write memory command to save the new configuration. Before saving the changes to stack members, you can check the stack configuration as shown in this step.
    (Optional) Enter the show stack command to check the stack topology and the roles assigned to each stack unit and to verify that all units are in the Ready state. 
    ICX7850-48FS Router# show stack
T=17m4.4: 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  D ICX7850-48F   standby d4c1.9e17.7daf   0 remote  Ready
3  D ICX7850-48F   member  d4c1.9e17.8907   0 remote  Ready
4  D 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 - Learn other units for 6 sec, protocols may not be ready in 64 s.
Role history: N: standalone, A: active, S: standby, M: member
U1: N->A <-- Stack history. The standalone unit 1 has successfully made the transition to 
                  active controller. No other change of roles has occurred.
    The example shows unit 1 is the active controller for the stack. Unit 1 has been assigned a priority of 128. Stack unit 2 has been assigned the role of standby controller. Units 3 and 4 are regular stack members. The stack history indicates that no other unit has held the role of active controller for this stack. All stack units are in the Ready state. The "D" displayed for units 2, 3, and 4 indicates a dynamic configuration. After you execute the write-memory command, the "D" changes to an "S" for static configuration.
  11. (Optional) Enter the show running-config command to verify additional information, such as the software version running on the stack, the module configuration of each stack unit, and the stacking connections for each unit.
    Note: Additional show commands are available if a deeper verification of stack configuration is necessary. Refer to Verifying a traditional stack configuration for more information.
  12. Enter the write memory command to save the changes to stack member configuration.
    The command initiates configuration synchronization, which copies the configuration file of the active controller to the rest of the stack units.
    Note: The stack interactive-setup process may modify your configuration with information about new units, stacking ports, and the like. For this reason, it is very important to save this information by issuing the write memory command. If you do not do this, you may lose your configuration information the next time the stack reboots. 
    ICX7850-48FS Router# write memory <-- You must save the configuration changes.

 There is no startup config file, unable to save legacy config

Automatic copy to member units:  2  3  4
Flash Memory Write (8192 bytes per dot)
.
Write startup-config done.
Copy Done.
ICX7850-48FS Router#

The following example includes the full stack interactive-setup process described in the previous task steps. 

ICX7850-48FS Router> en
No password has been assigned yet...
ICX7850-48FS Router# show stack

***** Warning! stack is not enabled. *****

T=3m56.7: alone: standalone, D: dynamic cfg, S: static
ID   Type          Role    Mac Address    Pri State   Comment
1  S ICX7850-48FS  alone   d4c1.9e18.83e1   0 local   None:0


     +---+
  2/1| 1 |2/5
     +---+
Current stack management MAC is d4c1.9e18.83e1
ICX7850-48FS Router# show running-config
Current configuration:
!
ver 09.0.00_b417T233
!
stack unit 1
  module 1 icx7850-48fs-port-management-module
  module 2 icx7800-100g-8port-800g-module
  stack-port ethernet 1/2/1
  stack-port ethernet 1/2/5
!
... snipped

ICX7850-48FS Router# configure terminal
ICX7850-48FS Router(config)# stack enable
Enable stacking. This unit actively participates in stacking
ICX7850-48FS Router(config)# end
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=10m58.2: Sending probes to ports: u1: 1/2/1 to 1/2/5 1/2/8,
Probing in progress ...
Probing in progress ...
Existing stack: ============================================================

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


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.7daf SN=FLW3331P008 H="ICX7850-48F Router" T=12m
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="1st floor" mgmt-IP=192.168.1.1 T=12m
#3: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H=engineering mgmt-IP=10.176.131.113 T=12m

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

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.7daf SN=FLW3331P008 H="ICX7850-48F Router" T=12m, type an ID (No: 0, default: 2):
#2: icx7850-48f-sf-port d4c1.9e17.8907 SN=FLW3331P019 H="1st floor" mgmt-IP=192.168.1.1 T=12m, type an ID (No: 0, default: 3):
#3: icx7850-48f-sf-port d4c1.9e17.7e07 SN=FLW3331P009 H=engineering mgmt-IP=10.176.131.113 T=12m, type an ID (No: 0, default: 4):

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

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

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

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

T=11m30.9: Please wait for background job to finish.
stack-trunk ethernet 1/2/1 to 1/2/4 replaces stack-port ethernet 1/2/1
T=11m41.0: stack interactive-setup enlarges stack-port ethernet 1/2/1 to stack-trunk ethernet 1/2/1 to 1/2/4 to match links.

Configuration changed. Please do "write memory".

ICX7850-48FS Router#

..... wait for several minutes for the members to reload and join the stack.

ICX7850-48FS Router> en
No password has been assigned yet...
ICX7850-48FS Router# show running-config
Current configuration:
!
ver 09.0.00_b417T233
!
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/4
  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/8
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-80

ICX7850-48FS Router# write memory

In this section:

  1. Auto-trunking New Links or Converting a Linear Stack to a Ring with Stack Interactive-setup
  2. Changing Stack Unit IDs with Stack Interactive-setup
Parent topic: Stack Construction Methods