Skip to end of metadata
Go to start of metadata

This section describes the initial procedures for configuring the environment and highlights the requirements that computational environment must meet

CSGrid operates in a distributed environment. This environment is comprised of the client side, where the desktop web is executed, and the server side, which stores the data repository and where the CSGrid and SGA components are executed.

Summary of CSGrid Server Requirements

In summary, the software requirements are the following:

  • Linux 2.6, Solaris 10 or MS Windows
  • JDK 1.6 (JDK 6u7 or later)
    The installation of the JRE is not enough so the SDK is required. The latest version of Java shall be used always as possible, due to bug fixes and optimizations. It the server is 64bits or has more than 4GB of memory, it is important to use the 64bit version of Java.
  • ksh ("ksh" or "pdksh" packages)
  • gtar (Red Rat Linux or derivations of this distribution already have the gtar executable)
    The distribution file is binary, but contains data with the tar.gz format. The paths contained in this file exceed 100 characters, which is the limit in the tar program in Solaris. Therefore, it is recommended that the gtar program is used to open this file. If the tar program in the machines is compatible with GNU, it suffices to have a link from the tar to the gtar program.
  • Apache Server ("httpd" package), optional

Environment Variables

The administrator has to ensure that the environment is correctly configured with the server's hostname and the IP. The following commands shall be used to retrieve environment's the current configuration:

  • hostname Shows the name of the machine.
    It shall be possible to execute the ping <name> command from another machine on the same network.
  • hostname -i Shows the IP address.
    It shall be possible to execute the <ip> command from another machine on the same network.

Server Executor User

The first action to be done in order to install the CSGrid server and is to create and configure the UNIX user that will execute the system. We suggest the creation of a user named csgrid. This user needs to exist in NIS so that all computers used by the system recognize it and are able to build its home area. A 40GB area is sufficient to keep, with good margin, the files that compose the system installation.

A specific group has to be created for this user. Let's assume that the csgrid group is created. This shall be the primary group of csgrid user, so that all files created by this user belong to this group.

The home area of the user that executes the system has to be configured to allow read and write access to the user and its group. No other user shall have access to that area, not even read access.

The csgrid user needs to be recognized and have its name mounted by the computer that executes the server, and the computers that execute the SGAs.

Installation Directory

In the csgrid user home area, create a directory for the installation, for example, csgrid. Inside this directory, the installation procedure will expand the required directories and files.


Java JDK version 1.7 is required to run CSGrid 2.0 and higher. Assuming the SDK is installed in /usr/java, the following steps exemplify a procedure to update the PATH environment variable with the required Java version.

  • creates a symbolic link named "jdk" pointing to the java installation directory.
    Example: jdk -> jdk1.7.0_05/
  • defines the JAVA_HOME environment variable and puts it into the PATH variable. Normally, this is done by inserting the following lines into the /.profile of the created user: (Attention: the sintax and the name of the file depend on the type of shell used)

    export JAVA_HOME = /usr/java/jdk
    export PATH=${JAVA_HOME}/bin:${PATH}

Availability for 8080 port

In order to allow the client application to use an HTTP server, the installation provides a Tomcat server already configured to receive requests on the 8080 port. Using a browser, the client is initialized using the Java Web Start utility. The URL to access the CSGrid client installed on the Tomcat is:


server-name - is the name of the server or its IP address

Its important to ensure that the 8080 port is not being used by any other application.

In order to allow the system to be accessed by users through a simple URL, instead of a Tomcat URL, the installation of an Apache server is necessary. In this case, write access rights on the Apache directory is also necessary, for example, /var/www/html/csgrid.

Summary of SGA Requirements

For the installation of the SGAs, it is necessary to define the platform for each machine. In order to do so, the csgrid user account must contain the environment variable TEC-UNAME defined, as performed by the code block below. This variable depends on the system version, the gcc compiler version and the architecture of the machine in which it is installed.

setenv TEC_SYSNAME 'uname -s' 
setenv TEC_SYSVERSION 'uname -r|cut -f1 -d.' 
setenv TEC_SYSMINOR 'uname -r|cut -f2 -d.' 
set GCCVER='/usr/bin/gcc -dumpversion|cut -f1 -d.'
if ($GCCVER == '4') 
  setenv TEC_UNAME $TEC_UNAME'g4'
unset GCCVER

setenv TEC_SYSARCH 'uname -m'
if ($TEC_SYSARCH == 'x86_64') then
  setenv TEC_UNAME $TEC_UNAME'_64'

The administrator shall indicate to the development team which the platforms on which the SGAs will be executed, so that the required binaries are generated.

In short, the software requirements are the following:

  • cygwin (, for SGAs running on the Windows platform.
    After the installation, the cygwin must be included on the system path.
  • ksh (package "ksh"ou "pdksh")
    The ksh must be accessible through the path /bin/ksh.

Summary of Client Requirements

  • A browser compatible with Java JRE 1.6 plugin, with the option to install the Java plugin.

  • No labels