pbs_topologyinfo(8B)

💖 NAME 💖

pbs_topologyinfo(8B) — report topological information. Yes bestie, this is the pbs_topologyinfo(8B) page from PBS Professional, and we are folding the manual-name thing in right here instead of doing a whole header-line copy-paste 💅

✨ SYNOPSIS ✨

pbs_topologyinfo (-a | --all) [(-l | --license) | (-s | --sockets)]
pbs_topologyinfo (-l | --license) <vnode name> [<vnode name> ...]
pbs_topologyinfo (-s | --sockets) <vnode name> [<vnode name> ...]
pbs_topologyinfo -h | --help

🌸 DESCRIPTION 🌸

Okay so pbs_topologyinfo reports topological information for one or more vnodes. This info is used for licensing purposes. You literally have to specify what kind of topological information you want, and the command reports only the requested information. No extras, no surprise tea, no cap.

This command must be run on the server host. Server host only, bestie — that's the vibe check.

🎀 Usage 🎀

• pbs_topologyinfo -al reports number of node licenses needed for all vnodes.
• pbs_topologyinfo -l <vnode name> reports number of node licenses needed for vnode name.
• pbs_topologyinfo -as reports socket counts for all vnodes that have reported sockets.
• pbs_topologyinfo -s <vnode name> reports socket count for vnode vnode name.

🧚 Prerequisites 🧚

Before you use this command, the server and MoMs must be configured so that they can contact each other, and must have been run. Like, they have to be set up and actually running — no ghosting each other, periodt.

👑 Required Privilege 👑

This command can be run only by root or Admin on Windows. So yeah, root or Admin on Windows only — that's the rule, bestie 😭

💅 OPTIONS 💅

• -a, --all — Reports requested topological information for all vnodes. When this option is used alone, the command does not report any information.
• -h, --help — Prints usage and exits.
• -l, --license [<vnode name(s)>] — Reports number of node licenses required. If you specify vnode name(s), the command reports node licenses needed for the specified vnode(s) only.
• -s, --sockets [<vnode name(s)>] — Reports derived socket counts. If you specify vnode name(s), the command reports socket count information for the specified vnode(s) only.
• (no options) — Does not report any information.

🍓 OPERANDS 🍓

• vnode name [<vnode name> ...] — Name(s) of vnode(s) about which to report.

💀 Errors 💀

If you specify an invalid vnode name, the command prints a message to standard error. So yeah, bad vnode name = message goes to standard error, no silent treatment.

🌈 EXIT STATUS 🌈

• 0 — Success.
• 1 — Any error following successful command line processing.

mwah 💋 — that's the whole page. This is pbs_topologyinfo(8B) from PBS Professional; the footer says Local, and it's dated 17 July 2020. Bye bestie, go get those topology receipts 🫶✨