Zoomdata Version

Installing and Configuring the Zoomdata Service Monitor

The Zoomdata Service Monitor microservice is not installed as part of a default Zoomdata installation. The microservice name is zoomdata-admin-server.

Zoomdata recommends that you contact Zoomdata Support for assistance with the installation and use of the Service Monitor.

To install, configure, and start the Service Monitor:

  1. Open your SSH client.

  2. Use the following command to install the Zoomdata Service Monitor in a CentOS environment:

    sudo yum install zoomdata-admin-server -y

    Use the following command to install the Zoomdata Service Monitor in an Ubuntu environment:

    sudo apt-get install zoomdata-admin-server
  3. After the Service Monitor is installed, you must specify a user name and password in its properties file. The properties file is called admin-server.properties and can be found in the /etc/zoomdata/ directory. The properties that must be defined are:

    • monitor.user.name=<username>
    • monitor.user.password=<password>

    Edit the properties file with a text editor and substitute a Service Monitor user name for <username> and its associated password for <password>. The user name and password can be any user name and password you want.

    When you have finished, save the file.

  4. Add the following properties to the zoomdata.properties file, located in the /etc/zoomdata directory. These properties ensure that the Service Monitor has access to the Zoomdata server actuator endpoints.

    • actuator.user.name=<Zoomdata-admin-username>
    • actuator.user.password=<Zoomdata-pswd>
    • actuator.logging.external-file=<log-file-path>

    Edit the properties file and substitute the valid user name and password of a Zoomdata administrator for <Zoomdata-admin-username> and <Zoomdata-pswd>. If the default Zoomdata log file path is not used for your installation, substitute your custom log file path for <log-file-path> (the default log file path is /opt/zoomdata/logs/zoomdata.log).

    Setting these properties exposes valid Zoomdata credentials as plain text in both the properties file and as tags in the Zoomdata Consul. Anyone in your network with the ability to communicate directly with the Consul API or view the Consul UI will be able to see these values.

    When finished, save the file.

  5. Start the microservice. For example, use the following command to start the Zoomdata Service Monitor using systemd in a CentOS or Ubuntu environment:

    sudo systemctl start zoomdata-admin-server

    See also Starting Zoomdata Microservices.

Was this topic helpful?