You are here: TWiki> WMSMonitor Web>InstallationProcedureV2_1 (revision 2)

Introduction to v2.1 Installation and Configuration

This installation guide is divided as follows:

  • Installation of the sensors on the machine to be monitored (WMS/LB/WMSLB)
  • Installation of the data_collector server

This version of the server and of the sensor requires SL4 and snmp (installed by the installation scripts) on all the nodes.

Python, http, php and other packages are also needed on the collector machine - they will be installe automatically when the WMSMonitor packages are installed.

If sensors and/or data_collector are already running at your site, instruction on how to upgrade are given highlighted in green.

This version is installed via rpm and yum.

It is advisable, even if not required that the sensors are installed before the collector.

In case of problems during installation please contact wms-support<at>

NOTE: In release 2.0 the database schema has changed! if you are running an update from a version older that 2.0 it will be automatically ported to the new schema by the configuration script.

If you want to port the old data to the new VO statistics page please contact wms-support<at> after the instalaltion/configuration completes.

WMSMON data collector installation

(done all the following as root)

  • Install an SL4 machine (Not to be done if this is an upgrade)

  • If it is an upgrade it is safer to create a backup copy of the wmsmon database using an utility such as mysqldump

  • cd /etc/yum.repos.d
  • Download this repo file containing the WMSMonitor repository contact string:


  • cd /root
  • yum clean all
  • yum install WMSMonitor.collector
In release 2.1 the WMSMonitor rpms installs everythng under /opt/WMSMonitor (in previous releases it was under /root/wmsmon).

  • cd /opt/WMSMonitor/common
In /opt/WMSMonitor/common are installed all the files needed by all WMSMonitor components. One of this files is the wmsmon_site-info.def, it is now much easier to edit since many default parameters have been moved to the wmsmon_default.conf file.  The defaults file should usually not be changed.

  • Edit the wmsmon_site-info.def
The wmsmon_site-info.def contains all the information needed to set up correctly all the monitor components. It is important to edit it carefully using a key = value notation.

Comments can be made using # at the beginning of the line.

Inline comments help you during the editing.

If this is an upgrade please re-edit the file in the new location, now it is much easier to edit.

The important variable for a collector installation are:

- WMSMON_HOST = 'Set here the name of the wmsmon data collector host'

- WMSMON_DB_PWD = Chose a root - password for mysql - if already set use it.
- LEMONFLAG = 1 'If you do not have a lemon tool on the wms/lb instance set to 0'
- LEMONURL = 'Set to the machine lemon url if any'
- SNMPPASSWD = 'The password you choose for snmp communication between data collector and wms instance !! NOTE: it must be the same on every wmsmon_site-info.def

- WMSMON_SEVER_CONTACT_EMAIL = MAIL CONTACT that will appear in web pages error messages. Users will be invited to send email to this address.

- LB_PARA_HOST = Host publishing the LB_PARAMETER FILE that initializes lb queries. It is the procol://host:port of the http service running on the collector instances.

If you follow the instruction below for the server installation without modifying the httpd configuration it s


# Other examples in case of modified httpd conf

# http://host.domain # https://host.domain # https://host.domain:8443

If this paramemeters are not set an error will be raised a t configuration time (only a warning for the mail address)

When setting a password please read the comments in the wmsmon_site-info.def file to know if the password must be enclosed between ' '

You can ignore the LOAD BALANCING PARAMETERS section if you are not installing a load balancing arbiter.

  • cd /opt/WMSMonitor/collector/etc
  • Edit the wmslist.conf
If this is an upgrade you can maintain the same wmslist.conf file used by the previous release, but note that it is no more called wmsmonlist.con but wmslist.conf.

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_domain lb1.your_domain vo1


wmsn.your_domain 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 than 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...


  • Check that MySQL server is running (service mysqld status). If not please start it (service mysqld start)
  • Run the configuration script

The script will look for older wmsmon installations. If none is found a brand new installation will start otherwise an upgrade process will be attempted.

Errors will be reported, please pay attention to them.

If an older installation was found a wmsmon_old and /tmp/wmsmon_web_bkp directory are created containing all the old files.

When the script completes the /opt/WMSMonitor directory should have been moved to the INSTALL_PATH defined and the /var/www/html/wmsmon directory should now be in /var/www/html/WEBDIR, where WEBDIR is defined in the wmsmon_default.conf 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 change the cron file by hand, and in this case in order to optimize performance you are advised to change also the STEPDATE value in the wmsmon_default.conf 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 default.def file. By default the wmsmon_logrotate cron creates 10 files 100MB big, to modify this parameter you should change by hand the /etc/wmsmon_logrotate.cron file.

The standard 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.

Look for errors. Configuration is complete only if a string like "WMSMonitor Successfully Configured" is displayed at the end.

In case of problems please contact wms-support<at>

Edit | Attach | Print version | History: r16 | r4 < r3 < r2 < r1 | Backlinks | Raw View | More topic actions...
Topic revision: r2 - 2009-06-08 - DanieleCesini
Edit Attach

This site is powered by the TWiki collaboration platformCopyright © 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback