Skip to content

Commit

Permalink
update README and README.modules
Browse files Browse the repository at this point in the history
Remove reference to unsupported modules from README and README.modules
  • Loading branch information
grondo committed Jun 21, 2017
1 parent e6e6832 commit bc18115
Show file tree
Hide file tree
Showing 2 changed files with 2 additions and 61 deletions.
36 changes: 1 addition & 35 deletions README
Original file line number Diff line number Diff line change
Expand Up @@ -35,13 +35,7 @@ To configure in additional feature modules:
Enable support of ssh(1) remote shell service.

--with-machines=/path/to/machines
Use a flat file list of machine names for -a instead of
genders, nodeattr, or SDRGetObjects.

--with-qshell
Enable support for running parallel jobs on the Quadrics Elan
interconnect via the qshell service option (-R qsh) and qshell daemon.
See README.QsNet for more information.
Use a flat file list of machine names for -a instead of genders

--with-genders
Enable support of a genders database through the genders(3)
Expand All @@ -58,30 +52,13 @@ To configure in additional feature modules:
Enable use of netgroups (via /etc/netgroup or NIS) to build lists
of target hosts using -g/-X to include/exclude hosts.

--with-nodeattr=/path/to/nodeattr
Enable support of a genders database through the nodeattr(1)
command. This is primarily for older systems that do not yet
have genders(3) library support. For pdsh's -i option to
function properly, the genders database must have alternate
node names listed as the value of the "altname" attribute and
the nodeattr command must have the -r option available.

--with-nodeupdown
Enable support of dynamic elimination of down nodes through
the nodeupdown(3) library.

--with-mrsh
Enable support of mrsh(1) remote shell service.

--with-mqshell
Enable support for runnig parallel jobs on the Quadrics Elan
interconnect via the mqshell service option (-R mqsh) and
mqshell dameon. Mqshell is identical to qshell but adds munge
authentication (authentication used by mrsh).

--with-rms
Support running pdsh under RMS allocation.

--with-slurm
Support running pdsh under SLURM allocation.

Expand All @@ -94,10 +71,6 @@ To configure in additional feature modules:
--with-readline
Use the GNU readline library to parse input in interactive mode.

--without-pam
Disable PAM from the qshell and mqshell daemons. By default, they
are enabled.

Note that a number of the above configurations options may "conflict"
with each other because they perform identical operations. For
example, genders and nodeattr both support the -g option. If several
Expand All @@ -122,13 +95,6 @@ For example:
> chown root PREFIX/bin/pdsh PREFIX/bin/pdcp
> chmod 4755 PREFIX/bin/pdsh PREFIX/bin/pdcp

If you compile the qshell and/or mqshell with PAM support, remember to
update your PAM configuration files to support the "qshell" and/or
"mqshell" service names. There are sample xinetd(8) config files
for qshd and mqshd in the etc/ directory. Also be sure read the
README.QsNet file in this directory.


+---------+
| GOTCHAS |
+---------+
Expand Down
27 changes: 1 addition & 26 deletions README.modules
Original file line number Diff line number Diff line change
Expand Up @@ -39,18 +39,6 @@ Description: Rcmd connect method using Munge authentication.
Conflicts: None
Requires: munge

Module: rcmd/qsh
Package: pdsh-rcmd-qshell
Description: Run QsNet MPI jobs with pdsh.
Conflicts: rcmd/mqsh
Requires: qsnet, pdsh-qshd (qshell server)

Module: rcmd/mqsh
Package: pdsh-rcmd-mqshell
Description: Run QsNet MPI jobs with pdsh (Munge authentication)
Conflicts: rcmd/qsh
Requires: qsnet, munge, pdsh-mqshd (mqshell server)

Module: rcmd/xcpu
Package: pdsh-rcmd-xcpu
Description: Rcmd connect method using XCPU
Expand All @@ -60,15 +48,9 @@ Requires: XCPU service mounted on /mnt/xcpu/<hostname>/xcpu
Module: misc/genders
Package: pdsh-mod-genders
Description: Provides -a,-i,-g node selection options using libgenders.
Conflicts: misc/nodeattr, misc/machines, misc/dshgroup, misc/netgroup
Conflicts: misc/machines, misc/dshgroup, misc/netgroup
Requires: libgenders

Module: misc/nodeattr
Package: pdsh-mod-nodeattr
Description: Provides -a,-i,-g options using the nodeattr(1) program.
Conflicts: misc/genders, misc/machines
Requires: nodeattr program

Module: misc/nodeupdown
Package: pdsh-mod-nodeupdown
Description: Provides -v option using nodeupdown library
Expand All @@ -80,13 +62,6 @@ Package: pdsh-mod-machines
Description: Provides -a option using a flat-file list of hosts
Conflicts: misc/genders, misc/nodeattr

Module: misc/rms
Package: pdsh-mod-rms
Description: Allows list of targets to be built based off RMS_RESOURCEID
environment variable.
Conflicts: None
Requires: RMS: rmsquery, qsrmslibs

Module: misc/slurm
Package: pdsh-mod-slurm
Description: Allows list of targets to be built off SLURM_JOBID or `-j jobid'
Expand Down

0 comments on commit bc18115

Please sign in to comment.