Preprovisioning a Virtual Chassis Fabric
Preprovisioning a Virtual Chassis Fabric (VCF) configuration allows you to assign the member ID and role for each device in the VCF. See Understanding Virtual Chassis Fabric Components and Understanding Virtual Chassis Fabric Configuration for details on the supported devices that can be interconnected into a non-mixed or mixed VCF.
Before you begin:
Update all devices to the same version of Junos OS that supports VCF. See Installing Software Packages on QFX Series Devices or Installing Software on an EX Series Switch with a Single Routing Engine (CLI Procedure).
QFX5100 switches running a Junos OS image that includes “-qfx-5-” in the software package filename must be upgraded to a package filename that includes “-qfx-5e-” before being added to a QFX5110 Virtual Chassis or VCF. See Upgrading a QFX5100 Switch with a USB Device to Join a QFX5110 Virtual Chassis or Virtual Chassis Fabric.
If automatic software download is enabled, disable this feature by entering the delete chassis auto-image-upgrade statement.
To preprovision a VCF:
- Make a list of the serial numbers of all the devices to
be connected in the VCF. You can get a device’s serial number
in the show virtual-chassis output or by following the
instructions in Locating the Serial Number on a QFX5110 Device or Component, Locating the Serial Number on a QFX5100 Device or Component, Locating the Serial Number on a QFX3600 or QFX3600-I Device or Component, Locating the Serial Number on a QFX3500 Device or Component, or Locating the Serial Number on an EX4300 Switch or Component.
Serial number values are case-sensitive.
- Decide the desired role (routing-engine or line-card) for each device.
In a VCF, you configure two supported devices acting in the Routing Engine role into spine devices. All other devices—the spine devices not assuming the master or backup Routing Engine role and all leaf devices—are configured into the linecard role as leaf devices.
- Set each device individually into fabric mode. If needed,
also set the devices into mixed mode for a mixed VCF, and at the same
time, request the device to reboot as part of the procedure to complete
If you are configuring a non-mixed VCF:
user@device> request virtual-chassis mode fabric local reboot
If you are configuring a mixed VCF:
user@device> request virtual-chassis mode fabric mixed local reboot
A device whose fabric and mixed mode settings are improperly set will not properly join a mixed VCF. You can check the mode settings using the show virtual-chassis mode command.
We recommend that you set the fabric and mixed mode before you interconnect your devices into a VCF to avoid the following issues:
Incurring downtime during VCF formation as the devices reboot to commit the fabric or mixed mode settings.
Manually correcting potential issues related to VCF formation because the device did not immediately join the VCF.
You can, however, use the request virtual-chassis mode fabric local or request virtual-chassis mode mixed local commands to set a device into fabric or mixed mode after interconnecting your VCF.
The fabric and mixed mode settings are automatically updated for a leaf device when it is interconnected into an autoprovisioned or preprovisioned VCF if the device is zeroized or has the factory default configuration. If the fabric or mixed mode settings are automatically changed when a leaf device is interconnected into a VCF, the leaf device automatically reboots in order to properly join the VCF. To avoid this potentially unexpected reboot and impact on VCF operation, as mentioned earlier, for best results, set the fabric and mixed modes and manually reboot each leaf device before cabling it into the VCF.
- After the reboot completes, log in to one of your spine devices that will be configured into the Routing Engine role.
- Specify the preprovisioned configuration mode:
user@device# set preprovisioned
- Associate a member ID with a serial number for each device
in your VCF, and configure the role for each device:
user@device# set member member-id serial-number serial-number role (line-card | routing-engine)
Configure two supported spine devices into the Routing Engine role, and the additional spine devices into the linecard role if your VCF supports three or more spine devices.
Configure your leaf devices into the linecard role.
For instance, if you wanted to preprovision a VCF with twenty member devices that uses member 0 and 1 in the Routing Engine role, members 2 and 3 as spine devices in the line card role, and the remaining devices as leaf devices:
user@device# set member 0 serial-number SERIALNUMB00 role routing-engine
user@device# set member 1 serial-number SERIALNUMB01 role routing-engine
user@device# set member 2 serial-number SERIALNUMB02 role line-card
user@device# set member 3 serial-number SERIALNUMB03 role line-card
user@device# set member 4 serial-number SERIALNUMB04 role line-card
user@device# set member 5 serial-number SERIALNUMB05 role line-card
user@device# set member 6 serial-number SERIALNUMB06 role line-card
user@device# set member 7 serial-number SERIALNUMB07 role line-card
user@device# set member 8 serial-number SERIALNUMB08 role line-card
user@device# set member 9 serial-number SERIALNUMB09 role line-card
user@device# set member 10 serial-number SERIALNUMB10 role line-card
user@device# set member 11 serial-number SERIALNUMB11 role line-card
user@device# set member 12 serial-number SERIALNUMB12 role line-card
user@device# set member 13 serial-number SERIALNUMB13 role line-card
user@device# set member 14 serial-number SERIALNUMB14 role line-card
user@device# set member 15 serial-number SERIALNUMB15 role line-card
user@device# set member 16 serial-number SERIALNUMB16 role line-card
user@device# set member 17 serial-number SERIALNUMB17 role line-card
user@device# set member 18 serial-number SERIALNUMB18 role line-card
user@device# set member 19 serial-number SERIALNUMB19 role line-card
- (Recommended) Configure a virtual management Ethernet
(VME) interface for management of the VCF configuration:
user@device# set interfaces vme unit 0 family inet address /ip-address/mask/
A VME accesses the device in the master Routing Engine role using a management port, so cable management port em0 or em1 on each spine device in your VCF so the VME is available regardless of which spine device assumes the master Routing Engine role. See Connecting a QFX Series Device to a Management Console.
- (Optional) The VCF forwards broadcast, unknown unicast,
and multicast (BUM) traffic among the members of the VCF using multicast
distribution trees (MDTs). By default, the VCF creates MDTs for every
member of the VCF with that member as the root node of an MDT. If
this default MDT creation method is not optimal for your installation,
you can control which members become MDT root nodes.
The set virtual-chassis member member-id fabric-tree-root configuration statement preempts the default method of creating MDTs, and specifies whether a member in a VCF can be an MDT root node. If this statement is configured for one or more members, MDTs are created only with the specified members as root nodes. See Understanding Traffic Flow Through a Virtual Chassis Fabric and fabric-tree-root for more on why you might want to choose this MDT creation method instead of the default method. Note that if you decide to use this option, we recommend that you specify all the spine members (and only spine members) as MDT root nodes.
If desired, configure the spine devices in the VCF to be fabric MDT root nodes. For example, if you are preprovisioning a VCF with members 0 through 3 as spine devices (independent of the role):
user@device# set member 0 fabric-tree-root
user@device# set member 1 fabric-tree-root
user@device# set member 2 fabric-tree-root
user@device# set member 3 fabric-tree-root
This option can also be configured anytime later during VCF operation if you observe internal VCF multicast traffic flow issues with default MDTs.
- Commit the configuration:
- (EX4300 switches in a mixed QFX5100 VCF using 40-Gbps
QSFP+ interfaces as VCPs only) Perform one of the following tasks
to convert the 40-Gbps QSFP+ interfaces into VCPs:
Automatic VCP conversion only works when the interfaces on both ends of a link are not already configured as VCPs.
This step is needed on EX4300 switches using 40-Gbps QSFP+ interfaces as VCPs because the 40-Gbps QSFP+ interfaces on EX4300 switches are configured as VCPs by default.
If you are cabling the EX4300 switch to the spine switch with a DAC cable in the 40-Gbps QSFP+ interface, you must use the request virtual-chassis vc-port set command to manually convert the 40-Gbps QSFP+ interface on the spine device into a VCP, as described in the second bullet below.
Delete the VCP configuration on the 40-Gbps QSFP+ interface using the request virtual-chassis vc-port delete command.
For instance, to delete the VCP configuration on all four QSFP+ interfaces on an EX4300-48T switch:
user@leaf-device# request virtual-chassis vc-port delete pic-slot 1 port 0
user@leaf-device# request virtual-chassis vc-port delete pic-slot 1 port 1
user@leaf-device# request virtual-chassis vc-port delete pic-slot 1 port 2
user@leaf-device# request virtual-chassis vc-port delete pic-slot 1 port 3
Manually configure the 40-Gbps QSFP+ interface on the spine device into a VCP using the request virtual-chassis vc-port set. For instance:
user@spine-device# request virtual-chassis vc-port set pic-slot 1 port 0
user@spine-device# request virtual-chassis vc-port set pic-slot 1 port 1
user@spine-device# request virtual-chassis vc-port set pic-slot 1 port 2
user@spine-device# request virtual-chassis vc-port set pic-slot 1 port 3
- Interconnect the spine device that you configured in the
previous steps to all leaf devices by using supported interfaces that
can be VCPs.
In autoprovisioned or preprovisioned VCFs, the automatic VCP conversion feature is enabled and automatically configures SFP+ and QSFP+ interfaces into VCPs. You do not need to manually configure VCPs.
If you want to configure an SFP+ or QSFP+ interface into a network interface, disable LLDP on that interface.
- Interconnect all other spine devices to all other leaf devices using supported VCP interfaces.
- Install the VCF feature licenses.
For a VCF deployment, two license keys are recommended for redundancy—one for the device in the master Routing Engine role and the other for the device in the backup Routing Engine role.
To purchase a feature license for VCF, contact your Juniper Networks sales representative (https://www.juniper.net/us/en/contact-us/sales-offices). The Juniper sales representative will provide you with the feature license files and license keys. You will be asked to supply the chassis serial number of your switch; you can obtain the serial number by running the show virtual-chassis command.
After obtaining the licenses, follow the instructions in Generating License Keys.