action.skip

Installing in Google Cloud Platform

Use this procedure to install the Zenoss Cloud Collector virtual appliance as a Google Compute Engine (GCE) instance in Google Cloud Platform (GCP). This procedure uses the gcloud tool to create a GCE instance.

Prerequisites

To perform this task, you need:

  • A GCP account with permission to create images and virtual machines in GCE.
  • A GCP project enabled for GCE.
  • A workstation with Google Cloud SDK installed.

    The gcloud tool must be installed and initialized.

Installing the collector

Note

This procedure uses Bash shell conventions to set variables. Adjust as needed for different shells.

  1. Log in to a shell that has Google Cloud SDK installed and the gcloud tool initialized.

  2. Create a variable for the name of the instance to create.

    1. List existing instance names.

       gcloud compute instances list
      
    2. Specify a name that is unique in your GCP environment. In the following command, replace INSTANCE-NAME with a new name:

      myName=INSTANCE-NAME
      
  3. Create a variable for the GCE zone for the instance.

    1. List available zones.

       gcloud compute zones list
      
    2. Select the zone that matches the location where the infrastructure and applications to monitor are running. In the following command, replace GCE-ZONE with the zone you select:

      myZone=GCE-ZONE
      
  4. Create a variable for the GCE machine type to use.

    1. List available types.

       gcloud compute machine-types list
      
    2. Select a type that meets your needs and all collector resource requirements. For example, n1-standard-4. In the following command, replace MACHINE-TYPE with the type you select:

      myMachine=MACHINE-TYPE
      
  5. Create a variable for the GCE subnet to use.

    1. List available subnets.

       gcloud compute networks subnets list
      
    2. Select the same address space as the infrastructure and applications to monitor. In the following command, replace SUBNET with the subnet you select:

      mySubnet=SUBNET
      
  6. Create a variable for the GCP project to use.

    1. List available projects.

       gcloud projects list
      
    2. Select a type that meets your needs. In the following command, replace PROJECT with the project you select:

      myProject=PROJECT
      
  7. Create a variable for the location of the image to use.

    Copy the following command and paste it in your shell:

    zenossImage=https://www.googleapis.com/compute/v1/projects/zing-registry-188222/global/images/zenoss-collector-stable
    
  8. Verify the variables you chose in steps 2-6.

    env | grep -E '^my'
    
  9. Create a new instance.

    Copy the following command and paste it into your shell:

    gcloud compute instances create ${myName} \
      --zone=${myZone} \
      --machine-type=${myMachine} \
      --subnet=${mySubnet} \
      --image=${zenossImage} \
      --boot-disk-size=25GB \
      --boot-disk-device-name=collector-1 \
      --project=${myProject}
    

    Here is an example invocation:

    gcloud compute instances create zenoss-collector-1 \
      --zone=us-central1-a \
      --machine-type=n1-standard-4 \
      --subnet=default \
      --image=https://www.googleapis.com/compute/v1/projects/zing-registry-188222/global/images/zenoss-collector-stable \
      --boot-disk-size=25GB \
      --boot-disk-device-name=collector-1 \
      --project=marketing
    

Configuring collector networking

The default configuration of a Zenoss Cloud Collector virtual machine uses DHCP to obtain IPv4 and IPv6 addresses. Use this procedure to configure static addressing, specify DNS servers in your environment, and specify search domains. The latter two are commonly required to resolve the names of devices in your network environment.

Warning

Please do not change the virtual machine hostname.

  1. Gain access to the console interface of the virtual machine through your hypervisor or through a remote shell utility such as PuTTY.

  2. Log in to the system as user ccuser, password zenoss.

  3. Enter a new, secure password when prompted and keep a secure record of the chosen password.

  4. In the appliance menu, select Configure Network, and then press Enter.

  5. In the NetworkManager TUI, use the arrow key to select Edit a connection, and then press Enter.

    Make sure you edit the Wired connection interface. Currently, a few known issues can cause other, incorrect interface names to appear—for example, ensplan. Please ignore those.

  6. From the Ethernet interfaces, select Wired connection 1, and then use the right and down arrow keys to select <Edit...>. Press Enter.

  7. In the Edit Connection area, use the TAB key to select the <Show> command next to IPv4 CONFIGURATION or IPv6 CONFIGURATION, and then press Enter.

  8. Change <Automatic> to <Manual>, and then enter a static address in CIDR notation.

    If no prefix size is specified, the default (/32) is used.

  9. In the DNS servers field, enter the IP address of one or more DNS servers in your environment.

  10. In the Search domains field, enter one or more domain names used in your environment.

  11. Use the TAB key to select OK, and then press Enter.

  12. Use the down arrow key to select <Quit>, and then press Enter.

  13. In the appliance menu, select Reboot Appliance, and the press Enter.

Next step

Connect to a Collection Zone (Initializing a collector appliance).