SL6/7 Install as a User

Quick Start (from scratch, start here)

For the quickest install, go here: Quick Install
Otherwise, read on.

Choosing your computer

otsdaq currently supports Scientific Linux 6 and Scientific Linux 7, so you need a machine with one of the two installed as its operating system (Download Scientific Linux Here).

If you do not have a compatible machine, it's OK! You can use a virtual machine (VM) - the VM should work on any operating system you have. Follow these instructions for setting up your virtual machine: Creating the otsdaq Virtual Machine, or download it here (Make sure to right-click and click "Save As..."!)

If you choose VM, here are instructions for Accessing VM ots with browser on the host machine.

Downloading pre-requisites

To be sure there are no environmental variable conflicts, open a fresh terminal.
On a fresh Scientific Linux install try to run these commands (use sudo or do as root) to make sure some basics are installed:

#make sure you have a network connection before you start (e.g. open a web browser)
#   ... to access the graphic network settings window navigate like so: Applications --> System Tools --> Network 

yum install -y git libuuid-devel openssl-devel curl-devel #as root for basic tools
yum install -y gcc kernel-devel make #as root for compiling
yum install -y lsb #as root for lsb_release
yum install -y kde-baseapps #as root for kdialog
yum install -y python2-devel elfutils-devel 
yum install -y epel-release #repository to find libzstd and xxhash
yum install -y libzstd xxhash xxhash-devel

It is highly likely that you have a firewall so read section I can not access the web GUI from a remote machine!.

Pick an install directory

Assuming you are up and running with Scientific Linux 6 or 7, create an empty folder somewhere you have write access (like your home directory). For example:

#to make the path to install otsdaq
mkdir -p ${HOME}/ots

#cd into your newly created directory
cd ${HOME}/ots

Installing otsdaq

Then from within your new empty folder, run the following:

#download the quick-install script
wget -O --no-check-certificate

#change permissions so you can execute the script
chmod 755 

#execute the script targeting your current path
./ #for latest, otherwise --tag v2_02_00 .

That is pretty much it! Follow the instructions that ensue in your terminal.

Alternative installation options

#Perform a debug build
./ --debug .

#Install the develop version (read-only) of the software (may be unstable!)
./ --develop .

#Install a specific tag of otsdaq
./ --tag .

#Be more verbose
./ -v .

#Check out repositories with read/write capabilities
./ -w .

Returning to your Installation

In the future, when you start a new terminal follow these instructions to start-up your ots installation:

#change directory to your ots path
# cd ${HOME}/ots #for example

#run the setup script

#follow the instructions that ensue in your terminal

Issues with your Installation

Here you can find a list of Common Issues.

For more info on how to use otsdaq, try the User Manual .

If you get any other errors during installation, notify us by opening a new issue here (you will need to login):
New Issue

Join the otsdaq user community email forum, to hear about news and updates, by sending a blank subject email to with the body


You can then post to the user community forum by sending an email to .

Adding Source Code Repository Access to your Installation

You may find that you would like edit the source code after you have installed ots. You can add source code repositories to your installation at any time. You can choose one or many repositories to add.

If you have write access to the repositories:

mrb gitCheckout ssh://
mrb gitCheckout -d otsdaq_demo ssh://
mrb gitCheckout -d otsdaq_utilities ssh://
mrb gitCheckout -d otsdaq_components ssh://

Otherwise for read-only access to the repositories (you can modify the source, but will not be able to check-in your changes):

mrb gitCheckout -b develop
mrb gitCheckout -b develop -d otsdaq_demo
mrb gitCheckout -b develop -d otsdaq_utilities
mrb gitCheckout -b develop -d otsdaq_components