Tools

Command-line tools for ClusterCockpit maintenance and administration

This section documents the command-line tools included with ClusterCockpit for various maintenance, migration, and administrative tasks.

Available Tools

Archive Management

Security & Authentication

  • gen-keypair: Generate Ed25519 keypairs for JWT signing and validation
  • convert-pem-pubkey: Convert external Ed25519 PEM keys to ClusterCockpit format

Diagnostics

  • grepCCLog.pl: Analyze log files to identify non-archived jobs

Building Tools

All Go-based tools follow the same build pattern:

cd tools/<tool-name>
go build

Common Features

Most tools support:

  • Configurable logging levels (-loglevel)
  • Timestamped log output (-logdate)
  • Configuration file specification (-config)

archive-manager

Job Archive Management Tool

archive-migration

Job Archive Schema Migration Tool

convert-pem-pubkey

Convert Ed25519 Public Key from PEM to ClusterCockpit Format

gen-keypair

Generate Ed25519 Keypair for JWT Signing

grepCCLog.pl

Analyze ClusterCockpit Log Files for Running Jobs