Skip to content

cla disp-start - Start the Dispatcher server

cla disp-start starts the Clarive Dispatcher server process.

The Dispatcher is responsible for job execution, rule processing, and background task management in Clarive. It processes jobs from the queue, executes rules, and manages worker connections.

Usage

cla disp-start -c MYCONFIG [options]

Options

  • -c, --config MYCONFIG - Specify the configuration file to use (required).
  • -d, --daemon - Run the dispatcher as a background daemon.
  • --debug <level> - Set debug level (1-5, higher numbers show more detail).
  • --workers <number> - Number of worker processes to spawn (default: 4).
  • --port <port> - Override the dispatcher port from config.

Environment Variables

  • CLARIVE_DEBUG=<level> - Set debug output level (1-5).
  • CLARIVE_TRACE=db - Print every MongoDB call with parameters and elapsed time.

Examples

Start the dispatcher in foreground mode:

cla disp-start -c myconfig

Start as a daemon with debug output:

CLARIVE_DEBUG=3 cla disp-start -c myconfig --daemon

Notes

  • The dispatcher must be running for job execution and background tasks.
  • Only one dispatcher instance per configuration should run at a time.
  • Check logs in the configured log directory for troubleshooting.
  • To see dispatcher status, use cla ps -c myconfig.