Zoomdata Version

Installing and Configuring the Zoomdata Service Monitor

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

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 service. 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 Services.

After installing the Service Monitor, you can navigate to its UI in a web browser using default port 8050. For example, if running locally, the Zoomdata instance would be http://localhost:8080, so the Service Monitor URL would be http://localhost:8050. If your Zoomdata instance is at port 10.2.3.24, the Service Monitor URL would be http://10.2.3.24:8050.

Was this topic helpful?