V‑Blaze service commands

Service commands enable a system administrator to control the state of services, such as starting and stopping V‑Blaze. The following sections detail V‑Blaze service commands in CentOS 7.

Performance status and statistics

Use the following commands to check the status of V‑Blaze services:


sudo systemctl status vociserver

sudo systemctl status vociwebapi

Use the following command to view detailed system information:


sudo systemctl sysinfo vociserver

Use the following command to view detailed ASR engine statistics:


sudo systemctl stats vociserver

Use the following command to view available audio-independent parameters:


sudo systemctl params vociserver

Tip: Another way to obtain the information returned from the commands above is to query the V‑Blaze API. Refer to Endpoints for more information on V‑Blaze API queries.

Start Service Commands

Use the following commands to start V‑Blaze services:


sudo systemctl start vociserver

sudo systemctl start vociwebapi

Note: The vociserver service may take several minutes to load multiple language models. Refer to Language model configuration for more information on the loading behavior of language models.

Stop Service Commands

Use the following commands to stop V‑Blaze services:


sudo systemctl stop vociserver

sudo systemctl stop vociwebapi

Note:

The vociwebapi service will wait 60 seconds for active streams to complete. The /transcribe endpoint is blocked during the 60 second wait period. Requests received during this period will receive 503 Service Unavailable as a response. The service stops automatically if active streams can complete before time is up. Refer to the stoptimeout parameter in V‑Blaze API configuration (optional) for more information on adjusting the time limit.

Important:

The vociwebapi service stops as soon as the waiting period ends and existing connections are terminated without a response.

Querying other endpoints during the waiting period, such as /status or /statusfull, include an additional shutdownin field that indicates the number of seconds remaining before shutdown.

Hard stops can be performed by adding --force option to the stop command.

Restart Service Commands

Use the following commands to restart V‑Blaze services:


sudo systemctl restart vociserver

sudo systemctl restart vociwebapi