Zoomdata Version

Managing Zoomdata Services Using Command Line Utility

Overview

Starting with Zoomdata release version 2.5, a new command line utility - zdmanage - is available to help System Admins manage the various services that are deployed in the Zoomdata environment. This command line utility is automatically installed when installing Zoomdata using the automated installation script. This utility script wraps underlying unix commands to help you perform common management operations such as stopping and starting Zoomdata services.

Prerequisites

In order to use the command line utility tool, you will need root access.

Using the 'zdmanage' Command Line Utility Tool

The 'zdmanage' command line utility is located in the following directory:

/opt/zoomdata/bin/zdmanage

The command line utility - zdmanage - can be used in the following syntax:

zdmanage services command service_name

The following commands are supported:

Command Action
list Displays all of the Zoomdata services installed in your deployment.
status Provides a status of all Zoomdata services in your environment.
start Start Zoomdata service(s).
stop Stop Zoomdata service(s).
restart Restart Zoomdata service(s).
enable Sets the Zoomdata service(s) to automatically enable when the OS starts up.
disable Sets the Zoomdata service(s) to automatically shut down when the OS starts up.
configure Opens the specified Zoomdata property file.

The following service_names are supported:

Service Name Action
all Apply the command to all available Zoomdata services in your Zoomdata environment.
zoomdata Apply the command specifically to the Zoomdata Server.
zoomdata-scheduler Apply the command specifically to the Zoomdata Scheduler.
zoomdata-spark-proxy Apply the command specifically to the Spark Proxy server.
zoomdata-consul Apply the command specifically to the Consul service.
zoomdata-xvfb Apply the command specifically to the xvfb service.
zoomdata-edc-connector_name* Apply the command specifically to a connector server (for example, Impala).

*For a list of the available connector-names, refer to the article Connector Properties.

Common Commands

Show all Zoomdata services installed:

sudo /opt/zoomdata/bin/zdmanage services list

Provide a status of all installed Zoomdata services:

sudo /opt/zoomdata/bin/zdmanage services status all

Show the status of the Zoomdata web service:

sudo /opt/zoomdata/bin/zdmanage services status zoomdata

Stop a specific Zoomdata service:

sudo /opt/zoomdata/bin/zdmanage services stop [zoomdata-service_name]


Related Articles: