manpagez: man pages & more
man ompi-clean(1)
Home | html | info | man
orte-clean(1)                      Open MPI                      orte-clean(1)




NAME

       orte-clean - Cleans up any stale processes and files leftover from Open
       MPI jobs.





SYNOPSIS

       orte-clean [--verbose]
       mpirun --pernode [--host | --hostfile file] orte-clean [--verbose]





OPTIONS

       [-v | --verbose] This argument will run the command in verbose mode and
       print  out  the  universes  that are getting cleaned up as well as pro-
       cesses that are being killed.




DESCRIPTION

       orte-clean attempts to clean up any processes and files left over  from
       Open  MPI  jobs that were run in the past as well as any currently run-
       ning jobs.  This includes OMPI infrastructure and helper commands,  any
       processes  that  were  spawned  as  part  of the job, and any temporary
       files.  orte-clean will only act upon processes and files  that  belong
       to  the  user  running the orte-clean command.  If run as root, it will
       kill off processes belonging to any users.

       When run from the command line, orte-clean will attempt to clean up the
       local  node it is run from.  When launched via mpirun, it will clean up
       the nodes selected by mpirun.




EXAMPLES

       Example 1: Clean up local node only.

       example% orte-clean


       Example 2: To clean up on a specific set of nodes specified on  command
       line,  it  is recommended to use the pernode option.  This will run one
       orte-clean for each node.

       example% mpirun --pernode --host node1,node2,node3 orte-clean

       To clean up on a specific set of nodes from a file.

       example% mpirun --pernode --hostfile nodes_file orte-clean

       Example 3: Within a resource managed environment like N1GE,  SLURM,  or
       Torque.  The following example is from N1GE.

       First, we see that we have two nodes with two CPUs each.

       example% qsh -pe orte 4
       example% mpirun -np 4 hostname
       node1
       node1
       node2
       node2

       Clean up all the nodes in the cluster.

       example% mpirun --pernode orte-clean

       Clean up a subset of the nodes in the cluster.

       example% mpirun --pernode --host node1 orte-clean




SEE ALSO

       orterun(1), orte-ps(1)




1.4.4                            Sep 27, 2011                    orte-clean(1)

openmpi 1.4.4 - Generated Sat Oct 22 06:05:40 CDT 2011
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.