Controlling Helix DAM and Helix TeamHub

As described in the System architecture section, Helix DAM is composed of popular open-source technologies. Helix DAM runs and monitors a number of services, which are responsible for executing user requests, scheduling, and running background operations.

Helix DAM comes with the hth-ctl tool, which helps manage services and configuration, and aids in performing administrative tasks. This is the same tool used during Helix DAM installation and upgrades.

Control commands

Warning

Some control commands are destructive. Be extremely careful when executing unfamiliar switches.

To retrieve the list of all of the available commands, run sudo hth-ctl as the TeamHub user. To run a control command, run sudo hth-ctl <command> as the TeamHub user.

The most commonly used commands are listed below:

  • status - Show the status of all the services.
  • report - Generates system report for 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).
  • reconfigure - reconfigures Helix DAM after upgrading the package. Applies changes after configuration has been updated.

Services

Helix DAM runs and monitors a number of services using the runit service supervision tool. The list below outlines all available services on the Helix DAM servers. In Enterprise deployment, the services will be spread across the Web and DB roles.

  • anycable - Daemon for WebSocket connections together with moonshine.
  • apache - Apache Web server for handling version control operations.
  • docker_registry - Daemon for Docker repositories.
  • ldap - Daemon for LDAP protocol of the TeamHub LDAP interface. See Helix TeamHub LDAP interface in the Helix TeamHub Administrator Guide.
  • ldaps - Daemon for LDAPS protocol of the TeamHub LDAP interface. See Helix TeamHub LDAP interface in the Helix TeamHub Administrator Guide.
  • logrotate - Logrotate daemon for rotating application logs.
  • maven - Daemon for Maven repositories.
  • mongodb - MongoDB database stores entire application data.
  • moonshine - Daemon for WebSocket connections together with anycable.
  • nginx - Nginx proxies all users requests to other services.
  • puma_pilsner - Daemon for Perforce integration.
  • redis - Redis database stores intermediate data, such as background jobs and events.
  • resque - Processes background jobs, such as hooks, notifications, events, backups.
  • resque_scheduler - Schedules resque background jobs.
  • streamer - Daemon for streaming files.
  • unicorn_backend - Unicorn Web server serving TeamHub APIs, including authorization.