Using pbs_config

You use pbs_config to configure PBS for testing

How to run pbs_config

If you have installed PTL, this should be in your PATH.  If it is not, cd to the installation directory's bin directory.

Syntax:

   pbs_config [<option(s)>]

Options to pbs_config

--as-diag=<pbs_diag tarball>

Configure PBS according according to the specified pbs_diag output tarball.  Does not set up jobs or reservations.

--check-ug

Verifies whether test users and groups are defined as expected.
With this option, -t option is ignored.

--del-ug

By default, PTL has a pre-defined set of users and groups.  This option deletes those default users and groups.
Note that the -t option is ignored.

-l <log level>

One of DEBUG, INFO, ERROR, FATAL, WARNING.
Default is INFO.

--load-config=<config file>

Load configuration from saved file.  Path can be absolute or relative.  No default.

--log-conf=<logging config file>

Path to file containing logging configuration where you specify how to log a message, where to log it, log level, etc.  Format of logging configuration file is described in https://docs.python.org/2/library/logging.config.html#configuration-file-format.  Path can be absolute or relative.  No default. 

--make-ug

Create same set of users and groups as those created by default.
Note that -t option is ignored.

--multi-mom

Define and create multiple MoMs on a host.  Sub-options:
--create=<num>:  Number of MoMs to create. No default.
--restart=<[seq]>:  Restart MoMs in sequence
--stop=<[seq]>:  Stop MoMs in sequence
--serverhost=<host>:  Hostname of server, defaults to localhost
--home-prefix=<path>:  Prefix to PBS_HOME directory, defaults to /var/spool/PBS_m
--conf-prefix=<path>: Prefix to pbs.conf file. Defaults to /etc/pbs.conf.m
--init-port=<number>:  Initial port to allocate. Defaults to 15011
--step-port=<number>:  Step for port sequence. Defaults to 2

--revert-config 

Revert services to their default configuration
--scheduler: revert scheduler
--server: revert server 
--mom: revert all MoMs on host 
--del-hooks=<True|False>: If True delete hooks. Defaults to True
--del-queues=<True|False>: Delete non-default queues. Defaults to True


--save-config=<config>

Save configuration to file.  This file can later be used with --revert-config option.
--scheduler: save scheduler configuration
--server: save server configuration
--mom: save MoM configuration

--switch-version=<version>

Switch to a given installed version of PBS
Currently only works for "vanilla" installs, i.e, not developer installs
Based on /etc/pbs.conf and "default" PBS_EXEC

-t <hostname(s)>

Comma-separated list of hosts to operate on.
Defaults to localhost

--version

Print version number and exit

--vnodify

Define vnodes using the following suboptions:
-a <attribute list>:  Comma-separated list of <attribute>=<value> pairs to set on vnodes
                  Format: <attribute name>=<value>.
                  Defaults to 8 cpus 8gb of mem
-A: Set additive mode; leave vnode definitions in place
      Default is to clear all existing vnode definition files.
-d <y|n>: If y, delete all server nodes. Defaults to y.
-f <filename>: Use output of pbsnodes -av from file as definition
-P <num>: Number of vnodes per host
-o <filename>: Output vnode definition to filename
-M <mom>:  MoM to operate on
                    Format is <host>@<path to pbs.conf>.
                    Defaults to localhost.
-N <num vnodes>: Number of vnodes to create. No default.
-n <name>: Name of the natural vnode to create. Defaults to MoM FQDN
-p <name>: Prefix of name of node to create. Output format: prefix followed by [<num]. Defaults to vnode
-r <y|n>: Restart MoM or not, defaults to y
-s:  If set, share vnodes on the host. Default is "standalone" hosts
-u: If set, allocate the natural vnode