Recommended workflow for deployment
Why we do not provide a docker containerThe ClusterCockpit web backend binary has no external dependencies, everything is included in the binary. The external assets, SQL database and job archive, would also be external in a docker setup. The only advantage of a docker setup would be that the initial configuration is automated. But this only needs to be done one time. We therefore think that setting up docker, securing and maintaining it is not worth the effort.
It is recommended to install all ClusterCockpit components in a common directory, e.g.
In the following we use
Two systemd services run on the central monitoring server:
- clustercockpit : binary cc-backend in
- cc-metric-store : Binary cc-metric-store in
ClusterCockpit is deployed as a single binary that embeds all static assets.
We recommend keeping all
cc-backend binary versions in a folder
linking the currently active one from the
This allows for easy roll-back in case something doesn’t work.
cc-backend is started with root rights to open the privileged ports (80 and
443). It is recommended to set the configuration options
cc-backend will drop root permissions once the ports are taken.
You have to take care, that the ownership of the
./var folder and
its contents are set accordingly.
Workflow to deploy new version
This example assumes the DB and job archive versions did not change.
- Stop systemd service:
sudo systemctl stop clustercockpit.service
- Backup the sqlite DB file! This is as simple as to copy it.
- Copy new
/opt/monitoring/cc-backend/archive(Tip: Use a date tag like
YYYYMMDD-cc-backend). Here is an example:
cp ~/cc-backend /opt/monitoring/cc-backend/archive/20231124-cc-backend
- Link from
cc-backendroot to current version
ln -s /opt/monitoring/cc-backend/archive/20231124-cc-backend /opt/monitoring/cc-backend/cc-backend
- Start systemd service:
sudo systemctl start clustercockpit.service
- Check if everything is ok:
sudo systemctl status clustercockpit.service
- Check log for issues:
sudo journalctl -u clustercockpit.service
- Check the ClusterCockpit web frontend and your Slurm adapters if anything is broken!
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.