Note: This version of the VDT (1.8.0) is no longer supported. Feel free to look through the documentation and install it, but we cannot guarantee support for it. The current stable release is 2.0.0.

configure_osg_rsv

configure_osg_rsv - OSG-RSV configuration script This script is used to deploy and configure the OSG Resource and Site Validation system.

Synopsis

    configure_osg_rsv --vdt-install <VDT installation root>
                      --init [init options]
                      --probes [probe options]
                      --consumers
                      --new-probe <Probe location> [spec file]
                      --help

Description

--vdt-install <VDT installation root>
configure_osg_rsv will look for the root of the VDT installation at $VDT_LOCATION. If you do not have that set you can specify it with --vdt-install instead.
--init [init options]

Generates the init script at post-install/osg-rsv. This is done for you during installation, and this option should only need to be called if it is necessary to change the user.

Options to modify the init script: --user - Change the user who the condor jobs run as. (defaults = 'mis')

--probes [probe options]

Configures the probes: creates Condor cron submission files for each metric found in each probe in $VDT_LOCATION/osg-rsv/bin/probes.

Each time this option is called, the submission files are regenerated from scratch. You must specify all necessary arguments on the commandline. If there are custom options to add for a specific metric, edit the spec file in $VDT_LOCATION/osg-rsv/specs/probes (see the README file in that directory).

To enable or disable a metric, or to change the cron execution time, edit the metrics configuration file at $VDT_LOCATION/osg-rsv/config/metrics.conf. If information for a metric exists here, it will be used instead of the default or command-line parameters. To override the configuration file, pass the --override-conf flag. For changes in metrics.conf to take effect, you need to re-run 'configure_osg_rsv --probes [options]'.

Options to modify the probe submission files:

--uri - Change the uri to monitor (default = local machine)
--proxy - Change the proxy file to point to
--gratia - Enable Gratia output (default = off)
--specs - Point to a different directory for the spec files (default = $VDT_LOCATION/osg-rsv/specs/probs)
--cron-* - The cron options set by this are global for all metrics. To set individual cron options, edit metrics.conf.
--override-conf - Ignore and overwrite metrics.conf info.
--consumers
Configures the consumers: creates Condor cron submission files for each consumer in $VDT_LOCATION/osg-rsv/bin/consumers. Consumers are run constantly with an exponential back-off method, and do not require cron time parameters.
--new-probe <Probe location> [spec file]

This option installs a new probe into $VDT_LOCATION/osg-rsv/bin/probes. A spec file may be included, which will be copied into the spec directory.

This installation will fail if a probe of the same name exists already. To override this check, use the --force option.

--help, --usage
Print a usage message.