Skip to content

Installing in an Oracle Cloud Infrastructure region

Use the procedures on this page to install the Zenoss Cloud Collector virtual appliance as a managed virtual machine in an Oracle Cloud Infrastructure (OCI) compartment.

Prerequisites

To perform this task, you need:

  • An OCI tenant with one or more compartments in the root compartment.

  • An OCI tenant login with sufficient privileges to upload files in Object Storage and to deploy a VM.Standard2.2 instance shape in your preferred region.

  • The public key of a public/private key pair, in PEM format, for establishing an SSH or VNC connection.

  • Permission to download files from delivery.zenoss.com.

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

Procedures

Follow these steps to install in an OCI compartment:

  1. Download the appliance package file

  2. Upload the appliance package to an OCI storage bucket

  3. Import an image from the appliance package

  4. Create a virtual machine with the image

  5. Create a console connection to the virtual machine

Downloading the appliance package file

Follow these steps to download the package file from the Zenoss Delivery site:

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

  2. Display the Zenoss Cloud files.

  3. Download the Zenoss Cloud Collector QCOW2 distribution file.

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

    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 delivery.zenoss.com before proceeding. New collectors should always be installed with the latest QCOW2 distribution file.

Uploading the appliance package to an OCI storage bucket

Follow these steps to upload the appliance package file to an OCI storage bucket:

  1. Log in to the OCI web interface.

    The web interface displays the last page you visited during your previous session.

  2. From the main menu, select Object Storage > Object Storage.

  3. Under List Scope in the left column, select the compartment in which the virtual appliance will be deployed.

  4. In the main column, select or create a bucket for the appliance package file.

  5. On the Bucket Details page, click Upload Object to upload the appliance package file.

    Warning

    The OCI web interface may hang during the upload. If you are unable to upload the file using the web interface, use the OCI command-line interface to upload the file.

Importing an image from the appliance package

Follow these steps to import a disk image from the appliance package file:

  1. On the Bucket Details page, click the Details option from the menu of the uploaded appliance package.

  2. In the Object Details dialog box, highlight the object URI and copy it.

  3. From the OCI main menu, select Compute > Custom Images.

  4. On the Compute > Custom Images page, click Import Image, and then populate the Import Image dialog box.

    1. From the CREATE IN COMPARTMENT list, select a compartment for the new image.

    2. In the NAME field, enter a name for the image.

      Zenoss recommends using the name of the appliance package file, including the version number. For example, zenoss-collector-1.

    3. From the OPERATING SYSTEM list, select LINUX.

    4. In the OBJECT STORAGE URL field, paste the URI you copied in step 2.

    5. From the IMAGE TYPE list, select QCOW2.

    6. From the LAUNCH MODE list, select PARAVIRTUALIZED MODE.

    7. Optional: In the TAGS area, add tags.

  5. At the bottom of the Import Image dialog box, click IMPORT IMAGE.

Creating a virtual machine with the image

Follow these steps to create a virtual machine from the imported disk image:

  1. From the Compute > Custom Images page, click the link of the newly-imported disk image.

  2. On the Image Details page, click Create Instance.

  3. On the Create Compute Instance page, specify the virtual machine to create.

    1. In the Name your instance field, provide a name for the instance.

    2. In the Select an availability domain for your instance area, select an availability domain for the instance.

    3. In the Choose instance type area, select Virtual Machine.

    4. In the Choose instance shape area, select VM.Standard2.2.

    5. In the Configure networking area, specify the virtual cloud network that contains the devices that Zenoss Collector will monitor.

  4. At the bottom of the Create Compute Instance page, click Create.

    The OCI web interface creates and displays a page for the new instance, and updates the page with progress information.

Creating a console connection to the virtual machine

Follow these steps to create a console connection to the new virtual machine:

  1. From the Instance Details page of the new virtual machine, verify that the system is running.

  2. From the Resources menu in the left column, select Console Connection.

  3. Click Create Console Connection.

  4. In the Create Console Connection dialog box, provide an SSH public key, and then click Create Console Connection.

  5. From the menu of the new console connection, select SSH or VNC.

  6. From the connection dialog, select a workstation platform, and then copy the connection string.

  7. Open your terminal client, and then paste the connection string into the session window.

Next step

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