Installation: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(15 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
[[Category:Installation]]
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, you don't have the proper certificates installed on your computer. The easiest way out is to tell git to ignore the SSL verification with
 
* git config --global http.sslVerify false
 
You can see a list of other installation problems at [[Common problems & Debugging recipes]].
 
See also [[Setup_MIDAS_experiment|MIDAS installation instructions for TRIUMF experiments]] for more specific installation issues.
 
=== Quick Start ===
example
 
[[Category:Contents]]

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.