Mirrors 
  CERN   QMUL   		    ATLAS     Level 1     Calorimeter Trigger     Software    

L1Calo Software Atlas Online Software


L1Calo

Home
Documents
Doxygen
Links
Meetings
Packages
Prehistory
Search
Software
Cmt
Cvs
Online
Prerequisites
Rpmlist
Setup
Ssh tips
System
Vme
About
Sitemap

 

Introduction

Much of the L1Calo online software is (or will be) based on components of the Atlas Online Software.

This page contains some information on how to install it and (in future?) how we use it.

Installation

The Online Software can be downloaded via their download page. Select the appropriate version and then download all the common files, those specific for your architecture, any required external software which you dont have on your system (or which you might have incompatible versions of) and any patches to the release you selected.

To automate this slightly, I wrote a couple of simple perl scripts to help. Both of these are include in our l1calo/scripts package.

  • fetchonline.pl downloads all the files (for Linux with egcs-1.1 or gcc-2.96) for a given release and also looks for any patches to that release. You can then install the release and patches.
  • fetchexternal.pl downloads all the external libraries (for Linux with egcs-1.1 or gcc-2.96) relevant to a given release and unpacks them into the default location (if you already installed the release).
You need to chose where to install the software. For release 0.0.nn I generally use a directory be00nn in a common Atlas software area, ie be0017 for release 0.0.17. Though now the former "BackEnd" software has changed its name to Online the "be" prefix is not so obvious. The installation script will also ask you where the JDK binaries are on your system (eg /usr/local/jdk/bin).

So the procedure to get release 0.0.17 may be:

  • Checkout the l1calo/scripts package
  • Select a suitable directory for the Online software: cd somedir
  • Run fetchonline.pl 0.0.17
  • mkdir be0017 (must exist before running install.sh)
  • cd download/0.0.17
  • Run ./install.sh (with installation directory eg somedir/be0017)
  • NB you might like to save the instructions at the end
  • Source setup.sh from the installation directory (eg be00nn)
  • Run any patch scripts (BE-00nn-*.sh)
  • Try running the default "be_test" partition
  • Run fetchexternal.pl 0.0.17 (if you are missing any libraries)

Note: extra patch required

NB for version 0.0.16 we also required an extra unofficial patch BE-0016-unofficial-03.sh which you need to download and install. This patch added some extra functionality to the code generator in the IS package. This is now part of the official 0.0.17 release.

Setup

To make any regular use of the Online software, you will want to invoke the setup.sh script from your login scripts. You may also want to make further customisations, eg of paths and environment variables. I recommend creating your own setup.sh which invokes theirs and includes additional commands.

I have an example script setup.sh which I use to test prototypes of run controller and configuration database packages. This is also available in our l1calo/scripts package. You will either need to customise it a bit at your site or else create links in your home directory to match mine.

I have a link "~/onlsw" to where I keep all versions of the Online software, with "~/onlsw/pro" pointing to the latest version.

For our packages, I use "~/l1calo" as the top level. This could also be a link.

Our Use of the Atlas Online Software

Currently several of our packages, extending the configuration database (confL1Calo), and implementing our run controllers (rcL1Calo) and providing custom IGUI panels (iguiL1Calo) make extensive use of the Online Software. These packages are being prototyped. The run controllers package uses database files in our dbFiles package. At present these will need to be edited for sites other than QMUL.

Future work will include event monitoring programs and test programs suitable for use by the test manager.

Notes on the CMT Release

The Online software is now being released via CMT rather than SRT. They have made some changes in the release structure which will require us to make corresponding changes in our setup script and all our databases.

For the moment though, these changes can be worked around with a few links.

  • The IPC reference file is now in $TDAQ_INST_PATH/com/ipc_root.ref instead of $TDAQ_INST_PATH/ipc-ref/ipc_root.ref. So you need:
    cd $TDAQ_INST_PATH
    ln -s com ipc-ref
  • The database directories are now installed directly under $TDAQ_INST_PATH/databases. Previously they were in $TDAQ_INST_PATH/databases/v3. So you need:
    cd $TDAQ_INST_PATH/databases
    ln -s . v3

Last updated on 11-Sep-2002 by Murrough Landon