Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ORTE-DVM(1)			   Open	MPI			   ORTE-DVM(1)

       orte-dvm, ompi_dvm - Establish a	Distributed Virtual Machine (DVM).

       Note:  orte-dvm and ompi-dvm are	synonyms for each other.  Using	either
       of the names will produce the same behavior.

       orte-dvm	[ options ]

       Invoking	orte-dvm via an	absolute path name is equivalent to specifying
       the  --prefix  option  with  a  _dir_ value equivalent to the directory
       where orte-dvm resides, minus its last subdirectory.  For example:

	   % /usr/local/bin/orte-dvm ...

       is equivalent to

	   % orte-dvm --prefix /usr/local

       orte-dvm	will establish a DVM that can be used  to  execute  subsequent
       applications.  Use  of  orte-dvm	can be advantageous, for example, when
       you want	to execute a number of short-lived tasks. In such  cases,  the
       time  required  to  start the ORTE DVM can be a significant fraction of
       the time	to execute the overall application. Thus, creating  a  persis-
       tent DVM	can speed the overall execution. In addition, a	persistent DVM
       will support executing multiple parallel	applications while maintaining
       separation between their	respective cores.

       -h, --help
	      Display help for this command

       -V, --version
	      Print  version  number.	If  no other arguments are given, this
	      will also	cause orte-dvm to exit.

       Use one of the following	options	to specify which hosts (nodes) of  the
       cluster to use for the DVM.

       -H, -host, --host <host1,host2,...,hostN>
	      List of hosts for	the DVM.

       -hostfile, --hostfile <hostfile>
	      Provide a	hostfile to use.

       -machinefile, --machinefile <machinefile>
	      Synonym for -hostfile.

       --prefix	<dir>
	      Prefix  directory	 that  will  be	 used  to  set	the  PATH  and
	      LD_LIBRARY_PATH on the remote node before	invoking the ORTE dae-
	      mon.  Setting MCA	parameters:

       -gmca, --gmca <key> <value>
	      Pass  global MCA parameters that are applicable to all contexts.
	      _key_ is the parameter name; _value_ is the parameter value.

       -mca, --mca <key> <value>
	      Send arguments to	various	MCA modules.  See the  "MCA"  section,

       -report-uri, --report-uri <channel>
	      Print  out  orte-dvm's  URI  during startup. The channel must be
	      either a '-' to indicate that the	URI is to be output to stdout,
	      a	 '+'  to indicate that the URI is to be	output to stderr, or a
	      filename to which	the URI	is to be written.

       The following options are useful	for developers;	they are not generally
       useful to most ORTE and/or MPI users:

       -d, --debug-devel
	      Enable debugging of the ORTE layer.

	      Enable  debugging	of the ORTE daemons in the DVM,	storing	output
	      in files.

       There may be other options listed with orte-dvm --help.

       orte-dvm	starts a Distributed Virtual Machine (DVM) by launching	a dae-
       mon  on	each  node  of the allocation, as modified or specified	by the
       -host and -hostfile options. Applications can subsequently be  executed
       using  the  orte-submit	command.   The	DVM remains in operation until
       receiving the orte-submit -terminate command.

   Specifying Host Nodes
       Host nodes can be identified on the  orte-dvm  command  line  with  the
       -host option or in a hostfile.

       For example,

       orte-dvm	-H aa,aa,bb ./a.out
	   launches two	processes on node aa and one on	bb.

       Or, consider the	hostfile

	  % cat	myhostfile
	  aa slots=2
	  bb slots=2
	  cc slots=2

       Here,  we  list	both the host names (aa, bb, and cc) but also how many
       "slots" there are for each.  Slots  indicate  how  many	processes  can
       potentially  execute  on	 a  node.  For best performance, the number of
       slots may be chosen to be the number of cores on	the node or the	number
       of  processor sockets.  If the hostfile does not	provide	slots informa-
       tion, a default of 1 is assumed.	 When running under resource  managers
       (e.g.,  SLURM,  Torque,	etc.), Open MPI	will obtain both the hostnames
       and the number of slots directly	from the resource manger.

1.10.6				 Feb 17, 2017			   ORTE-DVM(1)


Want to link to this manual page? Use this URL:

home | help