Skip to content

psadmin.io

psa-cli

A unified command-line tool for PeopleSoft administration.

Status: Beta Python 3.9+ MIT License PeopleTools 8.62

Quickstart → Install GitHub

What it does

psa streamlines PeopleSoft administration into a single, scriptable interface. It wraps psadmin, the DPK installer, and Puppet apply — keeping the parts that matter, smoothing the rough edges, and producing output that's pleasant to read in a terminal and parseable as JSON when you need it.

psa domain status APPDOM            # Check a domain
psa domain bounce APPDOM            # Stop, purge, flush, configure, start
psa dpk stage --version 8.62.04     # Stage a DPK
psa dpk apply --summary             # Run puppet apply, readable output
psa discover --json                 # Find local domains, emit JSON

Highlights

  • Domain lifecycle — list, status, start, stop, restart, bounce, compare with Rich output and --json.
  • DPK provisioning — stage → setup → init → sync → apply → cleanup, with a 3-tier Hiera layout and custom module install.
  • dpk apply --summary — filtered, readable Puppet output. Errors are surfaced with exit-code diagnostics.
  • Discovery — find local PeopleSoft domains and optionally report them to an upstream API.
  • Resilient sudo — file operations transparently escalate when the runtime user can't write.

Status

Beta — not for production

psa-cli is pre-1.0. The CLI surface, config schema, and command behavior may change before 1.0. Tested against PeopleTools 8.62; older versions may work but are unverified. See known limitations for caveats around JSON output and the hidden ops / gated kit command groups.

License

MIT © psadmin.io