Please note: This documentation is for OSG 1.2. While we still provide critical security updates for OSG Software 1.2, we recommend you use OSG Software 3 for any new or updated installations. We are considering May 31, 2013 as possible OSG 1.2 End of Life (EOL).

Reviewed Passed
Test Passed
by TerrenceMartin
by DerekWeitzel

GUMS Client Installation Guide

About this Document

hand The GUMS Client package provides command line utilities to remotely administer GUMS. It provides the capability of retrieving information available via the gums, gums-host and gums-service commands.


Installation Instructions

  1. Create a directory for the gums-client and 'cd' into that directory:
    [user@client ~]$ mkdir -p /opt/gums-client
    [user@client ~]$ cd /opt/gums-client
  2. Set the VDT_GUMS_HOST variable to point to your GUMS Server?:
    [user@client /opt/gums-client]$ export VDT_GUMS_HOST=<YOUR_GUMS_SERVER>
    This will set the variables in $VDT_LOCATION/gums/config/ to point to your GUMS server when pacman is run.
  3. Retrieve the gums-client package from the Virtual Data Toolkit pacman cache:
    [user@client /opt/gums-client]$ pacman -get 
    When asked to trust the VDT cache, answer yall.
  4. Update your shell environment:
    [user@client /opt/gums-client]$ source $VDT_LOCATION/
  5. Run the Certificate Authority setup script:
    [user@client /opt/gums-client]$ vdt-ca-manage setupca --location local  --url osg 
    Advanced installation options for the Certificate Authority package can be found here.
  6. Enable automatic updates for the Certificate Revocation List and Certificate Authority certificates:
    [user@client /opt/gums-client]$  vdt-control --non-root --on fetch-crl vdt-update-certs 
  7. Update the Certificate Revocation List manually to avoid waiting for cron (optional)
    [user@client /opt/gums-client]$ $VDT_LOCATION/gums-client/fetch-crl/share/doc/fetch-crl-2.8.5/fetch-crl.cron 

Provided Command Line Tools

Following command line tools have been installed in $VDT_LOCATION/gums/bin :

  • gums - administrator functionality (required a grid user proxy)
  • gums-host - basic functionality (requires a grid host certificate)
  • gums-hosts-cron - cron job for gums-host (requires a grid host certificate)
  • gums-service - administrator functionality (requires a grid host and grid user certificate)

You must be permitted read access by your GUMS server installation. Contact your GUMS administrator to obtain it.

Verify the Installation

Verify the correct operation of the command line tools by generating a grid-mapfile listing remotely using the gums command:

  1. Generate a grid proxy using your grid certificate:
    [user@client /opt/gums-client]$ grid-proxy-init 
    Your identity: /DC=org/DC=doegrids/OU=People/CN=Derek Weitzel 285345
    Enter GRID pass phrase for this identity:
    Creating proxy ............................... Done
    Your proxy is valid until: Thu Jun 16 02:41:59 2011 
  2. Generate a grid-mapfile using the gums command:
    [user@client /opt/gums-client]$ gums generateGridMapfile "/DC=org/DC=doegrids/OU=Services/"  
    Replace the Distinguished Name with a Compute Element that is registered in the GUMS configuration.


Connection Failure

Verify that the gums.location and gums.authz variables defined in $VDT_LOCATION/gums/config/ point to your GUMS server. Here is an example:



PM2RPM?_TASK = 2012 RobertEngel 28 Aug 2011 - 00:32

Topic revision: r34 - 15 Jun 2016 - 17:02:33 - ElizabethChism
Hello, TWikiGuest


Installation and Update Tools


Compute Element

Storage Element

Other Site Services

VO Management

Software and Caches

Central OSG Services

Additional Information

FaceBook_32x32.png Facebook

TWiki | Report Bugs | Privacy Policy

This site is powered by the TWiki collaboration platformCopyright by the contributing authors. All material on this collaboration platform is the property of the contributing authors..