To supply a configuration to a new switch before it joins the switch stack, use the switch provision command in global configuration mode on the active switch. To delete all configuration information that is associated with
the removed switch (a stack member that has left the stack), use the no form of this command.
switch stack-member-number provision type
no switch stack-member-number provision
Syntax Description
stack-member-number
|
|
type
|
Switch type
of the new switch before it joins the stack.
|
Command Default
The switch is not
provisioned.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
|
This command was introduced.
|
Usage Guidelines
For
type , enter
the model number of a supported switch that is listed in the command-line help
strings.
To avoid receiving
an error message, you must remove the specified switch from the switch stack
before using the
no form of
this command to delete a provisioned configuration.
To change the switch
type, you must also remove the specified switch from the switch stack. You can
change the stack member number of a provisioned switch that is physically
present in the switch stack if you do not also change the switch type.
If the switch type
of the provisioned switch does not match the switch type in the provisioned
configuration on the stack, the switch stack applies the default configuration
to the provisioned switch and adds it to the stack. The switch stack displays a
message when it applies the default configuration.
Provisioned
information appears in the running configuration of the switch stack. When you
enter the
copy running-config
startup-config privileged EXEC command, the provisioned
configuration is saved in the startup configuration file of the switch stack.
Caution |
When you use the
switch
provision command, memory is allocated for the provisioned
configuration. When a new switch type is configured, the previously allocated
memory is not fully released. Therefore, do not use this command more than
approximately 200 times, or the switch will run out of memory and unexpected
behavior will result.
|
Examples
This example shows
how to provision a switch with a stack member number of 2 for the switch stack.
The
show
running-config command output shows the interfaces associated with the
provisioned switch.
(config)# switch 2 provision WS-xxxx
(config)# end
# show running-config | include switch 2
!
interface GigabitEthernet2/0/1
!
interface GigabitEthernet2/0/2
!
interface GigabitEthernet2/0/3
<output truncated>
You also can enter
the
show switch
user EXEC command to display the provisioning status of the switch stack.
This example shows
how to delete all configuration information about stack member 5 when the
switch is removed from the stack:
(config)# no switch 5 provision
You can verify that
the provisioned switch is added to or removed from the running configuration by
entering the
show
running-config privileged EXEC command.