Skip to content

Installing on a Linux KVM hypervisor

Use the procedures on this page to install the Zenoss Cloud Collector virtual appliance as a guest system on a Linux Kernel-based Virtual Machine (KVM) hypervisor. The procedures have been tested on RHEL/CentOS hypervisor hosts.


To perform these procedures, you need:

  • A KVM hypervisor host with Virtual Machine Manager (virt-manager) installed and a bridge network adapter configured.

    For more information about configuring a bridge network adapter, refer to KVM documentation.

  • Permission to download files from

    Customers can obtain permission by filing a ticket at the Zenoss Support site.

  • Optionally, a VNC client and server, to enable GUI access to the hypervisor host.


To install on a KVM hypervisor host, first download the QCOW file and then install the virtual machine.

Downloading the QCOW file

Follow these steps:

  1. In a web browser, navigate to, and then log in.

  2. Display the Zenoss Cloud files.

  3. Download the Zenoss Cloud Collector QCOW distribution file.

    In the preceding example, the filename is zenoss-collector-363.qcow2.tgz. (The version number may be greater than 363.)

    Make sure you have the latest distribution

    Always use the latest QCOW2 distribution file. For example, if you downloaded a QCOW2 file for a previous installation, please verify that its file name is identical to the latest file available on before proceeding. New collectors should always be installed with the latest QCOW2 distribution file.

  4. Copy the QCOW distribution file to the hypervisor host.

    For example, to copy the file to the /tmp directory, enter the following command. Substitute the hostname or IP address of the KVM hypervisor host for KVM_HOST:

    scp zenoss-collector-*.tgz root@KVM_HOST:/tmp

Installing the virtual machine

Follow these steps:

  1. Log in to the KVM hypervisor host as root, or as a user with superuser privileges.

  2. Extract the QCOW image from the distribution file.

    For example, if the file is located in /tmp, enter the following commands:

    cd /tmp; tar --checkpoint=250000 -xzf zenoss-collector-*.tgz

    The tar command displays progress information similar to the following:

    tar: Read checkpoint 250000
    tar: Read checkpoint 500000
    tar: Read checkpoint 750000
    tar: Read checkpoint 1000000
    tar: Read checkpoint 1250000
    tar: Read checkpoint 1500000
    tar: Read checkpoint 1750000
    tar: Read checkpoint 2000000
    tar: Read checkpoint 2250000
    tar: Read checkpoint 2500000

    On success, a new file is created. The new file's name is identical to the distribution file's name, less the .tgz extension.

    File name extension required in OpenStack environments

    If you are installing in an OpenStack environment, add the .img extension to the QCOW file name. For example:

    mv zenoss-collector-10.qcow2 zenoss-collector-10.qcow2.img
  3. In Virtual Machine Manager, select File > New Virtual Machine.

  4. At Step 1 in the New VM dialog box, select Import existing disk image, and then click Forward.

  5. At Step 2 in the New VM dialog box, specify the disk image and operating system.

    1. In the Provide the existing storage path field, enter the path of the QCOW file, or use the Browse button to locate the file.

      For OpenStack environments, append the .img file extension first (step 2).

    2. From the OS type list, select Linux.

    3. From the Version list, select Ubuntu 20.04.

    4. Click Forward.

  6. At Step 3 in the New VM dialog box, specify the CPU and RAM resources for the virtual machine.

    For more information about collector virtual appliance requirements, see Resource requirements.

  7. At Step 4 in the New VM dialog box, specify the name of the virtual machine and a bridge adapter.

    1. In the Name field, edit the default name, if desired.

      The virtual machine name does not affect collector functionality.

    2. From the Network selection option, select the bridge adapter that maps to an interface that is on the LAN to monitor.

    3. Click Finish.

Next step

Configure the login password and connect to a Collection Zone (Initializing a collector appliance).