Note: This version of the VDT (1.11.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>
                      --server <y,n> 
                      --init [init options]
                      --osg-ce-probes [probe options]
                      --gridftp-probes [probe options]
                      --srm-probes [probe options]
                      --gums-probes [probe options]
                      --consumers [consumer options]
                      --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-cron is also started up. Specify n to prevent OSG-RSV Condor cron jobs will from starting.
--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')

--osg-ce-probes [probe options]
--gridftp-probes [probe options]
--gums-probes [probe options]
--srm-probes [probe options]

Configures the probes: creates Condor cron submission files for each metric found in each type of probe specified 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 at a more granular level, or to change the cron execution time, edit the metrics configuration file at $VDT_LOCATION/osg-rsv/config/HOST_metrics.conf (after running this script once). 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. For example: 'configure_osg_rsv --ce-probes --ce-uri HOST_FQDN [options]'.

Options to modify the probe submission files:

HOST FQDN OPTIONS

--ce-uri - Required if --ce-probes is specified.
--srm-uri - Required if --srm-probes is specified.
--gridftp-uri - Used if --gridftp-probes is specified.
    (Default: uses value specified by --ce-uri)
--gums-uri - Used if --gums-probes is specified.
    (Default: uses value specified by --ce-uri)
                          
    Each of the above arguments can take a list of hosts to monitor.

    (e.g. --ce-uri "host1 host2 host3 ...")

PROXY OPTIONS

--use-rsv-cert - Use a service cert to run RSV probes
    (superceedes --proxy)
--rsv-cert-file - RSV sercice cert - cert file
    (default: /etc/grid-security/rsvcert.pem)
--rsv-key-file - RSV sercice cert - key file
    (default: /etc/grid-security/rsvkey.pem)
--rsv-proxy-out-file - RSV proxy that is generated
    (default: /tmp/rsvproxy)
--proxy - If not using RSV service cert, then user proxy
    file to use (default: /tmp/x509_u<uid>)

    This will be reset to above service cert proxy if 
    --use-rsv-cert is used; 

GRATIA UPLOAD TO RSV COLLECTOP - OPTIONS

--gratia - Enable Gratia output (default = off)
--grid-type - Grid type (e.g.: OSG,OSG-ITB)
--rsv-gratia-info-file - /path/to/rsv-gratia.info file
    (defsult = '$VDT_LOCATION/osg-rsv/config/rsv-gratia.info')

OTHER OPTIONS

--srm-dir - Required if --srm-probes is specifed.
    Pass supplied argument as the SRM directory to write SRM probe 
    test files to. 
--srm-webservice-path - Will be used if --srm-probes is specifed.
    Pass supplied argument as the SRM webservice-path to be used by SRM probes
--vo-name - Pass supplied argument with --virtual-organization
    flag to the probes
--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.

Options to enable non-default consumers:

 --setup-rsv-nagios - Setup RSV-Nagios plugin 

    (to upload RSV probe output to a Nagios server)

 --rsv-nagios-conf-file - /path/to/rsv-nagios.conf file 

    (defsult = '$VDT_LOCATION/osg-rsv/config/rsv-nagios.conf')
--setup-for-apache

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

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

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