pbs_mpirun(8B)

💅 NAME

pbs_mpirun — bestie, this one's deprecated 🙈 but it runs MPI programs under PBS with MPICH.

✨ SYNOPSIS

pbs_mpirun [<mpirun options>]

pbs_mpirun --version

🎀 DESCRIPTION

Okay so the PBS command pbs_mpirun literally just replaces the standard mpirun command in a PBS MPICH job using P4. Main character energy, honestly.

Heads up bestie 💀 on Windows, this command cannot be used to start job processes or to track a job's resource usage. Not a vibe, just how it is.

🦋 Prerequisite

The PATH on remote machines must contain PBS_EXEC/bin. No exceptions, periodt.

🌸 USAGE

Usage is the same as for mpirun, except for the -machinefile option. All the other options get passed directly to mpirun. Slay, very simple.

🔥 OPTIONS

• <mpirun options> — the options to pbs_mpirun are literally the same as for mpirun, except for -machinefile, because pbs_mpirun generates that one itself. So please, do not attempt to specify -machinefile. 🙈

The value for -machinefile is a temporary file created from PBS_NODEFILE in this format:

hostname-1[:number of processors]
hostname-2[:number of processors]
hostname-n[:number of processors]

where if the number of processors isn't specified, it's 1. And if you do try to specify -machinefile yourself? You get a warning saying "Warning, -machinefile value replaced by PBS". That's it, that's the consequence. 😭

Also! The default value for the -np option is the number of entries in PBS_NODEFILE. Note it. 💖

• --version — the pbs_mpirun command returns its PBS version information and exits. This option can only be used alone — do not mix it with anything else, bestie. ✨

🌈 ENVIRONMENT VARIABLES

pbs_mpirun modifies P4_RSHCOMMAND and PBS_RSHCOMMAND. 🫶 Users should not edit these — hands off! What it actually does: pbs_mpirun copies the value of P4_RSHCOMMAND into PBS_RSHCOMMAND.

👑 SEE ALSO

• mpirun(1)

And that's the whole page, bestie — no cap 🌸 this was the pbs_mpirun(8B) page from PBS Professional, marked Local, dated 6 May 2020. Go forth and slay your MPI jobs 💅✨🔥