Download

You can download the latest version of the EGRID-ready-UI from the URL http://www.egrid.it/download/software/ui/egrid-ready-ui_LATEST.tar.bz2 Older releases can be found at the URL http://www.egrid.it/download/software/ui

Sources for the install and maintenance script can be found at http://www.egrid.it/cvs/products/egrid-ready-ui

Watch out!

The EGEE UI software is very picky and may fail mysteriously if your host does not comply with the following requirements:

• The system time must be correct! That is, your timezone must be correctly set, and your host' idea of the current time must be within five minutes from the actual correct time.

  If the time is not correct, you will most likely get authentication related errors.

• Your firewall must allow outgoing connections to the configured grids. In particular, you will need to connect:

  • to TCP port 2170 of the BDII host;
  • to TCP port 7513 of the MyProxy host;
  • to TCP ports 7772,9000,9001,9002 to the RB and WMS host;
  • to TCP ports 2119,2811,20000--25000 of any CE;
  • to TCP ports 2811,5001,8443,20000--25000 of any SE;
  • to TCP ports 8080,8088,8443 of the MON and REG hosts;
  • to TCP ports 5010 of the LFC host.

  For a complete listing, please see: https://twiki.cern.ch/twiki/bin/view/LCG/LCGPortTable#The_middleware_port_list

  In actual practice, it is simpler to just allow all outgoing connections.

Quick start

0. These instruction assume that you are running '/bin/bash' as your shell; to ensure you run bash, just type:

   bash
   

1. Untar the distribution package 'egrid-ready-ui.tar.gz' in a directory of your choice:

   tar -xjf egrid-ready-ui.tar.bz2 -C /path/to/install/dir
   

   This will extract all files in the directory /path/to/install/dir/egrid-ready-ui.

2. cd to the installation directory:

   cd /path/to/install/dir/egrid-ready-ui
   

3. Run the install script:

   ./install
   

   or

   ./install "grid"

   where "grid" is one of: "egrid", "gridats", "euindia" or "gridbox" for configuring the UI to connect to the EGRID production Grid in INFNGrid, the GRID@Trieste testbed, EUIndiaGrid testbed or a Grid-in-a-Box demo Grid, respectively. (see How to change configuration)

   If the script complains about some required software not being found, please check section Required packages below.

4. EGRID software requires a properly setup environment; to ensure your execution environment is properly set up, please log out and log back in again.

If something has gone wrong, just run the installation script again.

Testing installation

You can run the 'egrid-host-self-test' command to check that your UI host is properly configured. For instance:

egrid-ui-self-test --vo euindia

How to change configuration

The egrid-UI-change-config command allows you to change the actual configuration.

The egrid-ready-ui comes with 4 available configurations:

egrid

for the egrid VO on the EGEE/INFN-Grid production sites

euindia

for the euindia VO on EU-IndiaGrid testbed (within EGEE); see http://grid-it.cnaf.infn.it/cresti/euindiagrid/wiki/index.php?n=Main.HomePage

gridats

Grid of the GRID@Trieste project; see http://grid-trieste.org/

gridbox

To connect to a Grid-in-a-box demo Grid

To show a list of configurations available on your local box, type:

egrid-UI-change-config

Invoke egrid-UI-change-config with the name of one of the above-listed configurations to change your UI settings. For instance:

egrid-UI-change-config euindia

Required packages

The EGEE User Interface apparently depends on the Java VM 1.4.x (later version like the JVM 1.5.x will not work!) The install script will issue warnings if it is not installed.

With most modern distributions of Linux, Java comes already preinstalled, so there is no need to do anything. If you have troubles with Java, you can find below cursory generic instructions (which should be fine with almost any Linux) and specific instructions when a short-cut for a particular distro is available.

apt-get install j2re1.4

yum install j2re

wget http://dag.wieers.com/packages/j2re/j2re-1.4.2-8.1.fc1.dag.i586.rpm
rpm -i j2re-1.4.2-8.1.fc1.dag.i586.rpm