Difference: AMC13CppSoftwareBuildNotes (8 vs. 9)

Revision 931 Jan 2013 - CharlieHill

Line: 1 to 1
 
META TOPICPARENT name="HcalDTC"
Changed:
<
<
HOWTO build AMC13 C++ software on cms2.bu.edu using a private source tree, so that your work will not affect that of others. This is IMHO the preferred way to work (ESH).
>
>
The following procedures describe the installation process for xDAQ releases for the HCAL Upgrade project.
 
Changed:
<
<
First, ensure that the release you want to work with is the current one, as such:
>
>
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.
 
Changed:
<
<
  ls -l /home/daqowner/dist
  lrwxrwxrwx 1 daqowner daq 25 Sep  5 09:56 /home/daqowner/dist -> /home/daqowner/daq.11.5.2

If the release is not correct, install as necessary per instructions below, or just run pickRelease.sh to set it.

Follow instructions from Jeremy (substitute current release number)

To install on a teststand (as daqowner) :
       wget http://cmshcalweb01.cern.ch/hcalsw/release/installDAQ_11_5_2.perl
       perl installDAQ_11_5_2.perl --mode=teststand
       ~daqowner/common/bin/pickRelease.sh (choose 11.5.2)

>
>
NOTE!!! These examples show how to install release 11_7_7, but the process can be generalized to any xDAQ release xx_x_x.
 
Changed:
<
<
You can make a code-development area on a teststand or USC using: perl installDAQ_11_5_2.perl --mode=[teststand|usc] --ownsource=${HOME}/src/11_5_2 --packages=hcalUpgrade --cvsuser=[your afs id]
>
>

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:
       ssh daqowner@cms2.bu.edu
       
  2. Get the installation script from the cmshcalweb database:
       wget http://cmshcalweb01.cern.ch/hcalsw/release/installDAQ_11_7_7.perl
       
  3. Run the installation script:
       perl installDAQ_11_7_7.perl --mode=teststand
       
  4. Once the installation script has finished, pick the correct release:
    ~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
       

  1. Set the environment for this release:
    ~daqowner/dist/etc/env/env.sh
       
    or, if you are using the tc-shell:
    ~daqowner/dist/etc/env/env.csh
       
 
Changed:
<
<
If you want to use anonymous CVS (not password prompts), edit the script, search for "anonymous" and remove the comment mark.
>
>
You are now ready to run the executables! See the AMC13 Tool: Getting Started section to learn about the primary AMC13 executable.
 
Changed:
<
<
After the correct release is installed and made current (/home/daqowner/dist symlink) and you have the correct source tree installed using --ownsource, proceed:
>
>

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.
 
Changed:
<
<
source ~daqowner/dist/etc/env.sh  _or_ source ~daqowner/dist/etc/env.csh
setenv PYTHONPATH $ROOTSYS/lib:$PYTHONPATH _or_ export PYTHONPATH=$ROOTSYS/lib:$PYTHONPATH
setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${PWD}/lib/linux/x86_64_slc5/ _or_ export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${PWD}/lib/linux/x86_64_slc5/

perl ~/installDAQ_xx_x_x.perl --mode=teststand --ownsource=${HOME}/src/xx_x_x --packages=hcalUpgrade

cd src/xx_xx_xx/hcal/hcalUpgrade/
cvs update -A -d       (optional, if you want CVS code updated since the release)
cd ipbus

>
>
  1. First, ensure that the release you want to work with is the current one, as such:
       ls -l /home/daqowner/dist
       lrwxrwxrwx 1 daqowner daq 25 Jan  5 09:56 /home/daqowner/dist -> /home/daqowner/daq.11.7.7
       
    If the release is not the one you want, use pickRelease.sh (instructions shown above) or install the desired release.
  2. Copy the installation script to your login directory:
       cp ~daqowner/installDAQ_11_7_7.perl ${HOME}/
       
  3. 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.
  4. Run the installation script, ownsourcing the code to your ${HOME}/src directory:
       perl ~/installDAQ_11_7_7.perl --mode-teststand --ownsource=${HOME}/src/11_7_7 --packages=hcalUpgrade cvsuser=[afsID]
       
    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.
  5. Set the environment for your new ownsource code development area:
       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} 
       
  6. 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):
       cd ~/src/11_7_7/hcal/hcalUpgrade/
       cvs update
       
  7. Build the code in exactly the following order:
       cd ~/src/11_7_7/hcal/hcalUpgrade/ipbus/
 make
Changed:
<
<
cd .. cd amc13
>
>
cd ../amc13
 make
Changed:
<
<
cd ..
>
>
cd ../
 make
Changed:
<
<
source environ.sh (maybe only needed for python)

To run the command-line tool:

./bin/linux/x86_64_slc5/AMC13Tool.exe

To make changes in the code (your private copy):

cd src/common

edit files as desired. Go back up to .../amc13 and Make to re-compile.

>
>
  1. After the code is done building, you have finished! You are now ready to run the AMC13Tool executable!
 
Added:
>
>
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.
  -- EricHazen - 13 Apr 2012 \ No newline at end of file
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback