How-to Guides

How-to solve concrete problems

This section contains practical how-to guides for common ClusterCockpit tasks.

Setup & Deployment

GuideDescription
Hands-On DemoBasic ClusterCockpit setup and API usage walkthrough
Deploy and Update cc-backendRecommended deployment and update workflow for production use
Setup a systemd ServiceRun ClusterCockpit components as systemd services
Create a cluster.json FileHow to initially create a cluster configuration

Configuration & Customization

GuideDescription
Customize cc-backendAdd legal texts, modify login page, and add custom logo
Notification BannerAdd a message of the day banner on the homepage
Auto-TaggingEnable automatic job tagging for application detection and classification
ResamplingPlan and configure metric resampling
Retention PoliciesManage database and job archive size with retention policies

Metric Collection & Integration

GuideDescription
Hierarchical Metric CollectionConfigure multiple cc-metric-collector instances with forwarding
External TSDB IntegrationIntegrate Prometheus and InfluxDB data into cc-metric-store
Sharing HPM Metrics (SLURM)Share hardware performance counter access between monitoring and user jobs

API & Developer Tools

GuideDescription
Generate JWT TokensGenerate JSON Web Tokens for API authentication
Use the REST APIHow to use the REST API endpoints
Use the Swagger UIBrowse and test API endpoints via Swagger UI
Regenerate Swagger DocsRegenerate the Swagger UI documentation from source

Migrations

GuideDescription
Database MigrationsApply database schema migrations
Job Archive MigrationsMigrate job archive data between versions

Configure retention policies

Managing database and job archive size with retention policies

How to set up hierarchical metric collection

Configure multiple cc-metric-collector instances to receive metrics from compute nodes and forward them to the backend

How to ingest metrics from external time series databases

Integrate Prometheus and InfluxDB data into cc-metric-store using adapter scripts and proxy approaches

Database migrations

Database migrations

Job archive migrations

Job archive migrations

Hands-On Demo

Hands-On Demo for a basic ClusterCockpit setup and API usage (without Docker)

How to add a MOD notification banner

Add a message of the day banner on homepage

How to create a `cluster.json` file

How to initially create a cluster configuration

How to customize cc-backend

Add legal texts, modify login page, and add custom logo.

How to deploy and update cc-backend

Recommended deployment and update workflow for production use

How to enable and configure auto-tagging

Enable automatic job tagging for application detection and job classification

How to generate JWT tokens

How to plan and configure resampling

Configure metric resampling

How to regenerate the Swagger UI documentation

How to setup a systemd service

Run ClusterCockpit components as systemd services

How to use the REST API Endpoints

How to use the Swagger UI documentation

Sharing HPM Metrics Between Monitoring and User Profiling

How to share hardware performance counter access between system monitoring and user jobs in SLURM