Manage TigerGraph services

Although the end user accesses TigerGraph by running GSQL or accessing the GraphStudio GUI, TigerGraph is actually built on many more services than just those two alone. Each has its own function and can be started or stopped individually in the case of a problem with one part, though several services rely on one another.

Consult the Glossary for definitions of the TigerGraph services.

Start, stop or restart a service

Use the command gadmin start all to start all the TigerGraph services. This is the first step when running a new TigerGraph instance. If you are using Docker, for example, you must run gadmin start all after starting the Docker container before you can use GSQL.

Use gadmin stop, gadmin start or gadmin restart with individual services such as GSQL, Kafka, or RESTPP to control them separate from the others.

The restart and stop commands prompt you for confirmation each time they are run. To avoid this, run the commands with the -y flag to bypass the confirmation.

Bypass confirmation with -y

gadmin restart gpe -y
gadmin stop all -y
gadmin start all

See the GADMIN Commmand Glossary for more details about gadmin start, stop, and restart.

Graceful Shutdown of RESTPP

When stopping RESTPP by gadmin stop restpp, the RESTPP will wait until all ongoing requests are complete before the timeout. Any long-running queries will be discarded once gadmin stop command hits the timeout. The timeout is defined by the Gadmin.StopServiceDefaultTimeoutMS configuration parameter (200s by default). The --timeout flag of gadmin stop will override the value of the configuation parameter.

Graceful Shutdown of GPE

When stopping GPE by gadmin stop gpe, the GPE will wait until all ongoing requests are complete before the timeout, plus an additional grace period of 5s to give room for any subsequent requests that may arrive later. Any long-running queries will be discarded once the gadmin stop command hits the timeout. The timeout is defined by the GPE.StopTimeoutMS configuration parameter (300s by default). The --timeout flag of gadmin stop will override the value of the configuation parameter.

Moreover, the 5s grace period can be adjusted by adding ShutdownGracePeriodMs=<YOUR_CHOICE_OF_GRACE_PERIOD_MS>; to the GPE.BasicConfig.Env parameter.

Check service status

Use gadmin status all or gadmin status with an individual service to check its state. See Service status definitions for detailed information on the returned results.