Note: This version of the VDT (1.10.1) is supported, but is not our latest stable release. 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
    (default = '$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://THIS_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.