mpiexec(8B)

💖 NAME 💖

okay so this is the mpiexec(8B) page, bestie — and mpiexec is literally here to run MPI programs under PBS on Linux. That’s the vibe. ✨

🦋 SYNOPSIS 🦋

mpiexec

mpiexec --version

🌸 DESCRIPTION 🌸

The PBS mpiexec command gives you the standard mpiexec interface on a system that’s running supported versions of Performance Suite. No cap. If you run it on a different system, it’ll assume it was invoked by mistake. In that case it will use the value of PBS_O_PATH to search for the correct mpiexec. If one is found, the PBS mpiexec will exec it. slay, it knows how to redirect itself. 💅

The PBS mpiexec calls the HPE mpirun(1).

It’s transparent to the user; MPI jobs submitted outside of PBS will run as they would normally. MPI jobs can be launched across multiple HPE machines. PBS will manage, track, and cleanly terminate multi-host MPI jobs. PBS users can run MPI jobs within specific partitions. main character energy for your cluster. 👑

If CSA has been configured and enabled, PBS will collect accounting information on all tasks launched by an MPI job. CSA information will be associated with the PBS job ID that invoked it, on each execution host. receipts, but make them accounting receipts. 🧾

If the PBS_MPI_DEBUG environment variable’s value has a nonzero length, PBS will write debugging information to standard output. debug girlie era activated. 🔥

🎀 USAGE 🎀

The PBS mpiexec command presents the mpiexec interface described in section "4.1 Portable MPI Process Startup" of the "MPI-2: Extensions to the Message-Passing Interface" document in http://www.mpi-forum.org/docs/mpi-20-html/node42.htm. iykyk, it’s giving official spec realness. 📚

✨ OPTIONS ✨

• --version — The mpiexec command returns its PBS version information and exits. This option can only be used alone. solo mode only, bestie — no extra flags tagging along. 🙈

🌈 REQUIREMENTS 🌈

• System running a supported version of Performance Suite. check that first, fr fr.
• PBS uses HPE’s mpirun(1) command to launch MPI jobs. HPE’s mpirun must be in the standard location.
• The location of pbs_attach() on each node of a multinode MPI job must be the same as it is on the mother superior node. same place, every node — no chaotic energy.
• In order to run multihost jobs, the HPE Array Services must be correctly configured. HPE systems communicating via HPE’s Array Services must all use the same version of the sgi-arraysvcs package. HPE systems communicating via HPE’s Array Services must have been configured to interoperate with each other using the default array. See HPE’s array_services(5) man page. matching versions and default-array setup are not optional, bestie. ⭐

🫶 ENVIRONMENT VARIABLES 🫶

• PBS_MPI_DEBUG — The PBS mpiexec checks the PBS_MPI_DEBUG environment variable. If this variable has a nonzero length, debugging information is written. turn it on and get the debug tea. ☕
• PBS_ENVIRONMENT — The PBS_ENVIRONMENT environment variable is used to determine whether mpiexec is being called from within a PBS job. are we in a PBS job or not? vibe check.
• PBS_O_PATH — The PBS mpiexec uses the value of PBS_O_PATH to search for the correct mpiexec if it was invoked by mistake. the find-your-way-home variable. 🏠

🦋 PATH 🦋

PBS’ mpiexec is located in PBS_EXEC/bin/mpiexec. that’s the path, bestie — memorize it like your favorite playlist. 🎧

🌟 SEE ALSO 🌟

• HPE man pages: HPE’s mpirun(1), HPE’s mpiexec_mpt(1), HPE’s array_services(5)
• PBS man pages: pbs_attach(8B)

go read those next, bestie — the lore continues. 📖

xoxo, bestie 💅 — source/version: Local; date: 26 May 2020; manual: mpiexec(8B). byeee 🫶