PCSD(8)

📦
version 0.12.3 · 7 versions
, in fedora 43, fedora 44

🌸 PCSD — the manual, but make it make sense 💅

pcsd(8) — system administration utilities, but specifically the pacemaker/corosync configuration system daemon. Yeah. That's her. She runs the whole vibe in the background so you don't have to. 🎀

✨ NAME ✨

pcsd — the pacemaker/corosync configuration system daemon 🦋

✨ SYNOPSIS ✨

pcsd
pcsd --version [--full]

✨ DESCRIPTION ✨

Okay so bestie, pcsd is the daemon that controls and configures pacemaker/corosync clusters, and it does all of that via pcs. She's the backstage manager. The main character who never asks for credit. 👑

  • --version — prints pcsd version info. And if you tack on --full, she'll flex and list out all her pcsd capabilities too. Not me being nosy but I will be reading the full list. 🙈

✨ ENVIRONMENT ✨

Network and SSL/TLS Settings 🌐

  • PCSD_BIND_ADDR=<string> — the list of IP addresses pcsd should bind to, and you separate them with the , character. Multiple addresses, one comma-joined list, that's the whole assignment.
  • PCSD_PORT=<string> — the port where pcsd should be available. Her door number, basically. 🚪
  • PCSD_SSL_OPTIONS=<string> — SSL/TLS options, delimited by the , character. This is usually the thing you use to set which SSL/TLS protocols pcsd accepts. Wanna know what counts as a valid option? Run this:
ruby -e 'require "openssl"; puts OpenSSL::SSL.constants.grep /^OP_/'
  • PCSD_SSL_CIPHERS=<string> — the SSL/TLS ciphers pcsd accepts. 🔐

Web UI Settings 🎀

  • PCSD_SESSION_LIFETIME=<integer> — how long a Web UI session lives, measured in seconds. Tick tock. ⏳

Proxy Settings 🧚

Heads up bestie: go read the ENVIRONMENT section in the curl(1) man page for more details. That's the homework. 📚
  • https_proxy=<string>, HTTPS_PROXY=<string> — proxy server address for node to node communication.
  • all_proxy=<string>, ALL_PROXY=<string> — proxy server address for node to node communication.
  • no_proxy=<string>, NO_PROXY=<string> — list of hostnames where the proxy is not used. The do-not-call list. 💀

Miscellaneous Settings ⭐

  • PCSD_DEBUG=<boolean> — set it to true for advanced pcsd debugging information. Turn it on when you need the tea. 🍓
  • PCSD_RESTART_AFTER_REQUESTS=<integer> — the number of requests after which the Ruby server restarts itself, to reduce memory footprint. Wanna disable restarts? Set 0. Any other number lower than 50 gets interpreted as 50. And invalid values? They get ignored and the default (200) is set instead. So be normal about it. 😭

✨ FILES ✨

All the files described in this section live in /var/lib/pcsd/. And lowkey important: they are not meant to be edited manually unless it says otherwise. Hands off the artifacts unless invited. 🙅♀️

cfgsync_ctl 🦋

This JSON file controls pcsd and cluster configuration files synchronization across cluster nodes — which pcsd is doing automatically in the background, no cap. This file can be safely edited manually. Slay.

Example:

{
  "file_backup_count": 50,
  "thread_disabled": false,
  "thread_interval": 600,
  "thread_interval_previous_not_connected": 60,
  "thread_paused_until": 1487780453
}
  • file_backup_count — how many backup files should be kept for each synchronized file.
  • thread_disabled — set this to true to completely disable the synchronization. Fully off. Not even a little bit on.
  • thread_interval — how often, in seconds, pcsd should ask other nodes if the synchronized files have changed.
  • thread_interval_previous_not_connected — how often, in seconds, pcsd should ask other nodes if the synchronized files have changed if during the previous attempt pcsd was unable to connect to at least two nodes. Situational, but she's prepared. 💅
  • thread_paused_until — disables the synchronization until the set unix timestamp. Nap time, scheduled in advance.

known-hosts 👑

This JSON file stores information about hosts known to the local pcsd, which get used to log in to remote instances of pcsd. The stored info includes host addresses, pcsd ports and authentication tokens. Her little black book, fr fr.

pcs_settings.conf 💖

This JSON file contains web UI and cluster configuration — stuff like clusters managed from the web UI, and cluster permissions.

pcs_users.conf 🌈

This JSON file stores the authentication tokens accepted by the local instance of pcsd.

pcsd.cookiesecret 🍪

The Web UI cookie secret. That's it. That's the file. Keep it secret. 🤫

pcsd.crt, pcsd.key 🔑

These files contain the pcsd server certificate and private key.

✨ SEE ALSO ✨

And that's the whole page bestie, you ate it, no crumbs. 🫶 This was pcs 0.12.3+0.12.3.1, dated 2026-09-08. Go configure something iconic. ✨💜

📦 where this page comes from