Manage the TeamForge EventQ server-side components
The scope of this guide is limited to key administrative features like starting/stopping services, log locations, etc. Administration and configuration of dependent services (e.g., nginx, MongoDB, RabbitMQ) is not covered; see respective product documentation. It is assumed that as TeamForge EventQ administrator you are familiar with basic Linux administration commands and terminology.
TeamForge EventQ installs and starts six background services on the App server. Each service is managed using init scripts, which are installed and started as part of the installation process. Init scripts are all located in /etc/init.d/ on the respective hosts. Once started, each service creates a pid file.
| Init script | PID file | Host | Description |
|---|---|---|---|
| collabnet-mongod | /var/run/collabnet-mongodb/mongodb.pid | DB server | Database service |
| collabnet-nginx | /var/run/collabnet-nginx/nginx.pid | App server | Web and application server |
| collabnet-rabbitmq-server | /var/run/collabnet-rabbitmq/rabbitmq.pid | MQ server | AMQP message service |
| collabnet-redis | /var/run/collabnet-redis/redis.pid | App server | Internal job queue service |
| eventq-ctf-jobs | /var/run/eventq/ctf_job_runner.pid | App server | Background communication with TeamForge |
| eventq-queue-commit | /var/run/eventq/scm_queue.pid | App server | Processes message from commit queue |
| eventq-queue-build | /var/run/eventq/build_queue.pid | App server | Processes message from build queue |
| eventq-queue-review | /var/run/eventq/review_queue.pid | App server | Processes message from review queue |
Example usage:
sudo service eventq-queue-commit restart
Example usage:
sudo service eventq start
During the installation of TeamForge EventQ, if RabbitMQ and MongoDB were installed as part of the installation process then the administrative passwords have been written to disk for reference:
The following log files are relevant to TeamForge EventQ services and may be useful for debugging. Log rotation on all log files is enabled by default.