Add Switches to an Existing SD-LAN Site
From CSO Release 5.1.1 onward, you can add one or more EX Series switches to an existing SD-LAN site. Physical, standalone EX Series switches and EX Series Virtual Chassis are supported.
Figure 1 shows an SD-LAN site, with multiple EX Series switches, managed by CSO.

To add a switch to an existing site:
- Select Resources > Site Management.
The Sites page appears.
- Do one of the following:
- Select the site to which you want to add the switch.
- Click Add > Add Switch.
The Add Switch page appears.
- Click the Site-Name link of the site
(to which you want to add the switch) in the Sites column.
The Site-Name page appears.
- On the Devices tab, click Add Switch.
The Add Switch page appears.
- Click the Site-Name link of the site
(to which you want to add the switch) in the Sites column.
- Complete the configuration according to the guidelines
provided in Table 1.
Note Fields marked with an asterisk (*) are mandatory.
- Review the configuration from the Summary tab.
- (Optional) Click the Edit links within the summary to go directly to a specific page of the wizard and modify the configured settings.
- Click OK to add the switch to the site.
The site activation process is initiated and the Site Activation: Site-Name page appears displaying the progress of the steps executed for activating the switch. If you add one or more EX Series switches, the progress of the steps executed for activating each switch is displayed.
If the Zero Touch Provisioning (ZTP) toggle button is enabled (default), CSO pushes the stage-1 and stage-2 configurations and provisions the switch.
This process occurs immediately after the activation process, for which you entered the activation code or selected auto-activation.
Note Stage-1 configuration is the initial configuration that allows basic connectivity to a device, which is pushed to the device.
The configuration that is pushed to the device after it has connected to CSO is called stage-2 configuration.
If you disabled the Zero Touch Provisioning (ZTP) toggle button, you must manually configure the stage-1 configuration (as provided by CSO) on the switch.
To manually configure the stage-1 configuration:
- On the Site Activation: Site-Name page, the Click to copy stage-1 configuration link appears after the Prestage Device step completes successfully.
- Click the Click to copy stage-1 configuration link.
The stage-1 configuration page appears displaying the stage-1 configuration to be copied to the EX Series device.
- Copy the stage-1 configuration and log in to the console of the EX Series switch.
- Enter the configuration mode, paste, and commit the configuration.
After the stage-1 configuration is committed, the switch has the outbound SSH configuration to connect with CSO.
CSO then provisions the switch.
Table 1 provides guidelines on using the fields on the Add Switch page.
Table 1: Fields on the Add Switch Page
Field | Description |
---|---|
Device Profile | |
Device Name | Enter a name for the switch. You can use alphanumeric characters and hyphen (-). The maximum length allowed is 15 characters. |
Device Type | Select the type of switch—EX2300, EX3400, EX4300, EX4600, and EX4650. |
Device Model | Select the model for the switch you specified in the Device Type field. The models vary in the number and type of ports the switch contains. For example, If you selected EX3400, select a model such as EX3400-24P, EX3400-48P, EX3400-24T among others. |
Switch Details | |
Virtual Chassis | Click the toggle button to enable or disable (default) adding the switch as a Virtual Chassis. If you enable this toggle button, you must select the method of provisioning the Virtual Chassis. Note:
|
Serial Number | If you disabled the Virtual Chassis toggle button, specify the serial number of the physical switch. You can either view the serial number on the label that is present on the rear panel of the switch or log in to the CLI of the switch in operational mode and enter show chassis hardware. The serial number is a case-sensitive, alphanumeric string. |
Method | Select the method of provisioning the Virtual Chassis:
For both these methods, ensure that:
|
Master Serial Number | If you selected Auto Provisioning, enter the serial number of the Primary (from the fully-formed Virtual Chassis). To obtain the serial number, log in to the CLI of any device that is part of the fully-formed Virtual Chassis, in operational mode, and enter show virtual-chassis. The list of the member devices in the Virtual Chassis, along with the serial number and role appear. The primary device is indicated as Master under Role. Alternatively, you can view the serial number on the barcode sticker, which is on the rear-panel of the switch. |
Member <member-number> | If you selected Pre Provisioning, enter the serial numbers of all the devices (from the fully-formed Virtual Chassis or based on what roles you decide to assign each Virtual Chassis member), and also select the device type and model from the list. Note:
Click the Add (+) icon to add a member device or the Remove (-) icon to remove a member device. For information on the number of member devices that can be added, see Table 3. Note: The Routing Engine check box corresponding to Member 0 is always selected, indicating that Member 0 always acts as the primary. To select a member device as backup, click the Routing Engine check box corresponding to that member device; the remaining member devices act as line cards. |
Zero Touch Provisioning | Click to enable or disable ZTP on the switch. If you disable ZTP, you must manually copy and paste the Stage-1 configuration on the switch during site activation. See Step-by-Step Procedure for details Note:
|
Boot Image | Select the boot image from the list if you want to upgrade the image for the switch. The boot image is the latest device image that is uploaded to the image management system. The boot image is used to upgrade the device when the CSO starts the ZTP process. If the boot image is not provided, then the device skips the automatic upgrade procedure. The boot image is populated based on the device template that you have selected while creating a site. Note: This option is not available for a Virtual Chassis. To provision a Virtual Chassis in CSO, you must manually upgrade the image to either JUNOS 18.4R2.7 or 18.4R3.3. |
Auto activate | Click the toggle button to enable or disable automatic activation of the switch. When you enable this field, zero-touch provisioning of the switch is automatically triggered when the device communicates with CSO. Note: You must physically connect the switch to the CPE and power it on for the switch to be automatically activated when you enable this option. |
Activation code | When the Auto activate field is disabled, enter the activation code to be used for manually activating the switch. For information, see Manually Activating a Switch. |
Port Profile You are directed to this page only if you have added a physical switch or a preprovisioned Virtual Chassis. If you have added an autoprovisioned Virtual Chassis; you are automatically directed to the Summary page. This is because, in the case of autoprovisioning, port profiles can be configured only after provisioning the Virtual Chassis. | |
Access Profiles List | Displays the access profile configured on the device from the Access Profiles page (Configuration > SD-LAN > Access Profiles). For details of the fields displayed on the Access Profiles List table, see About the Access Profiles Page. |
Interface List | Displays the list of interfaces present on the device. You can assign the ports to a port profile and VLAN from here. For more information on the fields displayed in the Interface List table, see Table 2. Optional: To assign the ports to a port profile and VLAN:
Optional: Click the Search icon to search for a specific port in the list. |
Table 2 describes the fields on the Interface List table.
Table 2: Fields on the Interface List Table on the Port Profile Page
Field | Description |
---|---|
Port | Name of the port. |
VLAN ID | ID of the VLAN configured on the port. If the port is a trunk port, all the VLAN IDs configured on the port are displayed. |
Native VLAN | ID of the VLAN configured to accept untagged frames. |
Port Profile | Port profile used for configuring the port. If the port is configured manually, the column displays Manually Configured. |
Table 3 lists the supported device types, combinations in the non-mixed mode, and the total number of members, supported by each device type, in a Virtual Chassis.
Table 3: Supported Device Types, Modes, and Number of Members Allowed in a Virtual Chassis
Device Type | Non-mixed Virtual Chassis Support | Number of Members Allowed in the Virtual Chassis |
---|---|---|
EX2300 | Combination of the same or different models of EX2300 switches. | Up to 4 members. |
EX3400 | Combination of the same or different models of EX3400 switches. | Up to 10 members. |
EX4300 | Combination of the same or different models of EX4300 switches. | Up to 10 members. |
EX4600 | Combination of the same or different models of EX4600 switches. | Up to 10 members. |
EX4650 | Combination of the same or different models of EX4650 switches. | Up to 2 members. |
Before you autoprovision or preprovision a Virtual Chassis in CSO, ensure that the Virtual Chassis is setup.
To setup a Virtual Chassis for autoprovisioning:
- Decide the number of member devices in the Virtual Chassis.
- If you’ve added EX3400, EX4300, EX4600, or EX4650
devices as Virtual
Chassis, interconnect all the corresponding member devices through
Virtual Chassis ports (VCPs).
If you’ve added EX2300 devices as Virtual Chassis, configure the 10-Gbps Ethernet ports as VCPs manually (through CLI) and interconnect the member devices.
Note At this point, do not power on any member devices in the Virtual Chassis.
- Decide which
member device acts as the primary and power on only this device
first.
Note Remember the serial number of the primary device in the Virtual Chassis. This serial number is required during the site activation workflow to add this Virtual Chassis in CSO.
For ZTP to be successful, the primary device should always be designated as Member 0. You must specify the same serial number in the Member 0 field in CSO.
- Wait until the primary device completes booting.
After booting is complete, the LCD panel on this device displays a menu that includes the JUNOS OS version loaded on the device, status of VCPs, status of power supplies, and so on.
- Power on the remaining member devices one after the other.
- Wait until all the member devices complete booting.
After booting is complete, you can confirm that the Virtual Chassis is fully formed when all the LEDs on the VCPs are ON.
- Connect the primary and backup device to the Internet through the management port or uplink port.
- Verify the connectivity from the primary device to CSO or to any host on the Internet by using ping or telnet to Juniper redirect server on port 443.
To setup a Virtual Chassis for preprovisioning:
- Decide the number of member devices in the Virtual Chassis.
- If you’ve added EX3400, EX4300, EX4600, or EX4650
devices as Virtual
Chassis, interconnect all the corresponding member devices through
Virtual Chassis ports (VCPs).
If you’ve added EX2300 devices as Virtual Chassis, configure the 10-Gbps Ethernet ports as VCPs manually and interconnect the member devices.
Note At this point, do not power on any member devices in the Virtual Chassis.
- Decide which member device acts as the primary and which member device acts as the backup.
- Of the two devices, power on the device that you want
to select as the primary (Member 0), and wait until it completes booting.
After booting is complete, the LCD panel on this device displays a menu that includes the JUNOS OS version loaded on the device, status of VCPs, status of power supplies, and so on.
Note Remember the serial numbers of all the devices in the Virtual Chassis. These serial numbers will be needed in the site activation workflow to add this Virtual Chassis in CSO.
For ZTP to be successful, the primary should always be designated as Member 0. You must specify the same serial number in the Member 0 field in CSO.
- Power on the device that you want to select as the backup
and wait until it completes booting.
After booting is complete, the LCD panel on this device displays a menu that includes the JUNOS OS version loaded on the device, status of VCPs, status of power supplies, and so on.
- Power on the remaining member devices one after the other.
- Wait until all the member devices complete booting.
After booting is complete, you can confirm that the Virtual Chassis is fully formed when all the LEDs on the VCPs are ON.
- Connect the primary and backup device to the Internet through the management port or uplink port.
- Verify the connectivity from the primary device to CSO or to any host on the Internet by using ping or telnet to Juniper redirect server on port 443
Now that the Virtual Chassis is setup, proceed to add the Virtual Chassis in CSO. See the Switch Details section in Table 1 for details.