You are here: Home The ICTP Ready UI Installation
Personal tools
Document Actions

Installation

by Riccardo Di Meo last modified 2008-03-17 17:36

How to install the ICTP ready UI

This page is still work in progress

(enjoy the content already here and please, be patient)

Installation.

The ICTP_UI.tar.bz2 archive contains the required files for installing the gLite User Interface on a client machine, except for a few common packages which should already be installed on any modern Linux box. The software contains an install script that warns about missing required packages or version conflicts, and allows for easy configuration of the UI for several different GRIDs and VOs.

Modifications performed to the host.

The ICTP Ready UI tries hard to limit the number of changes on the host system, however in order for the grid middleware to work properly, some modifications necessary.

This is the list of changes that the UI will do on the system; since all of them are performed with normal user privileges, simply creating a separate account for the UI only (if possible) will avoid any unwanted interaction with your account (if any):

  • A link called .glite will be created in the $HOME (this is due to a bug about the way the glite-wms-* software reads the GLITE_LOCATION and GLITE_WMS_LOCATION variables...)

  • A section is added in your .bashrc file in order for the appropriate variables to be loaded, e.g.:

    export ICTP_INSTALL_DIR=<inst. dir>/ictp_ui
    export PATH=<inst. dir>/ictp_ui/bin:$PATH
    export MANPATH=<inst. dir>/ictp_ui/sw/edg/share/man (...) 
  • An entry is added in your crontab in order for the certificates to be updated periodically.

System Requirements.

Due to the unforgiving nature of the EGEE UI software, the ICTP Ready UI (which is based on it) 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 (to connect to the BDII)
    • to TCP port 7513 (for the MyProxy)
    • to TCP ports 7772,9000,9001,9002 (for the RB and WMS)
    • to TCP ports 2119,2811,20000--25000 (for connections to the CEs)
    • to TCP ports 2811,5001,8443,20000--25000 (for connections to the SEs)
    • to TCP ports 8080,8088,8443 (for the MON and REG)
    • to TCP ports 5010 (for the LFC)

For a complete listing, please see: the LCG Port Table at twiki.

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

Please also keep in mind that each job of the type "Interactive" also need 1 port for incoming connection (to have a fully compliant UI in fact, the ports 20000-25000 should be kept open for incoming connection).

Keep also in mind that some incompatibilities might arise between binaries statically linked in systems with 2.6 kernels and grids where the WNs use kernels with version 2.4 (e.g. based on Scientific Linux 3.0)

This is due to the fact that newer glibc libraries are often compiled without backward compatibility to older kernels.

Workarounds are:

  • Compiling the binary dynamically, if possible (e.g. if the code doesn't use exotic libraries).
  • Installing on the UI a version of the glibc compiled with compatibility up to 2.4 kernels and link the codes against it.
  • Carry on the linking step (other steps can be execute everywhere) on a 2.4 kernel host.

Software requirements

Most of the software necessary for the UI comes in the package already, for compatibility reasons (the glite software as well as some other doesn't seem to like the new libc very much).

However the ICTP ready UI still needs java (theoretically only version 1.4 is supported, again due to comp. issues :-( ) to be installed on the machine in order for some commands to work (though most commands doesn't need it...).

Be aware that only the BASH shell is supported: the ICTP ready UI will not work with csh or other shells! (sorry)

Download

The latest version of the package can be found in the EU-India GRID page at ICTP:

http://euindia.ictp.it/download/ICTP-UI/ICTP_UI.tar.bz2

Installation

During the installation procedure, the configuration script will try to download some required certificates from the network, therefore a connection to the Internet should be present for the UI to be fully functional (though a cron job is created that will update the revocation list periodically and can be used to correct the problem).

  1. Download the package:

     

    $ wget -c -t0 http://euindia.ictp.it/download/ICTP-UI/ICTP_UI.tar.bz2
    

     

  2. Untar it in a directory of your choice (the home directory is fine):

     

     
    $ tar xvjf ICTP_UI.tar.bz2
    

     

  3. Enter the newly created directory ictp_ui and execute the command ./install.sh euindia:

     

     
    $ cd ictp_ui
    $ ./install.sh euindia
    

     

  4. Wait until the procedure terminates (it will take a while, mainly due to the download of the updated certificates), and reload your environment variables (logging in and out of your shell should do).

  5. Finally, install your grid certificates in the account (see the grid documentation in order to do that).

« October 2017 »
Su Mo Tu We Th Fr Sa
1234567
891011121314
15161718192021
22232425262728
293031
 

Powered by Plone This site conforms to the following standards: