Installation and Configuration of Gridview Publisher Service (gridview-publisher)

Gridview Is a visualisation and monitoring tool for grid. It visualises statistics of Data transfer(Gridftp), Jobs on grid and Service Availability(SAM).

Raw monitoring data is collected by the gridview publishing service which has to be installed in gridftp servers, RBs, FTS servers and so on. The gridview publisher parses log files in these servers and publishes monitoring information using the reliable messaging system defined by the WLCG monitoring working group.

Prerequisites for installation

The gridview-publisher service requires the messaging system producer rpm (msg-publish-simple) to be installed in the system.

Installation

The gridview publisher rpm is available at http://gridview.cern.ch/GRIDVIEW/downloads/ . This rpm contains following files:

• /opt/gridview/sbin/gridview-publisher.pl : The main publishing code.
• /opt/gridview/plugins : This directory contains all publisher plugins for different monitoring information, currently only Gridftp.
• /opt/gridview/etc/gridview-publisher.conf : Main configuration file
• /opt/gridview/etc/gridview-publisher.conf.d : This directory contains configuration files for the plugins
• /etc/sysconfig/gridview-publisher
• /opt/gridview/etc/uservo.map : User name to VO mapping file
• /etc/rc.d/init.d/gridview-publisher : To start and stop the service
• /etc/logrotate.d/gridview-publisher : Logrotation configuration
• /var/log/gridview/gridview-publisher.log : Log file
• /var/run/gridview : Directory maintaining state files.

Starting and stopping the service

The gridview-publisher service can be started and stopped using standard rc style commands.

/sbin/service gridview-publisher start
/sbin/service gridview-publisher stop

Configuring the service

The configuration files for the service are present in /opt/gridview/etc directory. They are

/opt/gridview/etc/gridview-publisher.conf

This file contains general settings for the publisher such as location of log files, state files and various timeout values.

/opt/gridview/etc/gridview-publisher.conf.d

This directory contains configuration files for individual plugins - gridftp, jobstatus and so on.

/opt/gridview/etc/gridview-publisher.conf.d/GridFTP.conf

This is the configuration file for the gridftp publishing plugin. The main configurations to look for are:

• PublishViaWebService = 0 : Disables publishing by gridview web service mechanism
• PublishViaGMS = 1 : Enables publishing by messaging system
• GMSMessageClass = org.wlcg.usageTransfer : Defines the message class for gridftp publishing
• UserVoMappingFile = /opt/gridview/etc/uservo.map This file contains information to map from user names to VO names.

The file /opt/gridview/etc/uservo.map contains rules to map Linux user names to VO names. The entries look like:

#user VO map file
#format
#user:vo
atl.*:atlas
cms.*:cms
dteam.*:dteam

Each line contains a rule which consists of a username, a colon(:) and a VO name. The user name can also be expressed by a Perl regular expression. For example in the above file, all user names starting with atl map to Atlas VO.

-- RajeshKalmady - 12 Mar 2008