Configuring a Site to Use the Worker Node Client Software From OASIS

About This Guide

The OSG Worker Node Client is a collection of software components that is expected to be added to every worker node that can run OSG jobs. It provides a common environment and a minimal set of common tools that all OSG jobs can expect to use. See the reference section below for contents of the Worker Node Client.

It is possible to install the Worker Node Client software in a variety of ways, depending on what works best for distributing and managing software at your site:

  • Use the Worker Node Client software from OASIS (this guide) - useful when OASIS is already mounted on your worker nodes
  • Install using RPMs and Yum - useful when managing your worker nodes with a tool (e.g., Puppet, Chef) that can automate RPM installs
  • Install using a tarball - useful when installing onto a shared filesystem for distribution to worker nodes

This document is intended to guide system administrators through the process of configuring a site to make the Worker Node Client software available from OASIS.

Before Starting

As with all OSG software installations, there are some one-time (per host) steps to prepare in advance:

Also note that, once configured to use OASIS, each use of Worker Node Client software will cause that software and its associated files to be downloaded from a CVMFS server or your local cache thereof. This may result in extra network activity, especially if Worker Node Client tools are used heavily.

Configuring Your Site to Use the Worker Node Client From OASIS

Below are the one-time steps that you must perform to configure your site to use the Worker Node Client software from OASIS.

  1. On every worker node, install and configure OASIS

  2. Determine the OASIS path to the Worker Node Client software for your worker nodes:

    Worker Node OS Use…
    EL 6 (32-bit) /cvmfs/
    EL 6 (64-bit) /cvmfs/
    EL 7 (64-bit) /cvmfs/
  3. On the CE, in the /etc/osg/config.d/10-storage.ini file, set the grid_dir configuration setting to the path from the previous step

    For more information, see the OSG environment variables reference page and the CE configuration instructions.

  4. Once you finish making changes to configuration files on your CE, validate, fix, and apply the configuration:

    [root@client ~]$ osg-configure -v
    [root@client ~]$ osg-configure -c

Validating the Worker Node Client

To verify functionality of the worker node client, you will need to submit a test job against your CE and verify the job's output.

  1. Submit a job that executes the env command (e.g. Run condor_ce_trace with the -d flag from your HTCondor CE)
  2. Verify that the value of OSG_GRID is set to the directory of your WN Client installation

Manually Using the Worker Node Client From OASIS

If you must log onto a worker node and use the Worker Node Client software directly during your login session, consult the following table for the command to set up your environment:

Worker Node OS Run the following command…
EL 6 (32-bit) source /cvmfs/
EL 6 (64-bit) source /cvmfs/
EL 7 (64-bit) source /cvmfs/


Some possible issues that may come up:

  • A missing softlink to the CA certs directory. To check this, run:
    ls -l /cvmfs/

    and check that certificates is linked to somewhere. The fix is to yum update the oasis-config package to version 4 or higher. A known workaround is to run:

    export X509_CERT_DIR=/cvmfs/

    before any commands.

How to get Help?

To get assistance please use this Help Procedure.


Please see the documentation on using yum and RPM, the best practices for using yum to install software, and using yum repositories.

Worker node contents

Topic revision: r11 - 09 Mar 2017 - 01:41:29 - BrianLin
Hello, TWikiGuest!


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