User Tools

Site Tools


difx:nativemk5

This is an old revision of the document!


How to correlate directly off Mark5 modules

This page describes how to set DiFX up to allow “native” Mark5 correlations. This page does not cover the use of fuseMK5. In the “nativemk5” approach described here, an mpifxcorr datastream process runs on each Mark5 unit, meaning that mpifxcorr must be compliled in a manner that can be run on the Mark5 units.

1. Linux requirements

Compatibility of the Conduant streamstor drivers severely limits the choice of Linux kernels. The supported kernel versions depend on the exact version of the driver (the SDK version number) that is used. SDK version 8.2 or later are suggested as earlier versions have known stability issues related to the way the streamstor cards are accessed by DiFX. As of this writing (Nov 18, 2010) only 32-bit kernels are supported. See mixing architectures to see how to configure a cluster to support a mixture of 32 bit and 64 bit members of a cluster running mpifxcorr. Note that mixing different streamstor SDK versions across the cluster is possible, but for each a separately compiled version of the mpifxcorr binary will be required due to differences in library requirements. Differences between major SDK releases (e.g., SDK8 and SDK9) usually also have API-level changes. Currently mpifxcorr can be compiled against either SDK8 or SDK9 series.

2. Installation of Conduant's streamstor Software Development Kit (SDK)

Mark5 units as distributed by Conduant or Haystack Observatory typically have a fully installed software development kit. It may be desirable to reinstall the OS and/or upgrade the SDK. Please follow the guidelines for SDK installation provided by Conduant.

3. Installing a package-config file for streamstor

For mpifxcorr and mk5daemon to find the libraries and include files for the streamstor SDK, it is most convenient to place a package-config (.pc) file in a location identified by environment variable PKG_CONFIG_PATH. Note that the streamstor libraries must be in the LD_LIBRARY_PATH or in a system library directory for run-time linking. Two examples follow:

Example streamstor.pc for SKD8.2

prefix=/usr
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
 
Name: streamstor
Description: Conduant streamstor driver and library
Requires:
Version: 8.2
Libs: -L${libdir} -lwdapi921 -lssapi -lrt
Cflags: -I${includedir}

Example streamstor.pc for SDK9.0

prefix=/usr
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
 
Name: streamstor
Description: Conduant streamstor driver and library
Requires:
Version: 9.0
Libs: -L${libdir} -lwdapi1011 -lssapi -lrt
Cflags: -I${includedir}

4. Compilation of mpifxcorr

5. Running a correlator job

6. mk5daemon and extra functionality

difx/nativemk5.1290105358.txt.gz · Last modified: 2010/11/19 05:35 by walterbrisken