diff --git a/.gitignore b/.gitignore index e1d8b168fe..665dc95ca5 100644 --- a/.gitignore +++ b/.gitignore @@ -161,7 +161,6 @@ src/tools/prte/prte src/tools/pcc/pcc src/tools/pcc/pcc-wrapper-data.txt src/tools/pterm/pterm -src/tools/psched/psched src/util/hostfile/hostfile_lex.c src/util/keyval/keyval_lex.c diff --git a/config/prte_config_files.m4 b/config/prte_config_files.m4 index ef3f2eb2e1..a36180538b 100644 --- a/config/prte_config_files.m4 +++ b/config/prte_config_files.m4 @@ -4,7 +4,7 @@ # Copyright (c) 2016-2020 Intel, Inc. All rights reserved. # Copyright (c) 2019 Research Organization for Information Science # and Technology (RIST). All rights reserved. -# Copyright (c) 2022-2023 Nanook Consulting. All rights reserved. +# Copyright (c) 2022-2024 Nanook Consulting All rights reserved. # $COPYRIGHT$ # # Additional copyrights may follow @@ -26,6 +26,5 @@ AC_DEFUN([PRTE_CONFIG_FILES],[ src/tools/prte_info/Makefile src/tools/prte/Makefile src/tools/pterm/Makefile - src/tools/psched/Makefile ]) ]) diff --git a/config/prte_setup_pmix.m4 b/config/prte_setup_pmix.m4 index 4c85405519..bbb5396507 100644 --- a/config/prte_setup_pmix.m4 +++ b/config/prte_setup_pmix.m4 @@ -79,10 +79,6 @@ AC_DEFUN([PRTE_CHECK_PMIX],[ [AS_HELP_STRING([--disable-pmix-lib-checks], [If --disable-pmix-lib-checks is specified, configure will assume that -lpmix is available])]) - AC_ARG_WITH(prte-scheduler, - AS_HELP_STRING([--with-prte-scheduler], - [Normal PRTE users/applications do not need this. Users/applications wishing to explore dynamic allocation support probably do (default: enabled).])) - prte_pmix_support=1 if test "$with_pmix" = "no"; then @@ -181,35 +177,5 @@ AC_DEFUN([PRTE_CHECK_PMIX],[ PRTE_SUMMARY_ADD([Required Packages], [PMIx], [], [$prte_pmix_SUMMARY]) - # - # Do we want to install the PRRTE scheduler? - # - AC_MSG_CHECKING([if want to install PRRTE pseudo-scheduler]) - if test "$prte_pmix_low_version" = "0"; then - if test "$with_prte_scheduler" = "no"; then - AC_MSG_RESULT([no]) - prte_want_scheduler="no" - WANT_PRTE_SCHED=0 - else - AC_MSG_RESULT([yes]) - prte_want_scheduler="yes" - WANT_PRTE_SCHED=1 - fi - else - if test "$with_prte_scheduler" = "yes"; then - AC_MSG_RESULT([yes]) - AC_MSG_WARN([Pseudo-scheduler requested, but PMIx version]) - AC_MSG_WARN([is too low. Please reconfigure with a version]) - AC_MSG_WARN([of at least v6.0]) - AC_MSG_ERROR([Cannot continue.]) - else - prte_want_scheduler="no" - WANT_PRTE_SCHED=0 - fi - fi - AM_CONDITIONAL(WANT_PRTE_SCHED, test "$WANT_PRTE_SCHED" = 1) - PRTE_SUMMARY_ADD([Miscellaneous], [PRTE Pseudo-Scheduler], [], [$prte_want_scheduler]) - - PRTE_VAR_SCOPE_POP ]) diff --git a/docs/Makefile.am b/docs/Makefile.am index 6ef9e92e61..ce4651bb8f 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -68,7 +68,6 @@ PRTE_MAN1 = \ prted.1 \ prterun.1 \ prun.1 \ - psched.1 \ pterm.1 PRTE_MAN5 = \ diff --git a/docs/how-things-work/schedulers/index.rst b/docs/how-things-work/schedulers/index.rst index 564a554ff8..ad11445307 100644 --- a/docs/how-things-work/schedulers/index.rst +++ b/docs/how-things-work/schedulers/index.rst @@ -3,8 +3,7 @@ Scheduler Integration ===================== This section describes PRRTE support for interactions -with schedulers, including PRRTE's own ``psched`` -pseudo-scheduler. +with schedulers. .. toctree:: :maxdepth: 2 diff --git a/docs/how-things-work/schedulers/overview.rst b/docs/how-things-work/schedulers/overview.rst index bc0bd38f7c..51750c31ce 100644 --- a/docs/how-things-work/schedulers/overview.rst +++ b/docs/how-things-work/schedulers/overview.rst @@ -6,18 +6,3 @@ operations as a means of providing users and researchers with an environment wit which they can investigate/explore dynamic operations. It will , of course, interact with any PMIx-based scheduler to support allocation requests and directives for executing jobs within an allocation. - -In addition, however, PRRTE provides a pseudo-scheduler for research purposes. The -``psched`` daemon is not a full scheduler - i.e., it does not provide even remotely -optimal resource assignments, nor is it in any way production qualified. For example, -the ``psched`` algorithms are not particularly fast and are focused more on providing -functionality than supporting large volumes of requests. - -Within that context, ``psched`` will: - -* assemble a resource pool based on the usual PRRTE resource discovery methods. This - includes reading the allocation made by a host environment, or provided by hostfile - and/or dash-host command line options. - -* upon receipt of allocation requests (either directly from tools or relayed by PRRTE), - check to see if the specified resources are available. diff --git a/docs/man/man1/index.rst b/docs/man/man1/index.rst index da27174695..a1d2e7beb0 100644 --- a/docs/man/man1/index.rst +++ b/docs/man/man1/index.rst @@ -9,5 +9,4 @@ Commands (section 1) prted.1.rst prterun.1.rst prun.1.rst - psched.1.rst pterm.1.rst diff --git a/docs/man/man1/psched.1.rst b/docs/man/man1/psched.1.rst deleted file mode 100644 index 2f44d3c548..0000000000 --- a/docs/man/man1/psched.1.rst +++ /dev/null @@ -1,189 +0,0 @@ -.. _man1-psched: - -psched -====== - -psched |mdash| a modest scheduler for PRRTE - -SYNOPSIS --------- - -.. code:: sh - - shell$ psched ...options... - -DESCRIPTION ------------ - -``psched`` is a standalone daemon that acts as a dynamic -scheduler for PRRTE. - -Extensive help documentation for this command is provided through -``psched --help [topic]``. - -COMMAND LINE OPTIONS --------------------- -The following command line options are recognized by ``psched``. - -General command line options -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -.. include:: /prrte-rst-content/cli-general.rst - -MCA parameters -^^^^^^^^^^^^^^ - -* ``--pmixmca ``: Pass context-specific PMIx MCA - parameters (``>`` is the parameter name; ```` is the - parameter value). - :ref:`See below for details `. - -* ``--prtemca ``: Pass context-specific PRRTE MCA - parameters to the scheduler. - :ref:`See below for details `. - -* ``--tune ``: File(s) containing MCA params for tuning - scheduler operations. - :ref:`See below for details `. - -Output options -^^^^^^^^^^^^^^ - -* ``--output ``: Comma-delimited list of options that control - how output is generated. :ref:`See below for details - `. - -* ``--stream-buffering ``: Control how output is buffered. - :ref:`See below for details `. - -Resource options -^^^^^^^^^^^^^^^^ - -* ``--default-hostfile ``: Provide a default hostfile. - -* ``-H`` | ``--host ``: Comma-delimited list of hosts to be - included in scheduler queues - :ref:`See below for details `. - -* ``--hostfile ``: Provide a hostfile. - :ref:`See below for details `. - -* ``--machinefile ``: Synonym for ``--hostfile``. - - -Specific options -^^^^^^^^^^^^^^^^ - -* ``--allow-run-as-root``: Allow execution as root **(STRONGLY - DISCOURAGED)**. :ref:`See below for details - `. - -* ``--daemonize``: Daemonize the scheduler into the background. - -* ``--no-ready-msg``: Do not output a "ready" message when the - scheduler has completed initializing. - -* ``--set-sid``: Direct the scheduler to separate from the current - session. - -* ``--tmpdir ``: Set the root for the session directory tree. - -* ``--report-pid ``: Print out PID on stdout (``-``), stderr - (``+``), or a filename (anything else) - -* ``--report-uri ``: Print out URI on stdout (``-``), stderr - (``+``), or a filename (anything else) - -* ``--keepalive ``: Named pipe filename to monitor |mdash| - ``psched`` will terminate upon closure - - -Debug options -^^^^^^^^^^^^^ - -* ``--debug``: Synonym for ``--leave-session-attached`` - -* ``--leave-session-attached``: Do not discard stdout/stderr of remote - PRTE daemons. - :ref:`See below for details `. - - -Details of individual command line options -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The sections below offer more detail than the abbreviated lists, -above. - -.. _label-psched-pmixmca: - -The ``--pmixmca`` option -~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-pmixmca.rst - -.. _label-psched-prtemca: - -The ``--prtemca`` option -~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-prtemca.rst - -.. _label-psched-tune: - -The ``--tune`` option -~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-tune.rst - -.. _label-psched-allow-run-as-root: - -The ``--allow-run-as-root`` option -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-allow-run-as-root.rst - -.. _label-psched-output: - -The ``--output`` option -~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-output.rst - -.. _label-psched-stream-buffering: - -The ``--stream-buffering`` option -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-stream-buffering.rst - -.. _label-psched-host: - -The ``--host`` option -~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-dash-host.rst - -.. _label-psched-hostfile: - -The ``--hostfile`` option -~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-dvm-hostfile.rst - -.. _label-psched-leave-session-attached: - -The ``--leave-session-attached`` option -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-leave-session-attached.rst - -.. _label-psched-display: - -The ``--display`` option -~~~~~~~~~~~~~~~~~~~~~~~~ - -.. include:: /prrte-rst-content/cli-display.rst - - -.. seealso:: - :ref:`prte(1) ` diff --git a/docs/session-directory.rst b/docs/session-directory.rst index 8f47a635fd..cfc93059f2 100644 --- a/docs/session-directory.rst +++ b/docs/session-directory.rst @@ -46,7 +46,7 @@ By default, the session directory name is set to where `tool` is the argv[0] of the process setting up the session directory. In most cases, this will be either `prte`, -`prterun`, or `prted` - though special tools such as `psched` +`prterun`, or `prted` - though special tools may also create a session directory tree. The session directory name includes the PID diff --git a/src/docs/Makefile.am b/src/docs/Makefile.am index 5abad91a24..6e4b0b85e0 100644 --- a/src/docs/Makefile.am +++ b/src/docs/Makefile.am @@ -38,7 +38,6 @@ dist_prtedata_DATA = \ show-help-files/help-prted.txt \ show-help-files/help-prterun.txt \ show-help-files/help-prun.txt \ - show-help-files/help-psched.txt \ show-help-files/help-pterm.txt \ show-help-files/help-ras-base.txt \ show-help-files/help-ras-pbs.txt \ diff --git a/src/docs/show-help-files/help-psched.txt b/src/docs/show-help-files/help-psched.txt deleted file mode 100644 index 2729587657..0000000000 --- a/src/docs/show-help-files/help-psched.txt +++ /dev/null @@ -1,318 +0,0 @@ -[bogus section] - -This section is not used by PRTE code. But we have to put a RST -section title in this file somewhere, or Sphinx gets unhappy. So we -put it in a section that is ignored by PRTE code. - - -Hello, world -============ - -[usage] - -%s (%s) %s - -Usage: %s [OPTION]... - -The following list of command line options are available. Note that -more detailed help for any option can be obtained by adding that -option to the help request as "--help