Skip to content

Verity VM Installation (VMware 7.0.3)๐Ÿ”—

Introduction๐Ÿ”—

The Verity management and orchestration system is comprised of two functional components, both of which are instantiated as Virtual Machines (VMs). This document describes the installation and configuration of these VMs within a VMWare ESXi server.

Resource Calculator๐Ÿ”—

Use the Verity VM Resource Calculator to determine system resources.

Virtual Machine Overview๐Ÿ”—

Verityโ€™s two VM functional components:

Virtual Machine Function
Virtual Network Commander (vNetC) Orchestration logic, GUI hosting, northbound RESTful API, and databases.
Software Defined LAN Controller (SDLC) The SDLC VM is comprised of a series of containers that map one-to-one to the managed switch devices. Network discovery, device provisioning, and network assurance. The SDLC serves as the abstraction layer between the managed switch and the vNetC by translating the native management protocols into the vNetCโ€™s NETCONF interface and Yang model.

Virtual Machine Topology๐Ÿ”—

Below is the basic VM and hardware topology for reference:

Recommended Network Management Architecture

Each system requires a management subnet that can support 4 system IP addresses as well as 3 IP addresses per managed switch. The breakdown is as follows:

IP address Allocations for Management Component Allocation
Verity System components vNETC LAN side, SDLC, ACS, GuiA 4 Static Addresses
Managed Switches Verity Switch Controller 1 Dynamic Address per switch
Managed Switches Switch in ZTP Process 1 Dynamic Address per switch
Managed Switches Switch post ZTP Process 1 Static Address per switch

The orchestration platform (vNETC) is configured on the customerโ€™s network with one static IP address to be accessed by users.

The following diagram shows the recommended management network architecture. Variations are possible based on individual customerโ€™s network needs. A second diagram follows with a version showing only one connection to the vNETC.


Prerequisites๐Ÿ”—

  1. vNetC
    1. Resolvable, fully qualified domain name
    2. Static IP address, gateway, DNS servers
    3. Valid Verity license
  2. SDLC
    1. IP addressing per table above. NOTE: Must be routable to the vNetC
  3. Controllers (within SDLC)
    1. IP Addressing per table above. NOTE: The diagram above shows that the controllers are bridged to NIC 2 of the SDLC. The IP MUST be on the same VLAN/subnet as the SDLC.
  4. ESXi
    1. Compute resources meeting Verity requirements based on the number of switches being managed. See Resource documentation for computing CPU and memory needs.
    2. Virtual Switch
      1. The vNetC and SDLC should be on the same virtual switch in ESXi or at minimum they must be routable.
      2. Your system requires promiscuous mode to be set to enabled.
  5. Routable or switched network between Verity components and managed switching devices
    1. If using a router or firewall between Verity and the switches, the following ports must be allowed to pass.
      1. Port 8080 for gNMI
      2. Port 80 - HTTP
      3. Port 443 - HTTPS
      4. Port 22 - SSH

Obtaining the vNetC and SDLC VM Images and Files๐Ÿ”—

Obtain the following files from BE Networks:

Description Filename Example File Type Notes
vNetC VM Image vNetC-x_x_x_x.ova VMware OVA Resources including vCPU and memory should be adjusted based on iVN resource needs documentation. Networking will need to be altered to the correct virtual switch names used in the server
vNetC โ€œcoreโ€ Upgrade core-x_x_x_x- full.tar tarball vNetC needs to be updated via GUI SD-Admin immediately after configuration and boot
SDLC VM Image SDLC-x_x_x_x.ova VMware OVA Resources including vCPU and memory should be adjusted based on iVN resource needs documentation. Networking will need to be altered to the correct virtual switch names used in the server
Firmware Upgrade Package firmware-x_x_x_x.tar Binary SDLC should be upgraded via web page immediately after configuration and boot
License license.cms or sitexxxxx.tar License file Is uploaded using GUI

Create the vNetC Virtual Machine๐Ÿ”—

  1. Go to Virtual Machines.
  2. Click Create/Register VM.
  3. In the window that appears select Deploy a virtual machine from an OVF or OVA file.
  4. Click Next.
  5. Enter a name for the VM and upload the vNetC VM Image OVA file via the prompt that says Click to Select file or drag/drop.
  6. Click Next.
  7. Select the desired data store options. Click Next.
  8. Set the Deployment options โ€“ Network mappings to the correct Port Group.
  9. This Port Group must be set to promiscuous mode.
  10. Click Next.
  11. Review the settings and if they are correct, click Finish.
  12. The VM creation process will start. When the process completes the progress bar in Recent tasks at the bottom of the screen will say Completed Successfully.

