Configuration commands
vsf enable
From the config context:
d
Syntax
vsf enable domain <DOMAIN-ID>
Description
Enable VSF on the switch. Allows for switches to be stacked using Ethernet ports.
Options
![[CAUTION: ]](images/caution.gif) | CAUTION: The command Upon reboot, the switches come up in the “VSF enabled” mode. Port numbers are prefixed with member numbers, such as “1/A1,”. The configuration on the switch becoming Commander will be retained, but any pre-existing configuration on other switches will be over-written. The switches will inherit the same switch software as the member becoming Commander. If the software image of a switch needs to be updated, the switch will reboot twice. |
Validation rules
Validation |
Error/Warning/Prompt |
|---|---|
When |
This will save the current configuration and reboot the switch. Continue [y/n]? |
Run | |
Run VSF disable when VSF links is UP. |
VSF cannot be disabled when the VSF virtual chassis is active. |
Run |
vsf domain
Syntax
vsf domain <DOMAIN-ID>
Description
Change a domain ID for the VSF virtual chassis.
Once VSF is enabled and virtual chassis is formed, VSF domain ID can be changed using this command.
Options
vsf member shutdown
For a switch that physically exists,
this command will cause the switch to shut down. shutdown is
used in preparation to remove the switch from the virtual chassis.
The switch will not become a voting member of the virtual chassis
again until it is rejoined.
The shutdown command can not
be used on the Commander. The shutdown command
will succeed only if the switch physically exists and is an active
member of the virtual chassis.
Syntax
vsf member <MEMBER-ID> shutdown
Description
Shut down the VSF virtual chassis member.
Restriction
Shutdown will not be available until VSF is enabled.
Validation rules
Validation |
Error/Warning/Prompt |
|---|---|
If member switch physically exists |
The specified VSF virtual chassis member will be shut down. Continue [y/n]? |
If member switch physically exists and is the commander |
The VSF virtual chassis commander cannot be shut down. Please fail over to the standby first. |
If member switch does not physically exist |
The specified VSF virtual chassis member does not exist. |
If shutting down a member will cause a VC –split |
Shutting down this VSF virtual chassis member is not allowed since it would result in a VSF virtual chassis split. |
If VSF not enabled, this command is not allowed. |
VSF is not enabled. |
vsf member reboot
Syntax
boot vsf <MEMBER-ID>
Description
Reboot the VSF member and have it rejoin the
virtual chassis with the current configuration. If the reboot option
is specified, the switch will come back up with a new member-ID and
rejoin the virtual chassis with the current configuration.
Restriction
Reboot will not be available until VSF is enabled.
vsf member remove
This command removes the entire configuration for a specified member. If the member is a provisioned switch, this process affects only the configuration tree. After issuing the command, the specified member-ID is available for re-use and may be provisioned or assigned to another device.
If the member physically exists, its configuration will be erased. It will then be powered down by default.
Syntax
vsf member <MEMBER-ID> remove
Description
Erase the VSF virtual chassis member configuration.
Restriction
Remove will not be available until VSF is enabled.
Validation rules
Validation |
Error/Warning/Prompt |
|---|---|
If VSF not enabled, this command is not allowed. |
VSF is not enabled. |
VSF member neither exists nor provisioned |
The specified VSF virtual chassis member either does not exist or is not provisioned. |
VSF standby syncing add remove member blocked |
VSF virtual chassis members cannot be added or removed while the standby is booting. |
VSF member remove causes VSF virtual chassis split |
Removing this member is not allowed since it would result in a VSF virtual chassis split. |
VSF missing member remove |
The specified VSF virtual chassis member will be removed and its configuration will be erased. The resulting configuration will be saved. Continue [y/n]? |
VSF VC member does not exist |
The specified VSF virtual chassis member does not exist. |
VSF provision member remove |
The specified VSF virtual chassis member configuration will be erased. The resulting configuration will be saved. Continue [y/n]? |
VSF remove commander |
The VSF virtual chassis commander cannot be removed. Please fail over to standby before trying to remove the commander. |
VSF member remove |
The specified VSF virtual chassis member will be removed and its configuration will be erased. The resulting configuration will be saved. The VSF member will be shut down. Continue [y/n]? |
VSF standby remove |
The specified VSF virtual chassis member will be removed and its configuration will be erased. The resulting configuration will be saved. The VSF member will be shut down. Continue [y/n]? |
vsf member priority
Syntax
vsf member <MEMBER-ID> priority <PRIORITY>
Description
Assign a priority to the specified VSF virtual chassis member. The higher the priority, the more likely that the virtual chassis member will become the commander at the next virtual chassis reboot. The default priority value is 128.
Options
vsf member type
This CLI command provisions a switch with the
member ID and the type defined by the specified J-number for the device.
After provisioning the member, the user may perform any configuration
on the device’s ports. The ifAdminStatus on the
device’s ports will be configurable at this time, however the ifOperStatus will
remain down.
A “strict” provisioning specifies a MAC address and allows for only one device with the matching J-number and MAC to be configured.
A “loose” provisioning allows the device with the specified J-number to be configured without a MAC address being specified. This allows any device which matches the J-number to adopt this configuration.
If a provisioned configuration already exists with the member ID, the following command is used to change the provisioning from “strict” and “loose” and visa versa.
Syntax
vsf member <MEMBER-ID> type <TYPE> [mac <MAC-ADDR>]
Description
Configure the family of the VSF member-switch being provisioned. After provisioning, the VSF member-switch can be configured as if it were physically present. When an VSF member-switch matching the provisioned details joins the VSF, it is provided this configuration. A new or missing VSF member can be configured as a provisioned device by using this command.
Options
Restrictions
The allowed range for the member ID is 1 thru 2.
If switch “N” physically exists, the command will fail.
If switch “N” is provisioned, the command can be used to change the MAC or type.
If the J-Number is known to not support stacking, or the J-Number is unknown, the command will fail.
If the same MAC address is already provisioned or exists on another member ID, the command will fail.
Usage
vsf member<2>type<J9850A>mac<001122-334455>Updates the strict provisioning for VSF VC member 2, and changes the MAC address to 001122-334455.
vsf member<2>type<J9850A>Changes the “strict” provisioning for VSF VC member #2 to “loose” provisioning. The configured MAC address is then removed.
vsf member<2>type<J9850A>mac<00aabb-cceedd>Changes “loose” provisioning for VSF VC member 2 to “strict” provisioning with MAC address 00aabb-cceedd.
Validation rules
Validation |
Error/Warning/Prompt |
|---|---|
If the member-ID is not between 1 to 2 for bolt then command will return an error. |
The VSF member-ID value is not in range. |
The member-ID must physically exist or already be provisioned. |
The specified VSF virtual chassis member either does not exist or is not provisioned. |
When each time new member is configured, write mem is called. |
This will save the current configuration. Continue [y/n]? |
VSF virtual chassis members cannot be added or removed while the standby is booting. | |
The VSF commander cannot be removed. Please fail over to standby before trying to remove it. | |
An VSF member configuration is already provisioned with the specified MAC address. | |
An VSF switch with the specified member-Id is already present. | |
Shutting down this VSF member is not allowed since it would result in a VSF virtual chassis split. | |
MAC address cannot be null. | |
MAC address cannot be broadcast/multicast address. | |
A switch with the specified MAC address already exists. | |
A member configuration is already provisioned with the specified MAC address. |