Note: This version of the VDT (1.8.1) 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>
                      --server <y,n> 
                      --init [init options]
                      --probes [probe options]
                      --consumers
                      --setup-for-apache
                      --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.

--server <y,n>

For y OSG-RSV Condor cron jobs will be started up. This requires that condor-devel is also started up. For n OSG-RSV Condor cron jobs will not be started.

--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 = 'rsvuser')

--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/ (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/HOST_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 HOST_metrics.conf to take effect, you need to re-run 'configure_osg_rsv --probes --uri HOST [options]'.

Options to modify the probe submission files:

--uri - Required. List of hosts to monitor. (e.g. --uri "host1 host2 host3 ...")

--proxy - Change the proxy file to point to

--gratia - Enable Gratia output (default = off)

--verbose - Pass the --verbose flag to all probes

--print-local-time - Pass the --print-local-time flag to all probes

--specs - Point to a different directory for the spec files (default = $VDT_LOCATION/osg-rsv/specs/)

--cron-* - The cron options set by this are global for all metrics. To set individual cron options, edit HOST_metrics.conf.

--override-conf - Ignore and overwrite HOST_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.

--setup-for-apache

Make changes to Apache's httpd.conf file to serve OSG-RSV output HTML pages at http://HOSTNAME:8080/rsv

In order to view these pages, you will need to load your user certificate into you web browser.

--help, --usage

Print a usage message.

Condor location

OSG-RSV currently uses the Condor-Devel package (Condor 6.9 series) in order to use the new Condor Cron features. You may specify an existing pre-install of Condor 6.9.x by setting VDTSETUP_CONDOR_DEVEL_LOCATION prior to installing OSG-RSV. When this configure script is called, it tries to determine where Condor-Devel is set in the following order:

1) $VDTSETUP_CONDOR_DEVEL_LOCATION environment variable

2) $CONDOR_DEVEL_LOCATION environment variable

3) Existence of $VDT_LOCATION/condor-devel (standard location)