Controlling Helix TeamHub
As described in the Architecture section, Helix TeamHub is composed of popular open-source technologies. Helix TeamHub runs and monitors a number of services, which are responsible for executing user requests, scheduling, and running background operations.
Helix TeamHub comes with the
hth-ctl tool, which helps manage Helix TeamHub services and configuration, and aids in performing administrative tasks. This is the same tool used during the Helix TeamHub installation and upgrades.
Retrieve the list of all available commands by running
sudo hth-ctl. The most commonly used commands are listed below:
status- Show the status of all the services.
report- Generates system report for Helix TeamHub troubleshooting.
service-list- List all the services (enabled services appear with a *).
show-config- Show the configuration that would be generated by reconfigure.
tail- Watch the service logs of all enabled services.
start- Start services if they are down, and restart them if they stop.
restart- Stop the services if they are running, then start them again (causes slight downtime).
Warning! Some control commands are destructive! Be extremely careful when executing unfamiliar switches.
Helix TeamHub runs and monitors a number of services using the runit service supervision tool. The list below outlines all available services on the Helix TeamHub servers. In Cluster or HA deployment, the services will be spread across the Web and DB roles.
nginx- Nginx proxies all users requests to other services.
apache- Apache Web server for handling version control operations.
unicorn_backend- Unicorn Web server serving Helix TeamHub APIs, including authorization.
unicorn_web- Unicorn Web server serving Helix TeamHub UI.
resque- Processes background jobs, such as hooks, notifications, events, backups.
resque_scheduler- Schedules resque background jobs.
mongodb- MongoDB database stores entire application data.
redis- Redis database stores intermediate data, such as background jobs and events.
logrotate- Logrotate daemon for rotating application logs.
streamer- Daemon for streaming files.
ldap- Helix TeamHub LDAP Interface.
slave_syncer- Daemon for performing replication tasks on slave site.