Skip to content

How to install on Debian-based hosts

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

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 Debian-based systems.

    In the preceding example, the filename is zendatamon-agent_1.0.0_build278_amd64.deb. (The version number may be greater than 1.0.0.)

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

Noninteractive install (Debian-based)

  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.

    echo "zdm-agent zendatamon-agent/zenoss_license_agreement boolean true" \
  | sudo debconf-set-selections

  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:

    echo "zdm-agent zendatamon-agent/zenoss_datasources multiselect <YOUR-PLUGINS>" \
  | sudo debconf-set-selections

  4. Specify a Zenoss API authentication key.

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

    echo "zdm-agent zendatamon-agent/zenoss_api_key string <YOUR-API-KEY>" \
  | sudo debconf-set-selections

  5. Specify your Zenoss API endpoint.

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

    echo "zdm-agent zendatamon-agent/zenoss_api_endpoint string <YOUR-API-ENDPOINT>:443" \
  | sudo debconf-set-selections
    6. Start the installation and monitor the service startup.

    NEEDRESTART_SUSPEND=Y; DEBIAN_FRONTEND=noninteractive; \
  sudo apt install ./zendatamon-agent*.deb \
  && sudo 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.