action.skip

How to install on Red Hat-based hosts

Use this procedure to install a Zenoss Data Monitor service on a real or virtual Linux host that uses the Red Hat package management system.

Note

Zenoss Data Monitor is in beta release and its features may change.

Prerequisites

Hardware resources

  • 1 CPU core (64-bit)
  • 30 MiB main memory
  • Approximately 75 MiB free space in /bin for Zenoss Data Monitor software
  • A network interface that supports TCP/IP and provides a minimum of 5 megabits per second upload capacity
  • Support for Advanced Encryption Standard (AES)

Software resources

  • A Linux distribution that supports Debian or Red Hat distribution packages
  • A login account with superuser privileges
  • Internet access (outbound TCP traffic through port 443)
  • DNS support, to reach your Zenoss API endpoint

Additional requirements

  • Permission to download files from delivery.zenoss.io, which can be granted to customers on request at the Zenoss Support site

  • A Zenoss API authentication key

  • The commands in the installation procedures use the Bash shell. Adjust as required for other shells.

Download the distribution file

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

  2. Display the Zenoss Data Monitor distribution files.

  3. Download the latest file for Red Hat-based systems.

    In the preceding example, the filename is zendatamon-agent-1.0.0_build278-1.x86_64.rpm. (The version number may be greater than 1.0.0.)

  4. If necessary, copy the file to the Zenoss Data Monitor host.

Noninteractive install

  1. Log in to the Zenoss Data Monitor host, and then change directory to the directory where the service distribution file is located (see download procedure).

  2. Accept the Zenoss Data Monitor license agreement.

    export ZENOSS_LICENSE_AGREEMENT="Y"
    
  3. Specify the list of datasources to enable.

    Replace <YOUR-PLUGINS> with a space-separated list of at least one of the following datasource names; host-linux-device is the recommended minimum datasource:

    export ZENOSS_DATASOURCES="<YOUR-PLUGINS>"
    
  4. Specify a Zenoss API authentication key.

    Replace <YOUR-API-KEY> with a valid authentication key for your environment:

    export ZENOSS_API_KEY="<YOUR-API-KEY>"
    
  5. Specify your Zenoss API endpoint.

    Replace <YOUR-API-ENDPOINT> with the endpoint for your environment:

    export ZENOSS_API_ENDPOINT="<YOUR-API-ENDPOINT>:443"
    
    6. Start the installation and monitor the service startup.

    yum install -y ./zendatamon-agent*.rpm && journalctl -f -u zendatamon-agent
    

    The installation scripts enable and start Zenoss Data Monitor. For more information about managing the service, see How to manage Zenoss Data Monitor.