openmpi/orte/mca/rmaps/round_robin/help-orte-rmaps-rr.txt

# -*- text -*-
#
# Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
#                         University Research and Technology
#                         Corporation.  All rights reserved.
# Copyright (c) 2004-2005 The University of Tennessee and The University
#                         of Tennessee Research Foundation.  All rights
#                         reserved.
# Copyright (c) 2004-2005 High Performance Computing Center Stuttgart, 
#                         University of Stuttgart.  All rights reserved.
# Copyright (c) 2004-2005 The Regents of the University of California.
#                         All rights reserved.
# $COPYRIGHT$
# 
# Additional copyrights may follow
# 
# $HEADER$
#
# This is the US/English general help file for Open RTE's orterun.
#
[orte-rmaps-rr:alloc-error]
There are not enough slots available in the system to satisfy the %d slots 
that were requested by the application:
  %s

Either request fewer slots for your application, or make more slots available
for use.
[orte-rmaps-rr:multi-apps-and-zero-np]
RMAPS found multiple applications to be launched, with
at least one that failed to specify the number of processes to execute.
When specifying multiple applications, you must specify how many processes
of each to launch via the -np argument.

[orte-rmaps-rr:per-node-and-too-many-procs]
There are not enough nodes in your allocation to satisfy your request to launch
%d processes on a per-node basis - only %d nodes were available.

Either request fewer processes, or obtain a larger allocation.
- Add an opal_show_help() to the pls fork module to explain what went wrong when the execv to start the application fails. - Add a couple opal_show_help()'s to indicate when not enough slots/nodes are available to satisfy a request. This commit was SVN r7555. 2005-09-30 14:30:21 +00:00			`# -- text --`
			`#`
Update the copyright notices for IU and UTK. This commit was SVN r7999. 2005-11-05 19:57:48 +00:00			`# Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana`
			`# University Research and Technology`
			`# Corporation. All rights reserved.`
			`# Copyright (c) 2004-2005 The University of Tennessee and The University`
			`# of Tennessee Research Foundation. All rights`
			`# reserved.`
- Add an opal_show_help() to the pls fork module to explain what went wrong when the execv to start the application fails. - Add a couple opal_show_help()'s to indicate when not enough slots/nodes are available to satisfy a request. This commit was SVN r7555. 2005-09-30 14:30:21 +00:00			`# Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,`
			`# University of Stuttgart. All rights reserved.`
			`# Copyright (c) 2004-2005 The Regents of the University of California.`
			`# All rights reserved.`
			`# $COPYRIGHT$`
			`#`
			`# Additional copyrights may follow`
			`#`
			`# $HEADER$`
			`#`
			`# This is the US/English general help file for Open RTE's orterun.`
			`#`
			`[orte-rmaps-rr:alloc-error]`
Fixed a max_slots off by one problem that Brian highlighted. Also cleaned up the error message when allocating over the number of slots available. This commit was SVN r7715. 2005-10-12 02:09:56 +00:00			`There are not enough slots available in the system to satisfy the %d slots`
			`that were requested by the application:`
			`%s`
- Add an opal_show_help() to the pls fork module to explain what went wrong when the execv to start the application fails. - Add a couple opal_show_help()'s to indicate when not enough slots/nodes are available to satisfy a request. This commit was SVN r7555. 2005-09-30 14:30:21 +00:00
			`Either request fewer slots for your application, or make more slots available`
			`for use.`
Per LANL's stated need, add functionality that runs a.out across ALL available process slots if no num_proc is specified on the command line. However, please note the following limitation: we ONLY allow ONE application to be specified on the command line when this feature is invoked. If multiple apps are specified, the user MUST also specify the number to be launched for each and every one of them. Update the help text to report errors when not following that rule. Also updated the RMAPS help text to reflect the reorganization of some of the round-robin code into the base. The new functionality has been tested under Mac OS-X and on Odin using an MPI program. Both byslot and bynode mapping have been checked and verified. Operational support for other systems needs to be verified - I respectfully request people's help in doing so. This commit was SVN r10708. 2006-07-10 21:25:33 +00:00			`[orte-rmaps-rr:multi-apps-and-zero-np]`
			`RMAPS found multiple applications to be launched, with`
			`at least one that failed to specify the number of processes to execute.`
			`When specifying multiple applications, you must specify how many processes`
Modify the pernode option so it can accept a request for the number of processes to be launched. We now check three use-cases for pernode: 1. no -np provided - put one proc/node across all allocated nodes 2. -np N provided, N > #nodes - we print a pretty error message and exit 3. -np N provided, N <= #nodes - put one proc/node across N nodes I also added a new orte constant (ORTE_ERR_SILENT) that allows us to pass up the chain that an error was encountered, but NOT print ORTE_ERROR_LOG messages. This is intended to be used for cases where the error we encounter is NOT an orte error, but rather is one associated with incorrect user input (e.g., the preceding case 2). In such cases, there is no point in printing an ORTE_ERROR_LOG chain of messages as it isn't an orte error. This commit was SVN r12821. 2006-12-11 18:07:07 +00:00			`of each to launch via the -np argument.`

			`[orte-rmaps-rr:per-node-and-too-many-procs]`
			`There are not enough nodes in your allocation to satisfy your request to launch`
			`%d processes on a per-node basis - only %d nodes were available.`

			`Either request fewer processes, or obtain a larger allocation.`