PAGE IS UNDER CONSTRUCTION, PLEASE COME BACK LATER

WMSMON data collector installation

(done all the following as root)

• Install an SL4 machine
  

• Download this install script file in /root : 

wget --no-check-certificate ttps://grid-it.cnaf.infn.it/certification/downloads/install_wmsmon_server-v2.0_00.py

• Run the script with the -i option to start the installation process

/root/install_wmsmon_server-v2.0_00.py -i

The script will look for older wmsmon installations. If none is found a brand new installation will start otherwise an upgrade process will be tempted.  Errors will be reported, please pay attention to them.

The root mysql password will be asked in order to check older installation.

When the script is completed the following directory shoul dbe present: /root/wmsmon, /var/www/html/wmsmon.  Now you can proceed with the configuration of the server

WMSMON data collector configuration

• Edit the /root/wmsmon/wmsmon_site-info.def file

The file is self commented, but the most foundamental variable are:

WMSMON_HOST
WMSMON_DB_PWD
SNMPUSER
SNMPPASSWD

• Edit the /root/wmsmon/wmslist.conf file
  

This file contains the list of wms present in your cluster (those were the wmsmon sensors are or will be installed).
it must be edit as shown in the template file in the following way:
wms1.your.damain lb1.your.domain vo1
....
wmsn.your.damain lbn.your.domain von

You should insert the wms/lb pairs monitored and a vo served by the pair.  The vo indication will be used only to group the wms in the wmsmon web pages, and not for the job counting per vo.
If a pair serve more taht one VO you can choose a word like multi or multiVO.  You can also use this tag to group the wms by their role: PROD, DEVEL etc...

THE FILE CANNOT BE COMMENTED.

• Run the install script with the -c option

/root/install_wmsmon_server-v2.0_00.py -c

As before pay attention to error messages, if any. 

When the script completes the /root/wmsmon/directory should have been moved to the INSTALL_PATH define in the site-info.def file and the /var/www/html/wmsmon directory should now be in /var/www/html/WEBDIR where WEBDIR is again in the .def file.

Two crons should be present in /etc/cron.d: wmsmon.cron and wmsmon_logrotate.conf.

The wmsmon.cron is the cron that launches the main data collector script.  By default it is launched every 15 mins, if you want to change this frequency you should cheng the cron file by hand, but in this case you are advised to change also the STEPDATE value in the .def file to 2x(cron frequency).

By default the data collector script logs to the /var/log/WMSMONITOR.log file, but you can configure this on the .def file.  By thefault the wmsmon_logrotate cron creates 10 files 100MB big, to modify this parameters you should change by hand the /etc/wmsmon_logrotate.cron file.

The std output of the data collector script is maintained in the /var/log/data_collector_main.log for debugging reasons, this file is rotated as the main log file, please keep it.

If no errors were reported by the configuration you should be able to find at the following url the WMSMON main page:

http://your_wmsmon_server.your.domain/wmsmon/main/main.php

If you see no data at that page, but only the top banner and an empty table it means that no data were collected and you probably need to wait for the main cron to run.

If the cron already run, it is likely that communication problems between the collector and the sensor exist and the log file should be investigated in order to find problem.

Post installation STEPS

• Increased php available memory
  
• Secure http enabled
  
• Unlock protected pages to server administrators
  
• Enable high port range communication for intra cluster monitoring
  

WMSMON uses the snmp standard port (in general the 183) for sensor-collector communications.  If a firewall blocks the snmp port it is possible to enable the communication on a not-standard port. This can be useful when the data collector and the WMS cluster are not in the same computing centre.
If you are not in this case you can skip this section.
NOTE: this feature is not well tested, please report any  problem and bug found to wms-support<at>cnaf.infn.it
To enable high port support you should modify the wmslist.conf file adding a fourth column indicating wnich is the port number to be used on that particular wms/lb pair:

wms1.your.damain lb1.your.domain vo1 port1

NOTE: it is not possible to specify 2 different port number2 for WMS and LB.

-- Main.DanieleCesini - 16 Sep 2008