GnaMon

This page provides some information and instructions about how to run and use the ATLAS monitoring tool gnaMon.

Introduction

Getting gnaMon

Download the latest stable release

Checkout the gnaMon java archive

svn export svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk/dist gnaMon

Checkout the external dependencies

svn export svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk/lib gnaMon/lib

In case you want to be able to use the remote monitoring features, you also need the following line

svn export svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk/jssecacerts gnaMon/jssecacerts

Start gnaMon (requires Java JRE-1.6)
java -jar gnaMon.jar

You can also download the tube map and the list of known hardware issues as a local file if you don't have access to the database.
svn export svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk/tube.map.gz gnaMon/tube.map.gz
svn export svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk/MdtDeviceStates.txt.gz gnaMon/MdtDeviceStates.txt.gz

Download the source code from SVN

You only need to check out the source code if you want to do some code development. If you simply want to run the application, please refer to the next section called Download the latest stable release.

For this to work you need Apache Ant 1.8 and Java JDK-1.6.

svn co svn+ssh://svn.cern.ch/reps/muondaq/gnaMon/trunk gnaMon
cd gnaMon
ant run

Starting gnaMon

Running on lxplus

Tip: On lxplus the default Java is only of version 1.5, however there is Java-1.6 available through the tdaq software. Change into the gnaMon directory and use the command

/afs/cern.ch/atlas/project/tdaq/inst/sw/lcg/external/Java/JDK/SUN_1.6.0_16/ia32/bin/java -jar gnaMon.jar

Starting gnaMon for the first time

The first time you start gnaMon, you need to set some paths. First start gnaMon by callling

java -jar gnaMon.jar

now you need to set three paths:

• tnsnames.ora

The first path you need to set is a path to the Oracle file tnsnames.ora, which contains the connection strings to the CERN databases. In case you do not yet have such a file you can obtain it from /afs/cern.ch/project/oracle/admin/tnsnames.ora. To set the path open the preferences via the Tools->Preferences menu. On the tab Database you have to select your tnsnames.ora file.

• MDT tube map

The next path you need to set is to point gnaMon to the MDT tube mapping. You can either use the database or you can use the standalone file tube.map.gz mentioned in section Download the latest stable release. You can set this also via the Tools->Preferences menu in the General tab.

• MDT device states

The last path you need to set is for the list of known hardware issues. Once again, you can use the database or the standalone file MdtDeviceStates.txt.gz mentioned in section Download the latest stable release. To load this select the menu File->Import->Device States... and choose your option.