ELisA logbook Installation Guide

ELisA logbook is developed and maintained by the ATLAS TDAQ Controls & Configuration group. The logbook application was initially created for the ATLAS experiment operations followup, as a replacement of the elog logbook. The logbook consists of a web user interface, a REST API and a set of client libraries to access the REST API functionalities. These client libs are part of the ATLAS TDAQ sw release.

Get in contact

Alina Corso-Radu (University of California Irvine) alina.radu@cern.ch

Firstly, please get in contact with the developer if you are interested in using ELisA.

The logbook developer is providing the application SW, maintenance, and further updates. Support for configuration setup is provided as well.

The client is responsible for host installation, setup, and maintenance.

The client email is added to the egroup: elisa-logbook-admins@cernNOSPAMPLEASE.ch to be informed about new RPMs available in the repository, current issues, or problems.


Install a machine with Linux CC7 as the operating system. Add Apache or another web server. Add Java-1.8 (at least)

As an alternative, we can provide a host installed and setup automatically using CERN Cloud services.

Installation path

ELisA logbook is installed in /var/local/ and is running under 'logbook' user (created automatically by the RPM).

The log files are in /var/local/elisa/logs/

The application is installed on port 8090 by default. The port number can be changed via configuration.

Logbook URL: http://your.host:8090/elisa/

RPM installation

  • Add the TDAQ repository to your host (/etc/yum.repo.d/tdaq-elisa.repo)
name=TDAQ ELisA logbook

You can choose if you want to update the RPM on your host as soon as a new version is available in the TDAQ repository or to lock the application to a given version.

  • Install the rpm using your preferred utility, for example, yum install. The user 'logbook' and the directory path are created. All necessary files are installed. The service 'elisa' is started automatically.
  • Check and change, if needed, the path to your installed java (JAVA_HOME) in /var/local/elisa/elisa.conf
  • Check the configuration you want to use in /var/local/elisa/elisa.conf file. The default configuration (profile) is "test". This configuration is using an Oracle INTR database available at CERN.

Different profiles are available already for ORACLE and MySQL.

test = ORACLE INT8R test
oracle = Generic ORACLE that needs local modification
int8r = ORACLE INT8R test
epdtdi = ORACLE DevDB11 test
epdtdi-gral = ORACLE PDBR EPDTDI
epdtdi-piquet = ORACLE PDBR EPDTDI
dune-ilaser = ORACLE PDBR EPDTDI
mysql-local = MySQL local server (mariadb)
mysql-dbod = MySQL DBOnDemand ADC

Change line PROFILE="spring.profiles.active=test" if you choose another profile. Restart the service, in this case, using systemctl restart elisa. The restart usually takes a few sec.

  • If you need to overwrite properties of an existing profile OR to use the generic 'oracle' profile:
- create subdir /var/local/elisa/config

- copy into /var/local/elisa/config the corresponding profile file which is named application-'profile'.properties from GIT here.

- modify parameter values. Do not modify the file name.

- check line PROFILE="spring.profiles.active=profile" to match the name of the application-'profile'.properties file that you overwrite.

- restart elisa with systemctl start elisa

NB: your locally modified file elisa.conf will not be overwritten if the RPM is updated.

  • If none of the existing profiles is suitable for your configuration, please contact the developer.
  • ELisA is accesible at URL: http://your.host:8090/elisa

Manual installation

Required files:

  • elisa.jar
  • src/main/webapp/WEB-INF/jsp/*.jsp
  • elisa.conf
  • elisa.service

Get jsp files, elisa.conf and elisa.service from git: https://gitlab.cern.ch/atlas-tdaq-software/elisamerge/

Download elisa.jar from http://vm-atlas-tdaq-cc-01.cern.ch:8585/repository/internal/atlas/tdaq/elisa/1.0.0/ (Contact the developer to check the last version or if you do not have access)

You need root access for the following steps.

- create user 'logbook'

useradd logbook
- create directory elisa in your installation area
cd /var/local/
mkdir elisa
cd elisa
- copy needed files in /var/local/elisa
cp -p /your/path/to/download/elisa.jar .
cp -pR /your/path/to/download/src .
cp -p /your/path/to/download/elisa.conf .
cp -p /your/path/to/download/elisa.service . 
- change ownership for all files to logbook
chown -R logbook:logbook *
- copy elisa.service file
cp elisa.service /etc/systemd/system/.
- change the path to your installed java, if needed, in elisa.conf

- check the configuration you need to use in elisa.conf. Check above for the available profiles

- change PROFILE="spring.profiles.active=test"

- start elisa service

systemctl start elisa


Logbook operation is restricted to authenticated users only. Several authentication mechanisms are used by ELisA depending on the web application visibility: CERN Single-Sign-On (SSO), LDAP server-based authentication, or Google/Github social login.
  • CERN Single-Sign-On (SSO)
If you want to use CERN SSO, you should register your host (even external to CERN domain) here: https://application-portal.web.cern.ch/. (NB: the old SSO page here: https://sso-management.web.cern.ch/). The logbook will be accessible world-wide from CERN.

Add the following request headers to your Apache configuration

RequestHeader add X-Forwarded-login  %{ADFS_LOGIN}e
RequestHeader add X-Forwarded-fullname  %{ADFS_FULLNAME}e
RequestHeader add X-Forwarded-email  %{ADFS_EMAIL}e
Once this is done, you can authenticate to ELisA via SSO.

  • LDAP-based
If the logbook visibility is restricted to a domain/project only (for example the application is available inside ATLAS Point1 only, or on GPN only), then using an LDAP server for user authentication is possible as well. LDAP configuration is done via application.properties file. The default is using CERN LDAP 'cerndc' server. Get in contact with the developer if you run the application outside CERN.

  • Social login: Google and/or Github
If you do not have an LDAP available for user authentication, you can configure the application to use Google and/or Github accounts for authentication. Get in contact with the developer for the instrucitons.

Logbook configuration

ELisA is storing the logbook configuration and messages into a database. You have a choice between two database technologies: ORACLE or MySQL. Get in contact with the developer to get a minimal database configuration to start with.

-- AlinaCorso - 2020-07-23

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r4 - 2022-01-13 - AlinaCorso
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Sandbox All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback