NorduGrid ARC version 0.5.7

Grid Monitor
============


Description
-----------

Set of PHP- and Java- scripts, providing a Web interface to the
NorduGrid Information System. Should be working for any similar
LDAP-based service.

Requirements
------------

- GD library (http://www.boutell.com/gd/)
- LDAP library (e.g., http://www.openldap.org) (*)
- PHP4 (http://www.php.net) compiled with LDAP and GD extensions (*)
- HTTP server compiled with PHP4 (*)
- Working Globus MDS (http://www.globus.org/mds) or a similar
  LDAP-based service
- Optional: running Virtual Organisation LDAP-based service

(*) It is ABSOLUTELY NECESSARY to re-build php-ldap module using the
NorduGrid patch for OpenLDAP provided with this distribution. This
will make LDAP server connection timeouts being handled
properly. Following are build instructions (applies to php-4.3.x):
- copy ldap.c from php_ldap folder of this distribution into the
  /<php-source-top-dir>/ext/ldap/  
- run /<php-install-tree>/bin/phpize 
- ./configure --with-ldap=/<your_patched_openldap>
	      --with-php-config=/<php-install-tree>/bin/php-config
              --with...
- copy the compiled ./modules/ldap.so to
  /<php-install-tree>/lib/extensions 
- configure your HTTP server to make use of the php-ldap extension
- don't forget to restart the httpd server


Installation
------------

1. Copy all the files in a folder, accessible by the HTTP server

2. Modify "includes/settings.inc" according to your MDS structure and liking

3. Run the whole stuff by loading "loadmon.php" into your browser

Fine tuning
-----------

- Monitoring several servers at once: add hosts and DNs to the $arrhost
  and, correspondingly, $arrbdn arrays in "loadmon.php"

- Making output more human-readable: modify "/lang/*.inc", 
  "includes/cnvname.inc", "includes/cnvalias.inc". 

- Preventing sites from being polled: modify
  "includes/blacklist.inc". Otherwise, the file is not needed.

Contact
-------

Oxana Smirnova, oxana.smirnova@hep.lu.se