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.

Install a Release as daqowner

Before any other cms2 users can run the release software, it must be installed by

  1. Log in as daqowner:
  2. Get the installation script from the cmshcalweb database:
  3. Run the installation script:
       perl installDAQ_11_7_7.perl --mode=teststand
  4. Once the installation script has finished, pick the correct release:
    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:
    or, if you are using the tc-shell:

You are now ready to run the executables! See the 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:
       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 (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/
       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/
       cd ../amc13
       cd ../
  8. 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.

-- EricHazen - 13 Apr 2012

This topic: BUCMSPublic > WebHome > HcalDTC > AMC13CppSoftwareBuildNotes
Topic revision: r9 - 31 Jan 2013 - CharlieHill
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