Skip to content

Accessing shared computing resources

This page describes the LDG Client, a software package used to simplify access to shared computing resources.

What is the LDG Client?

The LIGO Data Grid (LDG) Client is a software package set that enables access to the computing services operated by and for the LIGO Scientific Collaboration. It provides (either directly, or via dependency) authentication and access tools including

  • ligo-proxy-init - used to generate an X.509 authorisation token for access to LIGO.ORG-protected resources and services
  • gsissh - used to open an SSH connection to a host using an X.509 token

Installation instructions

Debian

Installation of the LDG Client on Debian is supported on 8.x (Jessie), 9.x (Stretch), and 10.x (Buster). Higher priority will be given to support requests for the reference platform (Stretch).

Warning: requires administrator priviledges

The installation has to be performed as 'root' user.

  1. Download and run the installation script by running the following:

    wget http://www.lsc-group.phys.uwm.edu/lscdatagrid/doc/ldg-client.sh -O /tmp/ldg-client.sh && sudo bash /tmp/ldg-client.sh
    
  2. You can ensure that LDG is correctly installed by running the ldg-version command, and checking that the output is of the form:

    ldg-version (Debian)

    LIGO Data Grid:       5.2.4
    
    Platform:             Debian 9.8
    Hostname:             f10486933a45
    Date:                 Sat 09 Mar 2019 00:14:59 UTC
    
    Globus Toolkit:       6.0.1517984806
    GSI-OpenSSH:          7.5p1b-GSI (GSI -hpn14v13)
    MyProxy:              6.1
    OSG CA Certificates:  1.79
    

Scientific Linux 7.x

Warning: requires administrator priviledges

The installation has to be performed as 'root' user.

  1. Ensure the LSCSoft Yum repositories are enabled by following the instructions here.

  2. Enable the OSG repository by installing the following package:

    rpm -ivh http://repo.opensciencegrid.org/osg/3.4/osg-3.4-el7-release-latest.rpm
    
  3. Update the repository meta-data using:

    yum clean all
    yum makecache
    
  4. Install the LDG client meta-package:

    yum install ldg-client
    
  5. You can ensure that LDG is correctly installed by running the ldg-version command, and checking that the output is of the form:

    ldg-version (SL7)

    LIGO Data Grid:       5.2.4
    
    Platform:             Scientific Linux 7.2
    Hostname:             rpmbuild7.ligo.uwm.edu
    Date:                 Mon 22 Aug 2016 15:05:44 CDT
    
    Globus Toolkit:       6.0
    GSI-OpenSSH:          7.1p2NMOD (GSI 20160606)
    MyProxy:              6.1
    OSG CA Certificates:  1.57
    

Scientific Linux 6.1

Platform not supported

This platform is no longer supported, please consider upgrading your system to one of the other platforms.

Warning: requires administrator priviledges

The installation has to be performed as 'root' user.

  1. Ensure the LSCSoft Yum repositories are enabled by following the instructions here.

  2. Install the LDG client meta-package:

    yum install ldg-client
    
  3. You can ensure that LDG is correctly installed by running the ldg-version command, and checking that the output is of the form:

    ldg-version (SL6)

    LIGO Data Grid:       5.2.4
    
    Platform:             Scientific Linux 6.1
    Hostname:             builder-sl6-1.builder.phys.uwm.edu
    Date:                 Tue 22 Sep 2015 11:00:53 CDT
    
    Globus Toolkit:       5.2.5
    GSI-OpenSSH:          5.9p1-hpn13v11 (GSI 20110906)
    MyProxy:              5.3
    OSG CA Certificates:  1.45
    

macOS

Supported versions

The Mac LDG client version 5.3.13, released on 31st August 2018, is supported on systems running OS X 10.11 (El Capitan), macOS 10.12 (Sierra), macOS 10.13 (High Sierra), and macOS 10.14 (Mojave).

Previous releases of the Mac LDG Client can be found here.

Upgrading from Mac LDG Client version 5.2.4, or higher

If you are already running version 5.2.4, or higher, of the Mac LDG Client you can use the built in ldg-upgrade script, from an administrator account, to automate upgrading to the latest version:

ldg-upgrade

$ ldg-upgrade
Version 5.3.13 of the Mac LDG Client is available, you are running 5.3.12

ldg-upgrade-1.3.5

Do you want to download this version [y/N]? y
Do you want to install this version [y/N]? y

At which point you will be prompted for your administrator password and the update will be installed.

Upgrading from Mac LDG 5.0.0 - 5.2.3

Due to changes in the upgrade process upgrading to the latest release from versions 5.0.0 to 5.2.3 is a two step process:

  1. First run the ldg-upgrade command, as discussed above, to upgrade to version 5.2.4, and
  2. then run the ldg-upgrade a second time to update to the latest version.

Upgrading from Mac LDG 4.x, or new a installation

  1. The Mac LDG installs to /opt/ldg, if you have a version of the old, pacman based, LDG installed in this location you need to remove it:

    rm -rf /opt/ldg
    

    Along with all other copies of the old LDG Client.

  2. Download the installer: ldg-client-5.3.13.pkg.

  3. Initiate the installer, from an administrator account, by double-clicking on the downloaded installer, and then follow the on-screen instructions.

  4. When the installer has finished instructions will be displayed on adding the appropriate entries to your ~/.profile login script so that the LDG binaries are made available in your environment.

  5. Once you have added the appropriate entries to your environment, source your ~/.profile and check that the LDG is functioning correctly by running the ldg-version command and ensuring the output is of the form:

    ldg-version (macOS)

    LIGO Data Grid:       5.3.13
    
    Platform:             Mac OS X 10.13.6 (17G65)
    Hostname:             phy-mercer-l2.phys.uwm.edu
    Date:                 Thu 13 Sep 2018 10:18:23 MST
    
    Globus Toolkit:       6.0.1506371041
    GSI-OpenSSH:          7.5p1b-GSI
    MyProxy:              6.1
    OSG CA Certificates:  1.74
    

Ubuntu

Supported versions

Installation of the LDG Client on Ubuntu is currently supported on 16.04 (Xenial Xerus), 18.04 (Bionic Beaver), 19.04 (Disco Dingo), and 19.10 (Eoan Ermine).

  1. Download and run the installation script by running the following:

    wget http://www.lsc-group.phys.uwm.edu/lscdatagrid/doc/ldg-client.sh -O /tmp/ldg-client.sh && sudo bash /tmp/ldg-client.sh
    
  2. You can ensure that LDG is correctly installed by running the ldg-version command, and checking that the output is of the form:

    ldg-version (Ubuntu)

    LIGO Data Grid:       5.2.4
    
    Platform:             Ubuntu 19.04
    Hostname:             e229c708ce7c
    Date:                 Sat 09 Mar 2019 00:10:42 UTC
    
    Globus Toolkit:       6.2
    GSI-OpenSSH:          7.5p1b-GSI (GSI -hpn14v13)
    MyProxy:              6.2
    OSG CA Certificates:  1.83