MIDAS Web Services Installation Guide

MIDAS Web Services Installation Guide (AGATA Digitizer Control)

In these notes replace [MIDASBASE] with the base of your software installation (default is /MIDAS)

Server
The file [MIDASBASE]/TclHttpd/Linux64/TclHttpd-server is a shell script (for 64 bit Linux) which starts tclsh with the script [MIDASBASE]/TclHttpd/bin/httpd-Server.tcl. During startup the file [MIDASBASE]/config/TclHttpd/[SystemName]/startup.tcl is searched for where [SystemName] can be the result of the command uname -n; localhost or omitted. This startup script loads the system specific services required. The following would load the implementation of the AGATA Digitizer Service using default options.
```
    package require AGATADigitizerAccessServer

    package require AGATADigitizerControl
```
The AGATADigitizerControl package is only needed by the AGATA Run Control system.
There are a number of configuration options. The following shows these with the default settings.
```
global env

    upvar #0 AGATADigitizerAccessServer_MaxDigitizer MaxDigitizer
    set  MaxDigitizer 16

    upvar #0 AGATADigitizerAccessServer_ConfigFile ConfigFile
    upvar #0 AGATADigitizerAccessServer_LayoutFile LayoutFile

    set ConfigFile [file join $env(MIDASBASE) config TclHttpd Samples AGATADigitizerConfig.tcl]
    set LayoutFile [file join $env(MIDASBASE) config TclHttpd Samples AGATADigitizerLayout.tcl]
    package require AGATADigitizerAccessServer

    package require AGATADigitizerControl
```
This starts both the Digitizer control service and the service which implements the AGATA Run Control.
See also here for more information on the structure of the AGATA Digitizer control software.

Note one task is to copy the file $env(MIDASBASE)/TclHttpd/Html/AGATADigitizer/AGATADigitizerConfig.tcl to $env(MIDASBASE)/config/TclHttpd/Samples/AGATADigitizerConfig.tcl and the file $env(MIDASBASE)/TclHttpd/Html/AGATADigitizer/AGATADigitizerLayout.tcl to $env(MIDASBASE)/config/TclHttpd/Samples/AGATADigitizerLogout.tcl
These files contain the IP address of each digitizer and the "friendly" name for each digitizer and so you may wish to custom for your installation. There is also an interface to do this via the web browser.

Additionally in order to save the digitizer settings the DataBase Server is required. Note that you will need to download and install the DataBase Service in the previous page.
There are a number of configuration options. The following shows these with the default settings.
```
    upvar #0 AGATADigitizerAccessServer_DBRootName RootName
    upvar #0 AGATADigitizerAccessServer_DBNodeBase NodeBase

    set RootName EXPERIMENTS
    set NodeBase AGATA/Digitizers

    Setting DataBaseRoot "/MIDAS/DB"

    package require DataBaseAccessServer
```
Finally you can obtain a log of actions. This will require that you download and install the MessageLogger Service in the previous page.
```
    upvar #0 MessageLoggerServerHost MessageLoggerServerHost
    set  MessageLoggerServerHost  localhost

    package require  MessageLoggerClient 
```

Httpd
From a Web Browser contact the URL http://[SystemName]:8015. This returns a page containing the WSDL file descriptions of the services available and a menu of available services.
The URLs http://[SystemName]:8015/AGATADigitizer and http://[SystemName]:8015/DataAcquisitionControl will directly enter the services.

V Pucknell; STFC; Daresbury Lab 13 Jan 2010