Documentation for the “open MoniCA” software, as maintained by the ATNF.

Currently the code is maintained at: http://code.google.com/p/open-monica/

The pcfs_prod git repository contains the oMonica svn repository under AuscopeUtils/monitoring/oMonica. A simple “svn status” should be enough to test whether there are any updates to “svn update”. Obviously it is suggested that oMonica not be updated casually, and that a careful migration process is followed.

svn is not installed on the pcfs?? machines. oMonica development work has been undertaken on ops-serv2 up to now.

Building

In order to build new oMonica .jar files, simply type “ant” in the oMonica directory. This is necessary after _any_ change to files in the relevant configuration directory (config.ops-serv, config.pcfshb, config.pcfske, config.pcfsyg). This ant procedure will generate several .jar files, one of which will be appropriate for the location you are building in. There is no need to move the .jar files anywhere to run them.

Running

To start or stop the server code, there should be a script which is invoked like:

/etc/init.d/Monica.monica start

The scripts are kept in: /usr2/AuscopeUtils/monitoring/init.d/

To start a client simply run the script “omc.sh”, which is in the ~oper directory on pcfshb. (you will need X forwarding, as it will wish to launch a window). More details can be obtained by reading /usr2/AuscopeUtils/monitoring/oMonica/README.sh

Note that you will have a much better experience if you run the client on a server which is “near” to you. So while in Sandy Bay, I would suggest running the ~observer/omc.sh script on ops-serv2.

The first popup relates to selecting a server to read information from.

Once a server has been selected, you will get a Monitor Display with with to view data. Viewing modes can be accessed through the menu: Setup → Add Panel → select.

Two very popular options are Point Table (useful for seeing many points at once) and Time Series (useful for obtaining a historical perspective).