Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You use pbs_config to configure PBS for testing

How to run pbs_config

Go to pbspro/test/fw/bin in your cloned GitHub directory structure

Syntax:

   pbs_config [<option(s)>]

Options to pbs_config

--as-diag=<pbs_diag>

Mimic pbs_diag snapshot  ### don't understand... what is variable?

--check-ug

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

--del-ug

Delete users and groups which is expected for PTL  ### what do we mean here?
Note that -t option is ignored

-l <log level>

One of DEBUG, INFO, ERROR, FATAL, WARNING
Default is ###  default?

--load-config=<config file>

Load configuration from saved file ### default, path, abs/rel?

--log-conf=<logging config file>

Defaults to ### default?  path?  abs/rel?

--make-ug

Create users and groups to match what is expected  ### what is expected?
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: operate on scheduler  ### so... we revert the scheduler?
--server: operate on server  ### we revert the  server?
--mom: operate on MoM  ### we revert the MoM?  All MoMs?
--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 revert-config and save-config can operate on the following  ### what do we mean by saving to revert-config?
--scheduler: operate on scheduler
--server: operate on server
--mom: operate on MoM

--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 <attrs>: comma <attribute list>:  Comma-separated list of attributes <attribute>=<value> pairs to set on vnodes  ### format?  <attribute> = <value> ?
format: <name>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
                    Format is <host>@<path/to/conf>.   ### what is path to 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