Getting setup with docker and jupyterlab¶
Assuming you have docker ready, the following commands will pull a script for starting a docker container (by default named as "metrics_nb"). In the container, an instance of jupyter notebook will be started automatically. The URL to the jupyter notebook instance will be displayed in your terminal.
wget http://home.fnal.gov/~dingpf/artdaq/start_artdaq_metrics_nb.sh chmod +x start_artdaq_metrics_nb.sh
Once you get the container start script, you can pull down the notebook used for plotting metrics by:
mkdir -p notebooks; cd notebooks wget https://home.fnal.gov/~dingpf/artdaq/Plot_metrics-single_plot.ipynb wget https://home.fnal.gov/~dingpf/artdaq/Plot_metrics-multi_plot.ipynb cd ..
Then run the container start script it with:
# ./start_artdaq_metrics_nb.sh <metrics_dir_path> <notebook_dir_path> [port_number] [notebook_name] # e.g. ./start_artdaq_metrics_nb.sh /home/ron/work/artdaqPrj/demo2-develop/daqlogs/metrics ./notebooks 8880 test_nb
Once the container is up, you can open a browser to the link displayed in your terminal. Open and run the "notebooks/Plot_metrics-single_plot.ipynb" notebook. There will be two drop-down boxes asking you which log file you want to parse and which metrics you want to plot.
You can test run this on sbn-daq02.fnal.gov as user "sbnd", "root" or add yourself to the "docker" group first. Remember to shutdown the container with (this message also gets printed out when starting up the container):
docker rm -f [notebook_name] #default is metrics_nb
Note: if you want to run multiple containers, or if multiple users are running the same containers, you may need to specify port_number and notebook_name to be different from the default ones to avoid conflict.