Configure the vNetC from the Console๐Ÿ”—

This step requires you to configure the vNetC with an IP address and Fully Qualified Domain Name (FQDN). To do so, you need to open the VM console.

  1. Select your VM under the Virtual Machine column and click Console/Open browser console.
  2. The VM console appears. The vNetc initialization may take several minutes. While waiting you can press Enter and wait for login prompt.
  3. Login to the vNetC with username root and password vnc1234.
  4. Enter a new password if prompted (new password = vnc1234). If not prompted for the password, you can continue to use the default password or change it with the passwd command.
  5. Run the administration application from the shell by typing ns_admin and pressing Enter.
  6. You are prompted to enter a web user interface admin account password (ex. admin). Document the password you choose as it will be required for GUI authentication later in the process. It is very important that you remember the password!
  7. Press Enter when complete.
  8. In the Admin Menu, select Network Configuration.
  9. Press Enter.
  10. Select FQDN (Fully Qualified Domain Name). Press Enter and set to the desired Fully Qualified Domain Name. If the field is prepopulated, it is required that you replace the default text with your own FQDN.
  11. Verify that WAN IP DHCP is disabled. If WAN IP DHCP is enabled, disable it using the menu.
  12. Select WAN Static IP Settings, press enter.
  13. Enter the following information:
    1. IPv4 Address and subnet in CIDR format (x.x.x.x/#)
    2. Default Route (Gateway)
    3. DNS Server 1 & DNS Server 2 (optional)
  14. Return to the network configuration menu.
  15. Save Settings.
  16. Follow the prompt and the VM will reboot with the new settings configured.

Install the License (required) and Upgrade to the Latest vNetC Core Software๐Ÿ”—

  1. Upgrade the vNetC Core software via the vNetC Web Administration.

  2. Use Chrome Web Browser to access the vNetC IP address that was just configured.

  3. At the login prompt enter username admin and the administration password configured in the menu during installation. These are the credentials you entered in step 3 of Configure the vNetC from the Console.
  4. From the Admin web page, select the Software Packages and Licensing section by double clicking and zooming in.
  5. Select License.
  6. When the window appears, record the information on the Licensing tied to line. Provide this information to BE Networks to obtain your license file.
  7. After you obtain your license.cms file you are required to upload it to the application. Use the drag and drop palette to upload the file or browse for the file. The license file may also be embedded in a \<filename>.tar file and this can also be directly imported and the system will extract the license.cms file.
  8. After you upload the file make sure a success message is presented.
  9. After you upload the license, a tab titled Verity appears at the upper right of the screen (refresh the page if you do not see the tab).
  10. Click Verity and let the screen populate.
  11. After the Verity window has fully completed populating select the Admin tab.
  12. Select Software Packages and Licensing and click vNetC Packages.
  13. Using the Browse Files (or drag and drop) field, import the vNetC Core Upgrade file provided by BE Networks.
  14. When the process is complete you are presented with a success message.
  15. Click the Deploy button.
  16. When prompted to continue, click Yes. The software updates.

Temporary Error Message

You may see an error titled Fatal Error WebSocket Error: Connection lost -2 appear, this is normal. The browser may temporarily say that the site cannot be reached. When the process is done the landing page will render.

  1. Return to the SD ADMIN Menu on the console (If you are logged out, log back in and use the ns_admin menu command).
  2. Select 3 - SD-LAN Features.
  3. Select 8 โ€“ Place system in Data Center mode. Check that the field is set to ENABLED.
  4. Select 9 - >>> SAVE SETTINGS <<< to Save Settings.
  5. Select 10 - Return to VNetC Administration Menu menu
  6. Exit from ns_admin by selecting 9 exit but do not logout.
  7. In Chrome, select the Verity button and verify that the system is in Data Center Mode. You may get a prompt saying to upgrade versions. Click the accept button. Also click the tan GUIA Alert growl to clear. Display should look like the following:
  8. Go back to the VNC Console in VMware and type poweroff in the CLI. This will cleanly shutdown the VNC.

Congratulations

You have now successfully installed the VNetC VM.


Create the SDLC Virtual Machine๐Ÿ”—

  1. Go to Virtual Machines. Click Create/Register VM.
  2. In the window that appears select Deploy a virtual machine from an OVF or OVA file.
  3. Click Next.
  4. Enter a name for the VM and upload the SDLC VM Image OVA file via the prompt that says Click to Select file or drag/drop. Click Next.
  5. Select the desired data store options. Click Next.
  6. Set the deployment options. Click Next.
  7. Review the settings and if they are correct, click Finish.
  8. The VM creation process will start. Wait until you see the message Completed Successfully.

Configure the SDLC from the Console๐Ÿ”—

The SDLC must be configured with a Static IP address and the vNetC FQDN.

  1. Select the SDLC from the VMWARE ESXi interface and click the Console tab.
  2. Select Open browser console.
  3. The console appears.

    DHCP Error Messages

    During the following process DHCP errors may appear. These can be ignored.

  4. Press Enter to get the login prompt, enter username: admin and password: admin.

  5. At the command line interface (CLI) press Enter to see a list of options.
  6. Select Admin and press Enter.
  7. Type Wizard and press Enter.

    Prompt Answer
    Do you want to modify hostname Yes
    hostname Type SDLC (uppercase)
    hostname This is to confirm to change the hostname. Yes
    Advertise the Site Management Vlan? No
    Use DHCP for management uplink configuration No
    MGMT IP Enter management IPIf vNetC and SDLC (GuiA, ACS and DHCP) are on different subnets, it is recommended to have three consecutive static IP addresses on the same subnet for GuiA, ACS and DHCP. However, if vNetC is on the same subnet as GuiA, ACS and DHCP, it is recommended to use four sequential IP addresses.
    Default Gateway in CIDR format Enter the default gateway IP address
    ACS IP Yes
    GuiA IP Yes
    DNS server Enter DNS server IP
    Comma Separated NTP Server(s) Enter vNetCโ€™s IP address
    vNetC FQDN or IP The vNetC IP address
    ACS connection path as URL No
    ACS FQDN or IP Press Enter
    ACS connection protocol choose http or https
    ACS connection port number Press Enter
    VCF connection path URL No
    VCF FQDN or IP Press Enter
    DHCP on management VLAN No
    Save the configuration? Yes
  8. Reboot is required for any changes to take effect. In the console, type reboot and press Enter.


Power On the vNetC๐Ÿ”—

  1. In the VMware ESXi interface power on the vNetC. This takes a few minutes.
  2. Open the GUI and select Admin.
  3. Select the Settings palette.
  4. Set up the Management VLAN used to access the Management network. This field is required even if your management switches are using untagged connections.
  5. For Permissible IP Address Ranges on Managed Devices enter the relevant IP address range (IP address and Mask).

    Permissible IP Range Requirement

    The range entered MUST include SDLC components.

  6. Click the Save button to save your settings. ().

  7. Go to the Verity tab. If a beige notification box appears in the lower right, click it to close it.
  8. Wait until the process is finished. The application landing page resembles the image below when all processes have been completed.

Update SDLC๐Ÿ”—

  1. Double click the Admin tab.
  2. Double click Software Packages and Licensing.
  3. Double click Firmware Packages.
  4. Select and place the SDLC Binary Firmware Upgrade firmware file on the Drag & Drop area or use the Browse Files button to select the file.
  5. When uploaded, you are prompted with a green success message.
  6. Deploy the firmware by clicking the Deploy button.
  7. A validation message appears. Click Yes.
  8. Wait while the package is applied.
  9. Click the Verity tab.
  10. Double click the VNFs window.
  11. Double click the SDLC section.
  12. Double click the box with the title of SW Version.
  13. Set the Target Package field to the Firmware version and uncheck the box titled Disable Upgrades.
  14. Click the Save button ().
  15. Click Yes to the validation message.
  16. In the window that appears titled GuiA Disconnected, click the icon to refresh.
  17. Let the process complete.
  18. When the window appears the initial state of System Applications are offline. This is expressed by their red LED icons.
  19. When the System Applications come online their LED icons render green. This may take up to 5 minutes.

Site Certificate๐Ÿ”—

In order to avoid having to accept the self signed certificate delivered with the system you will need to add a server.pem file to the system. This will need to be obtained from your internet domain administrator.

  1. Click on the Admin tab.
  2. Select Certificate Management box.
  3. Click on vNetC Server Certificate box.
  4. Drag and drop the server.pem file.

Congratulations

Verity has been successfully installed. Treat yourself to an iced coffee!