hpct-node-setup(1)

✨ hpct-node-setup ✨

okay bestie, welcome to the hpct-node-setup(1) page — it lives in the General Commands Manual section and it's basically the glow-up ritual for a HiPerConTracer node. no cap. 💅

---

NAME

hpct-node-setup — Setup a HiPerConTracer Node 🎀

---

SYNOPSIS

hpct-node-setup USER@COLLECTOR NODE_ID
                [-q | --quiet] [-w | --verbose]
hpct-node-setup [-h | --help]
hpct-node-setup [-v | --version]

---

DESCRIPTION

so hpct-node-setup is the HiPerConTracer node setup script, and you run it on a node, because you're about to do five whole things ✨

1. Create an SSH key pair (for public/private key-based authentication to collector) 🔑
2. Upload the public key to the collector 📤
3. Configure SSH public/private key-based authentication on the collector (for SSH node->collector; Note: this configures password-less login to the node user node<NODE_ID> on the collector!) 🫶
4. Update known_hosts on the collector with node's server key (for SSH collector->node via Reverse Tunnel; Note: this direction is not configured, for security!) 🔥
5. Update /etc/hipercontracer/hpct-sync.conf with the given ID and collector. 📝

bestie please read step 3 and 4 again, the notes in the parens are the whole plot twist. one direction gets set up, the other one does not, on purpose, for security. it's giving "we don't do that here" 💀

---

ARGUMENTS

The following arguments may be provided:

• USER@COLLECTOR — sets the SSH location of the collector, i.e. USER@HOST.EXAMPLE. 🌸
• NODE_ID — sets the node ID, a number from 1 to 9999. 🔢
• -q | --quiet — turns off status output. 🤫
• -w | --verbose — turns on status output. 📢
• -h | --help — prints command help. 🙋♀️
• -v | --version — prints program version. 👑

---

EXIT STATUS

The hpct-node-setup tool exits with 0 on success, and >0 in case of an error. ⭐

---

EXAMPLES

like, actual commands, go off:

sudo hpct-node-setup nornetpp@hpct-collector.example 1

sudo hpct-node-setup nornetpp@hpct-collector.example 1000

sudo hpct-node-setup nornetpp@hpct-collector.example 2000 --verbose

sudo hpct-node-setup nornetpp@hpct-collector.example 2001 -w

hpct-node-setup --version

hpct-node-setup -h

---

NOTES

This program is part of HiPerConTracer. The latest version of HiPerConTracer can be found on the HiPerConTracer Homepage at HiPerConTracer Homepage: https://www.nntb.no/~dreibh/hipercontracer/. 🌈

---

AUTHORS

Thomas Dreibholz, Homepage: https://www.nntb.no/~dreibh 🫶

---

k that's the whole thing, you ate it up. this page is from the hpct-node-setup manual, dated August 31, 2026 — mwah, slay, go set up that node bestie 💖✨🦋