stack zero-touch-enable
Enables background zero-touch provisioning (ZTP) to form a stack system or to add
new stack units without user intervention.
Command Default
Zero-touch provisioning for stacking is not enabled by default.
Modes
Global configuration mode
Usage Guidelines
The
no form of the command disables stack zero-touch provisioning.
Stacking must be enabled with the
stack enable command before you can enable stack zero-touch provisioning.
You must use the
write memory command after running stack zero-touch provisioning to saved the learned configuration.
Ruckus recommends stack interactive-setup as the preferred method for discovering and configuring a stack because it alerts users to potential issues and available options and is therefore more flexible. Using stack zero-touch provisioning is the same as running stack interactive-setup option 2 and electing all proposed options.
Ruckus recommends that you disable stack zero-touch provisioning after all new units and connections are discovered. Keeping the utility enabled does no harm, but the probes that occur every three minutes add processing overhead.
Examples
Replace the following ICX 7750-based example with oe using another ICX stackable device
when SME's can make such a sample available.
The following example shows that a linear two-unit stack can learn new units as well
as detect new links between existing units. The example first checks the running configuration
before stack zero-touch provisioning is enabled. The utility discovers a new unit,
adds a stack-trunk, and enlarges a stack-port into a stack-trunk so that the units
can form a three-unit ring. It later detects links and enlarges an existing single-port
link between unit 1 and unit 2 into a stack-trunk.
ICX7750-26Q Router# show stack
T=1h6m11.2: alone: standalone, D: dynamic cfg, S: static
ID Type Role Mac Address Pri State Comment
1 S ICX7750-26QXG active cc4e.2438.7280 128 local Ready
2 S ICX7750-48XGF standby 609c.9f7f.9400 128 remote Ready
standby active
+---+ +---+
| 2 |2/1--2/1| 1 |2/4
+---+ +---+
Standby u2 - protocols ready, can failover
Current stack management MAC is cc4e.2438.7280
ICX7750-26Q Router# show running-config
Current configuration:
!
ver 08.0.90
!
stack unit 1
module 1 icx7750-20-qxg-port-management-module
module 2 icx7750-qsfp-6port-qsfp-240g-module
module 3 icx7750-6q-6port-qsfp-240g-module
priority 128
stack-port 1/2/1
stack-port 1/2/4
stack unit 2
module 1 icx7750-48-xgf-port-management-module
module 2 icx7750-qsfp-6port-qsfp-240g-module
module 3 icx7750-6q-6port-qsfp-240g-module
priority 128
stack-port 2/2/1
stack enable
stack mac cc4e.2438.7280
!
ICX7750-26Q Router# config terminal
ICX7750-26Q Router(config)# stack zero-touch-enable
ICX7750-26Q Router(config)# end
ICX7750-26Q Router#T=1h8m36.9: Add stack-trunk 2/2/4 to 2/2/6 for new units to join <-- New unit
stack-trunk 1/2/4 to 1/2/6 replaces stack-port 1/2/4 discovered
T=1h8m37.0: Enlarge stack-port 1/2/4 to stack-trunk 1/2/4 to 1/2/6 to match links.
Configuration changed. Please do "write memory".
T=1h8m48.4: Election, was active, no change, ID=1, pri=128, 2U(1-2), A=u1, nbr#=1 0,
reason: u1: stk-po-chg, ,
Config changed due to add/del units. Do write mem if you want to keep it
T=1h11m36.1: Election, was active, no change, ID=1, pri=128, 3U(1-3), A=u1, nbr#=1 1,
reason: u3: port-up, ,
Detect stack unit 3 has different startup config flash, will synchronize it
T:1h11m31.3: Done hot swap: active controller u1 sets u3 to Ready.
T=1h11m39.1: Election, was active, no change, ID=1, pri=128, 3U(1-3), A=u1, nbr#=1 1,
reason: u1: stk-po-chg, ,
T=1h11m32.3: Synchronize startup config to u3
Flash Memory Write (8192 bytes per dot)
.
Write startup-config done.
Config changed due to add/del units. Do write mem if you want to keep it
Stack unit 3 Power supply 1 is up
Stack unit 3 Power supply 2 is down
T=1h11m46.8: Election, was active, no change, ID=1, pri=128, 3U(1-3), A=u1, nbr#=2 2,
Config changed due to add/del units. Do write mem if you want to keep it
T=1h13m18.1: stack zero-touch configures multi-stack-trunk 1/2/1 to 1/2/3 and 2/2/1 to 2/2/3
stack-trunk 1/2/1 to 1/2/3 replaces stack-port 1/2/1 <-- New links
stack-trunk 2/2/1 to 2/2/3 replaces stack-port 2/2/1 between
existing units
create new
configuration
Configuration changed. Please do "write memory".
T=1h13m30.1: Election, was active, no change, ID=1, pri=128, 3U(1-3), A=u1, nbr#=2 2,
reason: u1: stk-po-chg, ,
Config changed due to add/del units. Do write mem if you want to keep it
!!! Temperature is over warning level on stack unit 3 !!!
ICX7750-26Q Router#
ICX7750-26Q Router# show stack
T=1h15m2.1: alone: standalone, D: dynamic cfg, S: static
ID Type Role Mac Address Pri State Comment
1 S ICX7750-26QXG active cc4e.2438.7280 128 local Ready
2 S ICX7750-48XGF standby 609c.9f7f.9400 128 remote Ready
3 D ICX7750-26QXG member 748e.f8f9.6300 0 remote Ready
active standby
+---+ +---+ +---+
=2/1| 1 |2/4==2/1| 3 |2/4==2/4| 2 |2/1=
| +---+ +---+ +---+ |
| |
|-------------------------------------|
Standby u2 - protocols ready, can failover or manually switch over
Current stack management MAC is cc4e.2438.7280
ICX7750-26Q Router# show running-config
Current configuration:
!
ver 08.0.90
!
stack unit 1
module 1 icx7750-20-qxg-port-management-module
module 2 icx7750-qsfp-6port-qsfp-240g-module
module 3 icx7750-6q-6port-qsfp-240g-module
priority 128
stack-trunk 1/2/1 to 1/2/3
stack-trunk 1/2/4 to 1/2/6
stack unit 2
module 1 icx7750-48-xgf-port-management-module
module 2 icx7750-qsfp-6port-qsfp-240g-module
module 3 icx7750-6q-6port-qsfp-240g-module
priority 128
stack-trunk 2/2/1 to 2/2/3
stack-trunk 2/2/4 to 2/2/6
stack unit 3
module 1 icx7750-20-qxg-port-management-module
module 2 icx7750-qsfp-6port-qsfp-240g-module
module 3 icx7750-6q-6port-qsfp-240g-module
stack-trunk 3/2/1 to 3/2/3
stack-trunk 3/2/4 to 3/2/6
stack enable
stack zero-touch-enable
stack mac cc4e.2438.7280
!
Unit 3 (new unit) log ===============
ICX7750-26Q Router>
Creating certificate, please wait...
SSL Client Certificate is successfully created
Power supply 1 detected.
Power supply 1 is up.
Stack unit 1 Power supply 1 is up
Power supply 2 detected with no power.
!!! Temperature is over warning level on stack unit 1 !!!
!!! Temperature is over warning level on stack unit 1 !!!
!!! Temperature is over warning level on stack unit 1 !!!
!!! Temperature is over warning level on stack unit 1 !!!
Unit 1 receives stack zero-touch from U1, mac=cc4e.2438.7280 <-- Unit discovered & reloaded by unit 1
ID=3 D0=2/1 to 2/3, D1=2/4 to 2/6, , will reload from Primary in 20 sec
Unmounting the External USB
We are in system resetSyncing file system
Rebooting...
================ after bootup
The system : started=warm start reloaded=by "reload"
My stack unit ID = 3, bootup role = member
[MEMBER]local-3@ICX7750-26Q Router>
Power supply 1 detected.
Power supply 1 is up.
Power supply 2 detected with no power.
UNIT3:
T=1m30.5: Election, was member, no change, ID=3, pri=0, 3U(1-3), A=u1, nbr#=2 0, reason: u3: port-up, ,
Unit 3 becomes ready
T=1m33.7: Election, was member, no change, ID=3, pri=0, 3U(1-3), A=u1, nbr#=2 0,
Download request from active unit 1 mac = cc4e.2438.7280
There is no startup config file, unable to save legacy config
Downloading - startup-config.txt
UNIT3:T=1m34.2: U3 received startup config flash sync.
Done.
T=1m41.1: Election, was member, no change, ID=3, pri=0, 3U(1-3), A=u1, nbr#=2 2,
UNIT3:
T=3m24.4: Election, was member, no change, ID=3, pri=0, 3U(1-3), A=u1, nbr#=2 2,
reason: u1: stk-po-chg, ,
History
| Release version | Command history |
|---|---|
| 08.0.90 | This command was introduced. |