The Umbrella Documentation Hub

Welcome to the Umbrella documentation hub. Here you'll find access to all of our Cisco Umbrella user guides.

Get Started    

Deploy VAs in KVM

Two virtual appliances (VAs) are required per Umbrella site. It is critical that these VAs are not cloned or copied in any way. Each VA must be set up and configured manually.

Prerequisites

  • A Linux system with qemu-utils package installed for creating the qcow2 files
  • Only VAs running 2.6 or above can be deployed in KVM
  • VA deployment is supported only on KVM on supported Red Hat Linux and Ubuntu Linux versions

Procedural Overview

  1. Create the qcow2 files for KVM.
  2. Launch the virtual appliance in KVM.

1. Create the qcow2 files for KVM

  1. Navigate to Deployments > Configuration > Sites and Active Directory and click Download.
  1. Click Download for VA VMWare ESXi.

Umbrella generates and downloads an .OVA template unique to your deployment.

  1. Extract the downloaded OVA file to retrieve the vmdk files.
  2. Use the qemu-img convert commands to convert each of the vmdk files to the qcow2 format.
    qemu-img convert -f vmdk -O qcow2 forwarder-va.vmdk forwarder-va.qcow2
    qemu-img convert -f vmdk -O qcow2 dynamic.vmdk dynamic.qcow2
  3. Copy both the qcow2 files on your Linux system running KVM.
    Note: Deploying the VA results in a modification of the source qcow2 files. Thus, you must copy the qcow2 files each time you deploy a new VA.

2. Launch the Virtual Appliance on KVM

  1. Open the Virtual Machine Manager on your Linux system running KVM and click Create a new virtual machine.
  1. In the first step of the wizard, choose Import existing disk image.
  1. Provide the existing storage path to your forwarder-va.qcow2 and set the OS type to Linux and click Forward.
  1. Set the memory and CPU settings to at least 1 CPU and 1 GB RAM and click Forward.
  1. In the last step of the wizard, select Customize configuration before install and then click Finish.
  1. Select Add Hardware.
  1. Select Storage, add or create custom storage, add the dynamic disk, and then click Finish.
    You should then see two disks.
  1. Click Begin installation to create the VA.
  1. If your network supports DHCP, the VA will get auto-configured with a DHCP IP address and will register to Umbrella using this IP. You can configure the VA on KVM through two mechanisms:
  • Press Ctrl+B on the VA console and entering the Configuration mode.
    Or
  • Initiate an SSH connection to the DHCP IP—this IP can be retrieved from the Umbrella dashboard—and enter Configuration mode.

You can now configure the VA. For information about configuring VAs, see Configure Virtual Appliances.


Deploy VAs in Google Cloud Platform < Deploy VAs in KVM > Configure Virtual Appliances

Updated about a month ago


Deploy VAs in KVM


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.