Prev   Next

User environment configuration

Table of Contents

1. Environment variables for GridWay

1. Environment variables for GridWay

[Important]Important

You should include the following environment variables in your shell configuration file. (example $HOME/.bashrc)

In order to set the user environment, follow these steps:

  1. Set up Globus user environment: 

    $ source $GLOBUS_LOCATION/etc/globus-user-env.sh

    or 

    $ . $GLOBUS_LOCATION/etc/globus-user-env.csh

    depending on the shell you are using.

  2. Set up the GridWay user environment: 

    	$ export GW_LOCATION=<path_to_GridWay_installation>
	$ export PATH=$PATH:$GW_LOCATION/bin

    or 

    	$ setenv GW_LOCATION <path_to_GW_location>
	$ setenv PATH $PATH:$GW_LOCATION/bin

    depending on the shell you are using.

  3. Optionally, you can set up your environment to use the GridWay DRMAA library: 

    	$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$GW_LOCATION/lib

    or: 

    	$ setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$GW_LOCATION/lib

  4. If GridWay has been compiled with accounting support, you may need to set up the DB library. For example, if DB library has been installed in /usr/local/BerkeleyDB.4.4: 

    $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/BerkeleyDB.4.4/lib

    [Note]Note

    This step is only needed if your environment has not been configured, ask your administrator.

  5. DRMAA extensions for all the languages use the dynamic drmaa libraries provided by GridWay. To use this libraries it is needed to tell the operating system where to look for them. Here are described the steps needed to do this in Linux and MacOS X.

    • 1. In linux we have two ways to do this, one is using environment variables and the other one is modifying systemwide library path configuration. You only need to use one of this methods. If you do not have root access to the machine you are using or you do not want to setup it for every user in your system you have to use the environment variable method.

      • 1.1 The environment variable you have to set so the extensions find the required DRMAA library is LD_LIBRARY_PATH with a line similar to: 

        export LD_LIBRARY_PATH=$GW_LOCATION/lib

        If you want to setup this systemwide you can put this line alongside GW_LOCATION setup into /etc/profile. If you do not have root access or you want to do it per user the best place to do it is in the user's .bashrc.

        You can also do this steps in the console before launching your scripts as it will have the same effect.

      • Systems that use GNU/libc (GNU/Linux is one of them) do have a systemwide configuration file with the paths where to look for dynamic libraries. You have to add this line to /etc/ld.so.conf: 

        <path_to_gridway_installation>/lib

        After doing this you have to rebuild the library cache issuing this command: 

        # ldconfig

    • In MacOS X you have to use the environment variable method described for Linux but this time the name of the variable is DYLD_LIBRARY_PATH.

Prev   Next
Introduction Home Functionality