GB-289: the IPsec rotation's staged material is missing or unreadable¶
Generated from ops/errors/catalog.yaml by ops/ci/check-error-catalog.py --write; do not edit here. GB-289 is printed by goatbuilder. The same text offline: goat explain GB-289 or goatbuilder explain GB-289.
What it means¶
A credential rotation of an ipsec-fips peering (goat-peering-edge with peering_edge_rotation set) switches the edge to a new leaf that the offline ceremony issued and an operator staged beside the live files: <name>-cert.next.pem in the swanctl x509 directory, <name>-key.next.pem in its private directory at mode 0600, and for an ipsec-ca rotation our new CA as <name>-local-ca.next.pem in x509ca. The rotation also needs our current IPsec CA certificate at peering_edge_local_ca_path to check the new leaf's chain. One of them is missing, unreadable, or the key is not mode 0600. The role refused before anything moved.
Why it happens¶
- the new leaf, its key, or (for ipsec-ca) our new CA was not staged on this edge
- peering_edge_local_ca_path is not set, or names no file on the edge
- the staged key was copied without mode 0600
What to do¶
One line per step or alternative:
stage what the ceremony issued at the paths the message names, with the key at mode 0600, then run the rotation again
set peering_edge_local_ca_path in the edge's group_vars to our current per-peering IPsec CA certificate
Read more¶
Exit code¶
goatbuilder exits with 2.