- Creating the cEdge50 and cEdge51 VMs
- Onboarding cEdge50 and cEdge51
- Initial Configuration - non SD-WAN mode
- Copying and modifying Feature Templates
- Creating and Attaching Device Templates
- Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
- Onboarding Verification
Creating the cEdge50 and cEdge51 VMs
Overview
We will be deploying two cEdges in Site 50 via vCenter. cEdge 50 will have a single uplink (Internet), as will cEdge51 (MPLS). Make note of the following information for this section. The IP Addressing will not be used for some of the Network Adapters until later.
SITE ID | SYSTEM ID | VM | Network Adapter | Network | Interface | IP | Gateway |
---|---|---|---|---|---|---|---|
50 | 10.255.255.51 | cEdge50-podX | Network Adapter 1 | Management | GigabitEthernet1 | 192.168.0.50/24 | 192.168.0.1 |
Network Adapter 2 | Internet | GigabitEthernet2 | 100.100.100.50/24 | 100.100.100.1 | |||
Network Adapter 3 | Site50-VPN10 | GigabitEthernet3 | 10.50.10.2/24 | ||||
Network Adapter 4 | Site50-VPN20 | GigabitEthernet4 | 10.50.20.2/24 | ||||
Network Adapter 5 | Site50-VPN30 | GigabitEthernet5 | 10.50.30.2/24 | ||||
10.255.255.52 | cEdge51 | Network Adapter 1 | Management | GigabitEthernet1 | 192.168.0.51/24 | 192.168.0.1 | |
Network Adapter 2 | MPLS50 | GigabitEthernet2 | 192.1.2.22/30 | 192.1.2.21 | |||
Network Adapter 3 | Site50-VPN10 | GigabitEthernet3 | 10.50.10.3/24 | ||||
Network Adapter 4 | Site50-VPN20 | GigabitEthernet4 | 10.50.20.3/24 | ||||
Network Adapter 5 | Site50-VPN30 | GigabitEthernet5 | 10.50.30.3/24 |
Deploying the VM on vCenter
-
Click on the bookmark for vCenter or navigate to the following URL: https://10.2.1.50/ui if connected to the GHI DC and 10.1.1.50/ui if connected to the SJC DC. Log in with the credentials provided for your POD.
-
We should see the vEdges and cEdges from previous sections of the lab deployed.
-
Right click on the host and choose to Deploy OVF Template
-
Choose the Local file option and click on Choose files. Navigate to the SD-WAN images folder and select the file beginning with csr1000v-univer. Click on Next.
-
Change the Virtual Machine name to cEdge50-podX or cEdge51-podX, depending on the VM being deployed and click on Next (where X is your POD number)
Note: We will only use the podX suffix over here to distinguish between different VMs in our Data Center. The rest of the guide will refer to these VMs as cEdge50 and cEdge51.cEdge50 cEdge51 -
Select the host assigned to you (image shown as an example only) and click on Next
Note: If the screen gets stuck over here at Validating then close Chrome and open the vCenter in Internet Explorer, going through the same steps. Deployment should go through. This is a known issue with Google Chrome. -
Review the details shown and click on Next. Select the Small option (1 vCPU and 4 GB RAM) and click on Next
-
Choose the Datastore and click on Next.
-
Populate the VM Networks as per the image given below
Important: Please make sure that these look exactly as shown belowNetworks for cEdge50 Networks for cEdge51 -
Click Next on Customize Template and then Click on Finish to deploy your cEdge50-podX and cEdge51-podX VM
-
Once the VM is deployed, right click cEdge50-podX and/or cEdge51-podX and click Edit settings (image shown as reference only).
-
Click on Add New Device (top right corner) and select Network Adapter to add one (since our deployed VM has only 3 Network Adapters but we will need 5 for our lab). Repeat this step for a total of 5 Network Adapters. This will need to be done for each VM (cEdge50-podX and cEdge51-podX)
One network adapter added on cEdge50 -
After adding two new network adapters from the previous step, click on the drop down next to the first New Network in the list of Network Adapters and click on Browse
- Choose the Site50-VPN20 Network and click on OK. Do the same for the next network adapter, allocating it to Site50-VPN30. Make sure the Network Adapters match with the images below and click on OK again
Warning: The Network Adapter mapping might vary based on the version of cEdge being deployed. Sometimes, trial and error is the easiest way to figure out which Network Adapter maps to which interface on the cEdge
Networks on cEdge50 Networks on cEdge51 - Click on cEdge50-podX and/or cEdge51-podX and choose to power them on. Console in to the devices as well, for the next section. Wait for the cEdges to boot up completely
-
- Onboarding cEdge50 and cEdge51
- Initial Configuration - non SD-WAN mode
- Copying and modifying Feature Templates
- Creating and Attaching Device Templates
- Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
- Onboarding Verification
Onboarding cEdge50 and cEdge51
Initial Configuration - non SD-WAN mode
Use the following information in this section (some of the information will be used later)
SITE ID | SYSTEM ID | VM | Network Adapter | Network | Interface | IP | Gateway |
---|---|---|---|---|---|---|---|
50 | 10.255.255.51 | cEdge50 | Network Adapter 1 | Management | GigabitEthernet1 | 192.168.0.50/24 | 192.168.0.1 |
Network Adapter 2 | Internet | GigabitEthernet2 | 100.100.100.50/24 | 100.100.100.1 | |||
Network Adapter 3 | Site50-VPN10 | GigabitEthernet3 | 10.50.10.2/24 | ||||
Network Adapter 4 | Site50-VPN20 | GigabitEthernet4 | 10.50.20.2/24 | ||||
Network Adapter 5 | Site50-VPN30 | GigabitEthernet5 | 10.50.30.2/24 | ||||
10.255.255.52 | cEdge51 | Network Adapter 1 | Management | GigabitEthernet1 | 192.168.0.51/24 | 192.168.0.1 | |
Network Adapter 2 | MPLS50 | GigabitEthernet2 | 192.1.2.22/30 | 192.1.2.21 | |||
Network Adapter 3 | Site50-VPN10 | GigabitEthernet3 | 10.50.10.3/24 | ||||
Network Adapter 4 | Site50-VPN20 | GigabitEthernet4 | 10.50.20.3/24 | ||||
Network Adapter 5 | Site50-VPN30 | GigabitEthernet5 | 10.50.30.3/24 |
-
We will first console in to the cEdges and set up an IP Address with basic routing to ensure that cEdge50 and cEdge51 can reach vManage and the Jumphost. This is done by issuing
ip route 0.0.0.0 0.0.0.0 192.168.0.1
followed byinterface GigabitEthernet1
and giving an IP Address to the interface throughip address 192.168.0.50 255.255.255.0
for cEdge50 andip address 192.168.0.51 255.255.255.0
for cEdge51. Make sure youno shut
the interface.Additionally, we will be SCP’ing files over to the cEdges (root certificates) from vManage
Configuration for cEdge50
enable conf t interface GigabitEthernet1 ip address 192.168.0.50 255.255.255.0 no shut exit ip route 0.0.0.0 0.0.0.0 192.168.0.1 ip scp server enable username admin priv 15 sec admin line vty 0 4 login local do wr
Configuration for cEdge51
enable conf t interface GigabitEthernet1 ip address 192.168.0.51 255.255.255.0 no shut exit ip route 0.0.0.0 0.0.0.0 192.168.0.1 ip scp server enable username admin priv 15 sec admin line vty 0 4 login local do wr
-
Verify connectivity to the vManage and the JumpHost (IP of the Jumphost might vary) by pinging 192.168.0.6 and/or the IP Address of your Jumphost from the console session of both devices
-
- Onboarding cEdge50 and cEdge51
-
- Copying and modifying Feature Templates
- Creating and Attaching Device Templates
- Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
- Onboarding Verification
Copying and Modifying Feature Templates
Templates are the key configuration components of the Cisco SD-WAN solution. They help with deploying large scale solutions with minimal effort. While there is quite a lot of initial configuration that goes into setting up these templates, their usefulness is highlighted when we’re looking at onboarding multiple devices in a quick and efficient manner, reusing generic templates for devices.
We will make use of the templates that were created for cEdge40, repurposing them for cEdge50 and cEdge51 through the use of Device Specific parameters.
-
On the vManage GUI, navigate to Configuration (the cog wheel icon on the left) => Templates
-
Click on the Feature tab to access the Feature templates. Click on the three dots next to the cEdge_VPN0_dual_uplink template and click on Copy
-
Rename the template to cEdge_VPN0_single_uplink and change the description to cEdge VPN 0 Template for Single Uplinks. Click on Copy. Click on the 3 dots next to the newly copied template and click on Edit. The name, description and VPN should be as shown below
-
Navigate to the IPv4 Route section. A route should be populated there. Click on the pencil icon to edit the route and click on 1 next hop. Make sure the next hop is a Device Variable named vpn0_next_hop_ip_address_0 (should already be the case, from our previous use of the parameter).
-
Click on Update in the lower portion of the screen to update the changes
-
On the Feature Template page, click on the three dots next to cedge-vpn0-int-dual and click on Copy. Enter the Template Name as cedge-vpn0-int-single and a description of cedge VPN 0 Interface Template for devices with a single uplink. Click on Copy
-
Click on the three dots next to the newly copied template and choose to Edit it. Verify the Template Name and Description and update parameters as per the following table
Section Field Global or Device Specific (drop down) Value Template Name NA cedge-vpn0-int-single Description NA cedge VPN 0 Interface Template for devices with a single uplink Basic Configuration Interface Name Device Specific vpn0_if_name Basic Configuration - IPv4 IPv4 Address / prefix-length Device Specific vpn0_ipv4_address Tunnel Tunnel Interface Global On Tunnel Color Device Specific vpn0_if_tunnel_color_value Tunnel Restrict Device Specific vpn0_if_tunnel_color_restrict Tunnel - Allow Service All Global On -
Make copies of the following templates, renaming the template name and description as shown below. No changes need to be made to the newly copied templates
Template to be copied Copied Template Name Copied Template Description cEdge_VPN512_dual_uplink cEdge_VPN512_single_uplink cEdge VPN 512 Template for Single Uplinks cedge-vpn512-int-dual cedge-vpn512-int-single cEdge VPN 512 Interface Template for devices with a Single uplink
We are done with creating feature templates for the initial onboarding of cEdge50 and cEdge51. Notice, this was less work than before since we could simply copy the template already created for cEdge40.
-
- Onboarding cEdge50 and cEdge51
-
-
- Creating and Attaching Device Templates
- Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
- Onboarding Verification
Creating and Attaching Device Templates
The feature templates created in the previous sections are referenced in Device Templates. Devices are then attached to Device Templates which pushes configuration to them, in line with the settings in the Feature templates. The general workflow for templates is given below
-
Go to Configuration => Templates and click on the three dots next to the Device Template named cEdge_dualuplink_devtemp. Click on Copy
-
Change the template name to cEdge-single-uplink and the description to Single Uplink cEdge Device Template. Click on Copy
-
Click on the three dots next to the newly copied template and choose to Edit it. Make sure the details under Transport and Management VPN are populated as below, updating VPN0 and VPN0 Interface templates with the ones we just created. Click on Update once done
Tip: You can create templates on the fly if the template hasn’t already been created. This can be done via the Create Template hyperlink from the drop down menuImportant: To get the option of selecting a Cisco VPN Interface Ethernet as shown below, click on Cisco VPN Interface Ethernet on the right hand side under the Additional Templates portion of the screen. This applies to both the VPN 0 and the VPN 512 sectionsSection Field Sub Field Value (Drop Down) Transport and Management VPN Cisco VPN 0 cEdge_VPN0_single_uplink Transport and Management VPN Cisco VPN 0 Cisco VPN Interface Ethernet cedge-vpn0-int-single Transport and Management VPN Cisco VPN 512 cEdge_VPN512_single_uplink Transport and Management VPN Cisco VPN 512 Cisco VPN Interface Ethernet cedge-vpn512-int-single -
Once created, the Device Template will need to be attached to a Device for it to take effect. Click on the three dots (right-hand side) of the cEdge-single-uplink template and click on Attach Devices
-
We will be presented with a list of devices that can be associated with this template. Choose any two available devices that have not been attached to a template before, making note of the Name (e.g. the device with a name ending in 38F4 has been selected for cEdge50 and the one ending in FBA3 has been selected for cEdge51). Click on Attach
-
This should take you to a page which shows the attached devices. Click on the three dots (right-hand side) next to the cEdge50 Device (whatever name was selected before) and click on Edit Device Template. Also, make note of the cross mark next to the device name, on the left-hand side. This is the point where we need to enter details for the device specific values populated in the Feature Templates.
-
Enter details as per the screenshot below (these can be found in the table referenced at the beginning of this page) and click on Update. Once all the data is entered correctly, there should be a green check mark next to the corresponding device
Details to be entered for cEdge50 Note: We have selected a color for our Tunnel over here. Other devices have tunnels with the default color as of now. When we bring them into vManage mode, a color will be set on them as wellDetails to be entered for cEdge51 Note: The IP Address/Default Gateway of the VPN 0 Interface for cEdge51 is of the MPLS link. The corresponding color has been selected here, setting it to restrict. This means that the tunnel will only build tunnels with TLOCs of the same color -
Click on the entry in the Device List to view the configuration that will be pushed to the device. Notice that the vBond IP and the Organization Name have been populated. These are taken from the vManage Administration => Settings page, where they need to be populated. Click on Configure to configure the device.
Since this isn’t a device that exists (as of now), the configuration push is scheduled for later, when a device is associated with this Device Name (the one ending in 73F2). This is done in the next section
-
- Onboarding cEdge50 and cEdge51
-
-
-
- Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
- Onboarding Verification
Copying the Bootstrap file and converting to SD-WAN IOS-XE mode
We will be generating a Bootstrap file for each cEdge and placing it in the flash of the device we want to bring up. The devices should come up and establish control connections with vManage, along with establishing BFD sessions with other devices. cEdge51 will not establish BFD sessions since it has the restrict keyword and there isn’t any other tunnel with the same color of mpls.
-
Go to Configuration => Devices
-
Identify the Chassis Number that was selected before, while attaching a Device to the Template. In this case, it ended in 38F4 for cEdge50 and FBA3 for cEdge51. Click on the three dots on the right-hand side and click on Generate Bootstrap Configuration for the cEdge50 device. Choose Cloud-Init and uncheck Include Default Root Certificate. Click on OK
-
Download the bootstrap file (will get saved to the Downloads folder by default). It should be a file beginning with CSR…
-
From the Jumphost Desktop, start TFTPD64. Click on Browse and choose the Downloads folder (or wherever the renamed .cfg file has been stored). Make sure the 192.168.0.X IP is chosen from the Server Interface drop down in TFTPD64. Copy the name of the file (beginning with CSR) by going to the file location. You can click on copy in TFTPD64 itself, but the name doesn’t get copied sometimes. Click on show dir to view the files in the currently chosen folder. Clicking on copy copies the highlighted file name, but it is a bit flaky on the newer versions of TFTD64
Tip: On bootup, a cEdge looks for a file on it’s USB port (if a bootable USB drive is connected) and in bootflash:. The file name must match as above for Cloud type devices (i.e. CSR1K). For physical devices, the file name should be ciscosdwan.cfg. If the file is present on the USB drive and in bootflash:, the one in bootflash: takes precedence -
Log in to the CLI of cEdge50 (we can log in via Putty now, using the saved session or by SSH’ing to 192.168.0.50) and issue
copy tftp: bootflash:
. Specify a Remote Host IP of your Jumphost (192.168.0.121 in this case). The source file name should be the one we downloaded for cEdge50 (beginning with CSR) and destination file name should be ciscosdwan_cloud_init.cfg. The file should get copied over to bootflash: successfullycopy tftp: bootflash:
-
Repeat steps 1 to 5 for cEdge51, downloading the bootstrap file for it (starting with CSR) and TFTP’ing it over to cEdge51.
-
Log in to the CLI of vManage (again, via the saved Putty session or by SSH’ing to 192.168.0.6) and issue the following commands to SCP the ROOTCA.pem file over to cEdge50 and cEdge51
vshell scp ROOTCA.pem admin@192.168.0.50:ROOTCA.pem yes admin scp ROOTCA.pem admin@192.168.0.51:ROOTCA.pem yes admin
The last admin over there is the password of cEdge50/cEdge51
-
Go back to the CLI of cEdge50 and cEdge51 and issue
controller-mode enable
from privilege mode. Confirm and this should lead to the devices rebootingcontroller-mode enable
We have completed this section of the lab and will now need to wait for the cEdges to reboot. On rebooting, they should pick up the configuration file from bootflash: and connect to the vManage/vSmarts/other vEdges. This will be verified in the next section.
-
-
-
-
-
-
- Onboarding Verification
Onboarding Verification
-
On the vManage GUI, go to Monitor => Network. You should see cEdge50 and cEdge51 successfully added on vManage.
-
Clicking on cEdge50 or cEdge51 and going to Troubleshooting => Control Connections (Live View) will show us that the cEdges have established control connections with vManage and the vSmarts. We can check this via the CLI
show sdwan control connections
as wellControl Connections for cEdge50 Control Connections for cEdge51 show sdwan control connections
-
Navigate to Dashboards => Main Dashboard and we will see 4 Sites with Full WAN connectivity and 8 WAN Edges
Tip: We should be seeing 5 sites with full WAN connectivity, but one of the WAN Edges (cEdge51) has not been able to establish any BFD sessions yet, hence the site itself doesn’t have full WAN connectivity -
The previous observation can be seen if we click on Full WAN connectivity. Notice that Site 50 is missing from this list. Once we ensure that there are BFD sessions with cEdge51, the issue should be resolved
-
Issue
show sdwan bfd sessions
and we should see that cEdge50 has established BFD sessions, whereas cEdge51 has notBFD sessions - cEdge50 BFD sessions - cEdge51 show sdwan bfd sessions
At this point, we have completed onboarding verification