(r9) AMC13CppSoftwareBuildNotes < BUCMSPublic

Tags: view all tags
The following procedures describe the installation process for xDAQ releases for the HCAL Upgrade project.

Though these processes are presented as specific to BU's machine, the steps can easily be generalized to any other SLC5 machine which has xDAQ installed.  

*NOTE!!!*  These examples show how to install release 11_7_7, but the process can be generalized to any xDAQ release xx_x_x.

#InstallAsDaqowner
---++ Install a Release as daqowner
Before any other =cms2= users can run the release software, it must be installed by =daqowner@cms2.bu.edu=:

   1. Log in as daqowner:
   <verbatim>
   ssh daqowner@cms2.bu.edu
   </verbatim>
   1. Get the installation script from the =cmshcalweb= database:
   <verbatim>
   wget http://cmshcalweb01.cern.ch/hcalsw/release/installDAQ_11_7_7.perl
   </verbatim>
   1. Run the installation script:
   <verbatim>
   perl installDAQ_11_7_7.perl --mode=teststand
   </verbatim>
   1. Once the installation script has finished, pick the correct release:
   <verbatim>
~daqowner/common/bin/pickRelease.sh
Available installed releases
   1 )   11.0.7
   2 )   11.2.3
   3 )   11.3.1
   4 )   11.4.0
   5 )   11.4.2
   6 )   11.4.3
   7 )   11.5.0
   8 )   11.5.1
   9 )   11.5.2
   10 )   11.5.3
   11 )   11.5.5
   12 )   11.5.6
   13 )   11.6.0
   14 )   11.6.2
   15 )   11.6.3
   16 )   11.6.4
   17 )   11.6.5
   18 )   11.7.0
   19 )   11.7.1
   20 )   11.7.2
   21 )   11.7.3
   22 )   11.7.7
Pick release to use:   22
   </verbatim>

   1. Set the environment for this release:
   <verbatim>
~daqowner/dist/etc/env/env.sh
   </verbatim>
   or, if you are using the tc-shell:
   <verbatim>
~daqowner/dist/etc/env/env.csh
   </verbatim>

You are now ready to run the executables!  See the [[AMC13ToolGettingStarted][AMC13 Tool: Getting Started]] section to learn about the primary AMC13 executable.

---++ Install a release in your own source tree
If you want to edit the xDAQ code without interfering with others, then you will need to check out a copy of the release into your own source tree.  From there you can check any changes back into CVS.

   1. First, ensure that the release you want to work with is the current one, as such:
   <verbatim>
   ls -l /home/daqowner/dist
   lrwxrwxrwx 1 daqowner daq 25 Jan  5 09:56 /home/daqowner/dist -> /home/daqowner/daq.11.7.7
   </verbatim>
   If the release is not the one you want, use =pickRelease.sh= (instructions shown above) or [[#InstallAsDaqowner][install the desired release]].
   1. Copy the installation script to your login directory:
   <verbatim>
   cp ~daqowner/installDAQ_11_7_7.perl ${HOME}/
   </verbatim>
   1. If you want to check the xDAQ code out of CVS _anonymously_ (ie if you do not have an afs ID or don't care to have access to the repository), edit the script, search for "anonymous", and remove the =#= comment mark.  Otherwise, if you have an afs ID and want access to the repository, skip this step.
   1. Run the installation script, ownsourcing the code to your =${HOME}/src= directory:
   <verbatim>
   perl ~/installDAQ_11_7_7.perl --mode-teststand --ownsource=${HOME}/src/11_7_7 --packages=hcalUpgrade cvsuser=[afsID]
   </verbatim>
   NOTE that you can put the code into any directory you like; it doesn't have to be =${HOME}/src/11_7_7=.
   NOTE that you can also install additional packages, if you wish; you're not limited to the hcalUpgrade.  However, ALL of the AMC13 code lies within the hcalUpgrade package!!  If =packages= is not specified, then all packages are installed by default.
   NOTE that if you removed the "anonymous" comment mark in the previous step, you do not need the =cvsuser= argument.
   1. Set the environment for your new ownsource code development area:
   <verbatim>
   source /home/daqowner/dist/etc/env.sh
   export LD_LIBRARY_PATH=${HOME}/src/11_7_7/hcal/hcalUpgrade/amc13/lib/linux/x86_64_slc5/:${LD_LIBRARY_PATH} 
   </verbatim>
   1. If you provided your "cvsuser" afs ID (and therefore have access to the repository), update the software to the latest code in CVS (in case changes have been checked in by other parties since this release):
   <verbatim>
   cd ~/src/11_7_7/hcal/hcalUpgrade/
   cvs update
   </verbatim>
   1. Build the code in __exactly__ the following order:
   <verbatim>
   cd ~/src/11_7_7/hcal/hcalUpgrade/ipbus/
   make
   cd ../amc13
   make
   cd ../
   make
   </verbatim>
   1. After the code is done building, you have finished!  You are now ready to run the [[AMC13Tool]] executable!

If you wish to edit the AMC13 code, you can make changes to the source code in =${HOME}/src/11_7_7/hcal/hcalUpgrade/amc13/src/common/= and then go back up to the =/amc13= level to recompile using =make=. 

-- Main.EricHazen - 13 Apr 2012
Topic revision: r9 - 31 Jan 2013 - CharlieHill