Skip to content

Installation procedures

This page lists the procedures for installing multi-host and single-host deployments of Control Center. For planning information, see Planning a Resource Manager deployment.

Keep this page open and open new tabs or windows for each procedure.

For optimum results, review the installation procedures before installing Control Center.

Note

Control Center and Resource Manager installations were tested on RHEL 8.6. If you want to install on RHEL 8.10, see Troubleshooting: Installing Resource Manager 6.7 on RHEL 8.10.

While this procedure has not been tested by Zenoss Engineering, it has been successful with some customers. If you encounter issues or have questions while performing this alternative procedure, contact your Zenoss support associate.

All deployments

  1. Verify hosts
    1. Download the zenoss-installer script
    2. Verify candidate host resources
  2. Download and stage required files
    1. Download files
    2. Install the repository mirror
    3. Stage Docker image files:

Multi-host deployments

For production use, Zenoss recommends installing a multi-host deployment with a minimum of 3 hosts.

One: Install the master host

Every deployment requires one master host.

  1. Install the master host:
    1. Prepare the host
    2. Install Docker and Control Center
    3. Configure Docker
    4. Load image files
    5. Create the application data thin pool
  2. Configure the master host
    1. Set up user access
    2. Configure tenant data storage
    3. Set the host role to master
    4. Set internal services OpenTSDB credentials
    5. Optional: Change the Docker registry endpoint
    6. Optional: Configure offline use
    7. Optional: Install a security certificate
    8. Optional: Set Zookeeper security
    9. Optional: Configure additional features
  3. Start Control Center
  4. Create resource pools
  5. Add the host to a resource pool

Two: Install delegate hosts

Repeat this procedure for each delegate host.

  1. Install a delegate host
    1. Prepare the host
    2. Install Docker and Control Center
    3. Configure NFS
    4. Configure Docker
  2. Configure a delegate host
    1. Enable CLI access
    2. Set host role to delegate
    3. Set the Docker registry endpoint
    4. Set internal services endpoints
    5. Optional: Configure offline use
    6. Optional: Install a security certificate
    7. Optional: Set Zookeeper security
    8. Optional: Configure additional features
  3. Start Control Center
  4. Authenticate the host

Three: Configure the ZooKeeper ensemble

Use the following procedures to configure a ZooKeeper ensemble (cluster) for a multi-host Control Center deployment that includes a minimum of three hosts.

  1. Understand ZooKeeper and Control Center
  2. Understand the configuration process
  3. Configure the master host
  4. Configure delegate host A
  5. Configure delegate host B
  6. Import the Docker image for ZooKeeper
  7. Start the ensemble
  8. Update and start other hosts
  9. Optional: Secure remaining data nodes

Single-host deployments

Single-host deployments are recommended for testing and development use only.

  1. Install the master host:
    1. Prepare the host
    2. Install Docker and Control Center
    3. Configure Docker
    4. Load image files
    5. Create the application data thin pool
  2. Configure the master host
    1. Set up user access
    2. Configure tenant data storage
    3. Set the host role to master
    4. Set internal services OpenTSDB credentials
    5. Optional: Change the Docker registry endpoint
    6. Optional: Configure offline use
    7. Optional: Install a security certificate
    8. Optional: Set Zookeeper security
    9. Optional: Configure additional features
  3. Start Control Center
  4. Add the host to a resource pool