Running Monet

/nfs/sw/om/Monet/run_monet.sh

Note the server and port to connect and copy to your browser. Direct access is only available onsite at CERN, but you can access Monet from offsite using a SOCKS5 proxy through lxplus. You will have to ensure that DNS requests go through the proxy, as the np04-srv-* machines don't have world-visible IP addresses. For example, if you're using Firefox offsite to access Monet running on `np04-srv-014:8123` :

1. Set up the SOCKS5 proxy listening on port 8080 by running the following on your local (offsite) machine

     ssh -N -D 8888 username@lxplus.cern.ch
     

2. Tell Firefox to use the proxy on your machine: open the firefox preferences, go to "Network Proxy" -> "Manual proxy configuration". Set the "SOCKS host" to localhost and the port to 8080. Make sure that "Proxy DNS when using SOCKS v5" is checked.
3. Navigate to np04-srv-014:8123 in Firefox. (Not np04-srv-014.cern.ch:8123, which doesn't work)

When you're done accessing Monet, you can change the Firefox proxy setting back to "No proxy". For an easier way to set up the proxy, you can use a plugin like FoxyProxy (available via the Mozilla addons page), which allows you to specify proxies that you can turn on and off with a few clicks.

Similar strategies should work for other web browsers.

Installation

Monet was originally written by LHCb. We are using a fork with some modifications. The ProtoDUNE fork lives at https://gitlab.cern.ch/phrodrig/Monet . If you need write access, ask Philip Rodrigues.

To install your own copy for development or debugging, assuming you don't have superuser privileges on the machine you're working on:

1. Make sure ROOT (including pyroot) is installed. Monet depends on it, and it won't be automatically installed in the steps below. If you intend to use ROOT from ups, set it up with, eg, setup  root v6_08_06g -q e14:prof
2. Clone the ProtoDUNE version of the git repository:

      git clone https://:@gitlab.cern.ch:8443/phrodrig/Monet.git monet
      cd monet
     

3. If on the np04-srv-* machines, set a proxy so the machine can talk to the outside world:

      export http_proxy=http://np04-webgw1.cern.ch:3128
      export https_proxy=http://np04-webgw1.cern.ch:3128
     

4. In the monet directory, set up the monet config and run pip to install monet and all its dependencies:

      export MONET_CONFIG=`pwd`/configs/monet.dev.cfg
      pip install --user -I -e  .  # If you are superuser just do: pip install -I -e .
     

   (This will take a while and install a large number of dependencies. If you do a lot of other python development, you may want to use a virtualenv to sandbox monet and its dependencies from the rest of your python packages.)

After the installation you need to set the PYTHONUSERBASE and PYTHONPATH variables depending on where pip installed the various libraries.:

export PYTHONUSERBASE=/nfs/home/np04daq/.local
export PYTHONPATH=$PYTHONPATH:/nfs/home/np04daq/.local/lib/python2.7/site-packages/

(If you used a virtualenv, you don't need to set those variables, but you'll need to activate the virtualenv)

You can then start Monet with

python -m presenter.app

In the current implementation on /nfs/sw/om/Monet you can add new pages to the Dune Test Folder. Each page can only contain one plot. There are 2 test files used to define the list of pages and what plots they contain

The first one "/nfs/sw/om/Monet/Dune_page_file" defines the available pages, one line per page, with the format "FolderName/PageName" for example

* Dune Test Folder/Dune Test Page 00:

To add a new page simply edit the file and add a new line with the format above

The second file "/nfs/sw/om/Monet/Dune_histo_file" defines which plot are shown in the pages, one line per plot, with the format "/FolderName/PageName %%% HistoPath" where PageName is the same as the name in the Dune_page_file (note the extra / compared to the page file in front of the folder name) and HistoPath is the full path of the plot in the ROOT file excluding the file name, for example

* /Dune Test Folder/Dune Test Page 00: %%% foo/bar/plot

The %%% is used as separator. Again to add the the plot which will be shown in the new page edit the file with this format.

Once you have updated the 2 files you need to hit the Reload button on top left of Monet to reload the folder structure.