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).

ReleaseDocumentation
GumsClientInstall
Reviewed Passed
by
Test Passed
by TerrenceMartin
Released
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.

Requirements

  • Pacman
  • GUMS Server Installation?
  • A Grid User Certificate?
  • The associated Distinguished Name need to be defined in GUMS as belonging to the admin group

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/gums-client.properties 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 http://vdt.cs.wisc.edu/vdt_200_cache:GUMS-Client 
    When asked to trust the VDT cache, answer yall.
  4. Update your shell environment:
    [user@client /opt/gums-client]$ source $VDT_LOCATION/setup.sh
  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)

HELP NOTE
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/CN=cmssrv09.fnal.gov"  
    Replace the Distinguished Name with a Compute Element that is registered in the GUMS configuration.

Troubleshooting

Connection Failure

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

  gums.location=https://gratiax31.fnal.gov:8443/gums/services/GUMSAdmin
  gums.authz=https://gratiax31.fnal.gov:8443/gums/services/GUMSAuthorizationServicePort

Comments

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

Topic revision: r33 - 15 Feb 2012 - 21:00:12 - KyleGross
Hello, TWikiGuest
Register

Introduction

Installation and Update Tools

Clients

Compute Element

Storage Element

Other Site Services

VO Management

Software and Caches

Central OSG Services

Additional Information

Community
linkedin-favicon_v3.icoLinkedIn
FaceBook_32x32.png Facebook
campfire-logo.jpgChat
 
TWIKI.NET

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..