# Brief overview on AMORE

The AMORE framework will monitor SPD data in an Online mode. The following documentation is for AMORE running on normal desktops (at P2 the environment is already prepared for the shifter). Software installation instructions are available here .

AMORE makes use of the so called -amore agents-. Firstly they must be created, then they should be started. Once the agent is created, it will always run in the machine. The agent fills the histograms and publish them on a "database". To see the output of the histograms an User Interface (UI) must be started as well. It can pick up the histograms from the database and displays them according to the chosen graphics. A data monitoring can be done by means of the SPD user interface (detector - UI) or the generic userinterface.

To summarize : once the software is installed and the Amore framework well settled the user should:

## 1) How to create an AMORE agent

The command to create a new SPD amore agent is newAmoreAgent. It will return the following sequence:

This script populates the AMORE database with initial configuration settings for a single amoreAgent
Please enter an agent name [amoreAgentTST01] : amoreAgentSPD(XX)
Please enter the hostname where the agent should run [desktop-name] : mycomputer
Please enter the DET code of the agent [TST] : SPD
Please enter the hostname of the DIM node the agent should use [desktop-name] : mycomputer
Please enter the hostname which should be used as dqmPool (Should be the node which was setup with MySQL for AMORE) [desktop-name] : mycomputer
Please enter the default DATE datasource for this agent [:] :
Please enter the default AMORE PublisherModule for this agent [publisher-classname] : classname
New amoreAgent was succesfully configured

To check the agent has been created: dumpAmoreDbs and the output will be:

  Dumping AMORE configuration...+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+| host             | agentname               | detector | dimnode          | poolnode         | source | defaultmodule | configfile |+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+| mycomputer       | amoreAgentSPDXX         | SPD      | mycomputer       | mycomputer       | :      | classname     | NULL       |+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+

At the moment there are 3 classes in amoreSPD/publisher (namely: DataFormat, Hits, Clusters) and the amore agents MUST be called using XX=01 or 02 or 03.

## 2) Start the SPD agent

Command to start an (already existing) amore agent:
amoreAgent -a amoreAgentSPDXX -e (events) -s (filename)
The number of events chooses when the histogram (or whatever other object) will be published, or in other words, updated (please note this does not mean it will be updated on the UI).
For debug purposes, add -r for a recursive loops.

Dumping AMORE configuration...

+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+
| host             | agentname               | detector | dimnode          | poolnode         | source | defaultmodule | configfile |
+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+
| mycomputer       | amoreAgentSPD01         | SPD      | mycomputer       | mycomputer       | :      | Hits          | NULL       |
| mycomputer       | amoreAgentSPD02         | SPD      | mycomputer       | mycomputer       | :      | Clusters      | NULL       |
| mycomputer       | amoreAgentSPD03         | SPD      | mycomputer       | mycomputer       | :      | DataFormat    | NULL       |
+------------------+-------------------------+----------+------------------+------------------+--------+---------------+------------+



## 3) Start the UI

Command to start the SPD UI: amore -d SPD -m SPDui1
Command to start the generic UI: amore -d EVE -m GenericGui
To run the second gui, the generic GUI must be installed first. The installation package can be downloaded from this page at the installation item.

- Hints -
The installation command is rpm -i --nodeps xxx.rpm . (In case it has to be updated. just use the option -U instead of -i).
Please note the .so libraries will be installed by default in /amoreSite/lib, so thay have to be copied back to your personal \$AMORE_SITE/lib dir.