Minargon - Detector Monitoring for SBN
============================================

Minargon is a website used for online monitoring in the SBN
collaboration (in the SBND and ICARUS detectors)

Quickstart
----------


To run a local copy of minargon, first create a virtual environment and activate
it.

    $ python3 -m venv env
    $ . env/bin/activate

Make sure you have a recent version of pip:

    $ pip install --upgrade pip

Note: to install minargon, you need recent versions of pip, virtualenv,
and python. Some FNAL servers don't have all these working. If you
could not follow the preceeding step, instead try the following:

On the fermilab gpvm servers, setup python v2_7_14 through
ups. Then, run the `virtualenv` commands below with `python
~gputnam/virtualenv-15.1.0/virtualenv.py` (this is an instance of
virtualenv that I have setup myself for use).

Now, clone the minargon repository, and install the prerequisites:

    $ git clone https://github.com/SBNSoftware/sbndaq-minargon.git
    $ cd sbndaq-minargon
    $ pip install -r requirements.txt

Minargon needs a configuration file to run with the settings of where
the Redis Database is located. Set by:

    $ export MINARGON_SETTINGS=`pwd`/your_settings_file.conf

Reach out to a DQM/OM expert for the settings.conf file

Now, you can start up the webserver:

    $ ./runserver.py

And you should be able to open your web browser to localhost:5000 and see it.

Note that if you are running on a remote server, you will have to
forward port 5000 back to your laptop in order to view the website. To
do this, when ssh-ing into the remote server, add in the parameter: `-L
5000:localhost:5000`.

Authors
-------
Minard was originally written for the SNO+ experiment.

Minargon is a website inspired from Minard and using some of the same
technologies.