artdaq

h1. _artdaq_ Release Notes 1.12.13 (26-Oct-2015)

h2. Introduction

This version of _artdaq_ introduces several new features that have been requested by experiments.

Through _artdaq_core_ v1_04_20, this version of _artdaq_ can be built against _art_ v1_15_02 (s15), v1_14_02 (s11) or v1_13_02 (s8). It can also be built with _gcc_ v4_9_1 (e6) or v4_9_2 (e7) [both use -std=c++1y].

The initial builds on SciSoft include e7:s15 builds. <<Update when Jenkins builds are actually done>>

Also, artdaq can be built with the Infiniband or Ethernet MPI libraries, and these are controlled by qualifiers _ib_ and _eth_.

The default set of qualifiers for this version of _artdaq_ is _e7:s15:eth_.

h2. Reference

* Previous version's [[Release Notes 1.12.12|release notes]]

* Downloads: http://scisoft.fnal.gov/scisoft/packages/artdaq/v1_12_13 (or use pullProducts ${product_dir} slf6 artdaq-v1_12_13 [s8,s11,s15]-[e6,e7] [debug,prof]

* Nodes where this release has been deployed:

h2. External Package Changes

* "artdaq_core v1_04_20":https://cdcvs.fnal.gov/redmine/projects/artdaq/wiki/Artdaq_core_Release_Notes_10420

** "art v1_15_02":https://cdcvs.fnal.gov/redmine/projects/art/wiki/Release_Notes_11502

* "artdaq_utilities v1_00_03":https://cdcvs.fnal.gov/redmine/projects/artdaq-utilities/wiki/Artdaq_utilities_Release_Notes_10003

h2. _artdaq_ version:"v1_12_13"

h3. New features:

* Issue #10146: Provide moderate synchronization when sending fragments from multiple BoardReaders (also fulfills Issue #7245)

* Issue #10722: Add Binary output modules for disk writing and sending fragments between artdaq processes

** NetMonOutput has been replaced by RootMPIOutput. With the addition of more output modules, we decided to move to a more descriptive naming scheme for output modules.

* Issue #7244: Create a reusable UDP FragmentGenerator

* Issue #5983: Provide centralized message logging

h3. Bug fixes:

* Issue #10721: Change where we start the data collection thread in TriggerdFragmentGenerator to avoid race conditions

** Default Trigger Port for TriggeredFragmentGenerators is now 5001 (from 3001).

h3. Operational changes:

* Issue #10724: Add TRACE_NAME and MPI rank debug logging to RHandles and SHandles

* Issue #10723: Remove unnecessary socket bind() call in EventStore

* Issue #10720: Add Boost program options library to CMakeLists.txt file in Application/MPI2

* Issue #7245: Investigate whether we can use an MPI_Barrier to synchronize BoardReaders with a newer version of MPI

** MPI_SSend is being used instead of MPI_Send. This should help improve performance and reduce memory footprint.

h3. Known issues:

* %{color:red}Breaking Change:%  The name of the NetMonOutput_module has changed to RootMPIOutput_module.  Configuration files in all demo and experiment uses of artdaq will need to be changes to reflect this new name.

h2. Dependent Package Notes

* "artdaq_core v1_04_20":https://cdcvs.fnal.gov/redmine/projects/artdaq/wiki/Artdaq_core_Release_Notes_10420

* "art v1_15_02":https://cdcvs.fnal.gov/redmine/projects/art/wiki/Release_Notes_11502

* "art v1_14_02":https://cdcvs.fnal.gov/redmine/projects/art/wiki/Release_Notes_11402

* "art v1_13_02":https://cdcvs.fnal.gov/redmine/projects/art/wiki/Release_Notes_11302

* _cetbuildtools_ v4_14_02

To install this version of _artdaq_ on a new machine, you can use the following steps:

* download the <code>pullProducts</code> script from http://scisoft.fnal.gov/scisoft/bundles/tools

* <code>'chmod +x pullProducts'</code> (to make the script executable)

* <code>'cd <tarfile directory>'</code> (to avoid cluttering up the current directory with downloaded tarfiles)

* <code>'<pathToScript>/pullProducts <product_topdir> slf6 artdaq-1.12.13 s15-e7 prof'</code>

* <code>'<pathToScript>/pullProducts <product_topdir> slf6 artdaq-1.12.13 s15-e7 debug'</code>

* <code>'<pathToScript>/pullProducts <product_topdir> slf6 artdaq-1.12.13 <other sX-eY combinations> <prof|debug>'</code>