Installation: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Pagelinks}}
{{Pagelinks}}


=== Standard layout of MIDAS experiment ===
== Install MIDAS ==
This layout includes other packages needed for data analysis but not required for acquisition purpose only (noted as **). The online directory is given only as a suggested structure.
<pre>
/home/exptuser/
  packages/
    root <---- ROOT (64-bit or 32-bit) (**)
    mxml  <---- from MIDAS repository
    midas <---- MIDAS
      linux/{lib,bin}  <---- binaries matching the selected 64-bit/32-bit flavour of ROOT
      linux-m32/{lib,bin}  <---- limited function 32-bit binaries for 32-bit frontend machines, build by "make linux32"
      linux-m64/{lib,bin}  <---- limited function 64-bit binaries (only needed if ROOT and linux/bin are 32-bit)
      linux-crosscompile/{lib,bin}  <---- cross-compiled limited function binaries for PPC and ARM frontends (see Makefile)
  online/
    exptab <---- experiment definition
    {.ODB,.SYSTEM,.SYSMSG,etc}.SHM <---- MIDAS shared memory save files
    src <---- experiment frontend sources
    bin,scripts
    elog <---- MIDAS elog (**)
    history <---- MIDAS history
    data -> /data/exptname/current <---- symlink to the data directory (**)
/data/exptname/current <---- experiment data directory with ODB save files and MIDAS .mid/.mid.gz data files
</pre>


=== Valid OS list ===
There are two sets of instructions for installing MIDAS:
Midas is compatible with:
* linux : Maintained
* Darwin : Maintained
* freeBSD : Maintained
* Arm : On Raspberry Pi
* VxWorks : Rarely used, still maintained
* OSF1 : Not used for quite a while
* ultrix : Not used for quite a while
* solaris : No used for quite a while
* Cygwin : Not used for quite a while
* PPC405 : Not used for quite a while


=== External libraries/packages consideration ===
* [[Quickstart Linux]]
Midas requires:
* [[Setup_MIDAS_experiment|MIDAS installation instructions for TRIUMF experiments]]
* '''gcc''' compiler
* '''zlib''' library.
* '''c++11''' compiler for latest frontend applications.


=== Environment Variables consideration ===
There is a page dealing with common problems:
* '''MIDASSYS''' Base directory of the MIDAS package, midas and mxml should be at the same level.
* '''MIDAS_EXPTAB''' Experiment definition file
* '''MIDAS_SERVER_HOST''' MIDAS host server name for remote midas connections.
* '''MIDAS_EXPT_NAME''' Experiment name


(csh)
* [[Installation/Compilation problems|Common Installation Problems]]
<pre>
setenv LANG C
setenv GIT_EDITOR "emacs -nw"
setenv MIDASSYS $HOME/packages/midas
setenv ROOTSYS  $HOME/packages/root
setenv MIDAS_EXPTAB $HOME/online/exptab
setenv PATH .:$MIDASSYS/linux/bin:$PATH
setenv PATH .:$HOME/online/bin:$ROOTSYS/bin:$PATH
# For default remote Midas server to myhost
setenv MIDAS_SERVER_HOST myhost00:7071


# For default remote Midas server to a given port
For TRIUMF experiments, there are pages dealing with recommended configurations and packages for DAQ machines running Linux:
setenv MIDAS_SERVER_HOST myhost00:7071


# For no default on remote Midas server
* RHEL/SL/CentOS Linux: https://daq00.triumf.ca/DaqWiki/index.php/SLinstall
unsetenv MIDAS_SERVER_HOST
* Ubuntu Linux: https://daq00.triumf.ca/DaqWiki/index.php/Ubuntu


# For default Midas experiment
For MacOS installation, please follow the Linux instructions.
setenv MIDAS_EXPT_NAME deap
</pre>


For Windows installation, TBW.


(bash)
There is also a [[Changelog|Changelog and upgrade guide]] for major releases.
<pre>
export LANG=C
export MIDASSYS=$HOME/packages/midas
export PATH=$PATH:$MIDASSYS/linux/bin
export MIDAS_EXPTAB=/home/deap/exptab
 
# For default remote Midas server to myhost
export MIDAS_SERVER_HOST=myhost00:7071
 
# For default remote Midas server to a given port
export MIDAS_SERVER_HOST=myhost00:7071
 
# For no default on remote Midas server
export MIDAS_SERVER_HOST=
 
# For default Midas experiment
export MIDAS_EXPT_NAME=deap
</pre>
 
=== Installing MIDAS ===
* mkdir $HOME/packages
* Logout and login again, for .cshrc or bash changes to take effect
 
* cd $HOME/packages
* git clone https://bitbucket.org/tmidas/midas
* git clone https://bitbucket.org/tmidas/mxml
* (IF BITBUCKET IS DOWN) git clone -v --progress http://daq.triumf.ca/~daqweb/git/mxml.git
* (IF BITBUCKET IS DOWN) git clone -v --progress http://daq.triumf.ca/~daqweb/git/midas.git
* cd midas
* make
* (only if needed) make linux32 ### build the 32-bit MIDAS libraries on 64-bit machine
* ls -l linux/bin/odbedit ### check that odbedit has been created (do not run it yet)
 
If you get a SSL server certificate error during the git clone operation see [[Installation/Compilation problems#SSL certificate errors|SSL certificate errors]].
 
 
=== Setup a MIDAS experiment ===
See [[Setup_MIDAS_experiment|MIDAS installation instructions for TRIUMF experiments]] for further information.
 
=== Quick Start ===
example


[[Category:Installation]]
[[Category:Installation]]

Latest revision as of 08:03, 1 August 2023


Install MIDAS

There are two sets of instructions for installing MIDAS:

There is a page dealing with common problems:

For TRIUMF experiments, there are pages dealing with recommended configurations and packages for DAQ machines running Linux:

For MacOS installation, please follow the Linux instructions.

For Windows installation, TBW.

There is also a Changelog and upgrade guide for major releases.