Skip to content

Installing on VMware vSphere hypervisors

Use this procedure to install the Zenoss Cloud Collector virtual appliance as a guest system on a VMware vSphere hypervisor. The virtual appliance has been tested on vSphere versions 5.1, 5.5, 6.0, and 6.5.

To perform this task, you need:

This procedure is based on vSphere Web Client 6.5. The steps might be different with other versions of the vSphere Client.

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

  2. Display the Zenoss Cloud files.

  3. Download the Zenoss Cloud Collector OVA file.

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

  4. Use the vSphere Client to log in to vCenter as root, or as a user with superuser privileges, and then display the Home view.

  5. In the top navigation bar, choose Actions > Deploy OVF Template.

    1. Use panels in the Deploy OVF Template wizard to select the OVF package.

      To choose the package from a drive on your workstation or network share, browse to the location and choose the OVA file.

      Click Next.

    2. Select name and location: Specify a name for the OVF, select a datacenter or folder as the deployment location, and then click Next.

    3. Select a resource: Select the host, cluster, or other resource on which to run the deployed template, and then click Next.


      On releases of vSphere 6.5 before update 1d, the import may fail at this step due to a known bug. To work around this issue, see Workaround for vSphere bug

    4. Review details: Verify the template details, and then click Next.

    5. Select storage: In Select virtual disk format, choose Thick Provision, accept defaults for other fields, and then click Next.

    6. Select networks: Accept defaults and click Next.

    7. Ready to Complete: Verify the deployment settings, and then click Finish.

  6. On the new virtual machine's Getting Started tab, click Power on virtual machine.

Workaround for vSphere bug

Releases of vSphere 6.5 before update 1d are unable to import OVA packages that include a compressed manifest file due to a known bug.

Follow these steps to work around the problem and import the virtual appliance:

  1. On your workstation, extract the files in the virtual appliance package into a folder, with a utility such as WinRAR or 7zip.

  2. In the folder, delete the manifest file (with the .mf extension).

  3. Repeat step 5a of the procedure in the preceding section. Instead of selecting the OVA file, select both of the remaining files in the folder (with .ovf and .vmdk extensions).

    Both files must be selected for import at the same time.

  4. Continue with the remaining steps of the install procedure.


    You may need different permissions to adminstrate a VM that is not imported from an entire OVA package.

Next step

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