jive5ab's source code and scripts are available from JIVE-vlbi's github. This means that starting from versions 3.*, jive5ab will be distributed from there.
The last stable version of jive5ab on this page is
2.9.0
NOTE: m5copy is now also under git version control in JIVE-vlbi's github. This is the direct link to the
latest m5copy in that repository.
The latest stable version of m5copy is
1.58
Since Feb 27 2014, the source code for jive5ab can be downloaded. The jive5ab page contains compilation instructions.
Since Dec 11 2014, a changelog of m5copy versions is on-line. This document describes the version pointed to by the direct download link of m5copy.
Since Apr 02 2015, the changelog of jive5ab is on-line. This document has been included in the binary distributions since Debianizing. It is installed as /usr/share/doc/jive5ab/changelog . The downloadable version is for those users installing from source.
Since Aug 24 2015, the jive5ab
documentation is on-line. Version 1.2 documents
all(*) commands jive5ab accepts on the supported
systems; it is an accumulation of Mark5A, Mark5B and Mark5C
command sets, enhanced with jive5ab-specific commands. It
identifies differences with respect to Mark5A, DIMino and
drs where appropriate. Furthermore it explains some of the
inner details of jive5ab as well as introduces advanced
functionality like channel dropping or corner
turning.
Apr 07 2020: v1.11 - document new command "datastream",
update text, add Table Of Content, reflect actual command
availability better
Mar 18 2018: v1.10 - document new commands "(un)mount", fix
"dts_id?" documentation for 'crippled' Mark5s, add
long existant but undocumented 'group_def' command
Apr 27 2017: v1.9 - reflect changes due to fixing broken
"record?" reply (FlexBuff)
Jan 11 2017: v1.8 - reflect changes in "vsn" behaviour in
non-bank mode, changes in "record?" reply [this version was
never officially released]
Dec 16 2015: v1.7 - rewrite section 11 on non-bank mode plus fixes
and additions, e.g. "net_protocol=udpsnor"
Nov 13 2014: v1.4 - 'nword' parameter for fill2[file|net],
'realtime' option for spill2*
Sep 13 2015: v1.3 - document 'net_port'
Sep 07 2015: v1.2 - document 'play', more
clarification
Aug 27 2015: v1.1 - document more mem2* transfers, clarify runtime
'connect' memory
Aug 24 2015: v1.0 - initial version
(*) Well, almost all commands. Something has to be left to
be desired.
Updated Aug 27 2015: added documentation for 'runtime', 'in2fork' and 'in2memfork'.
Installation of a pre-compiled version is simple: download the .deb and then, as root run:
# dpkg -i </path/to/the/.deb>
Note: since 2.4.0 the Debian package name
has changed from "jive5a" to "jive5ab". It may be necessary to to remove
the "jive5a" first, before installing 2.4.0
or higher:
# dpkg -r jive5a
2.9.0 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4,
and source code for systems not fitting these parameters. This release contains code fixes to eliminate compiler warnings (cum errors) on new(er), stricter, standards-enforcing compilers e.g. found in Debian 9.2 and up or GCC7.*. New features added: remote mount/unmount of Mark5 disk packs as if the disk pack was keyed on/off. Finer grained hardware detection+checking to support 'crippled' Mark5's - systems with only a StreamStor card. All disk-based functionality remains working but recording (you need an I/O board or daughter card for that). Recording data rate check implemented to prevent data corruption. For full details see the changelog SDK9.2.1 version: jive5ab-2.9.0-ETCH-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.9.0-WHEEZY-SDK94-amd64.deb Source code:
jive5ab-2.9.0.tar.gz
|
2.8.1 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4,
64bit Debian Wheezy based
FlexBuff/Mark6 systems (no
StreamStor dependency)
and source code for systems not fitting these parameters. This is a bugfix update for 2.8.0, no new developments. Important fixes include but are not limited to: There is a multi-thread race condition lurking in FlexBuff "disk2file" and "disk2net" so it is advised to upgrade for non-crashing behaviour. This version can erase empty disk packs once again (2.8.0 lost this due to overfocus on non-bank mode support) The "record?" reply on FlexBuff was so broken by 2.8.0 that the Field System correctly complains loudly and bitterly For full details see the changelog SDK9.2.1 version: jive5ab-2.8.1-ETCH-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.8.1-WHEEZY-SDK94-amd64.deb 64 bit NO STREAMSTOR: jive5ab-2.8.1-WHEEZY-NOSSAPI-amd64.deb Source code:
jive5ab-2.8.1.tar.gz
|
2.8.0 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2/SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4,
64bit Debian Wheezy based
FlexBuff/Mark6 systems (no
StreamStor dependency)
and source code for systems not fitting these parameters. This is the first stable release since 2.7.1 (~ a year ago!), having something for everybody:
SDK8.2 version: jive5ab-2.8.0-ETCH-SDK82-i386.deb SDK9.2.1 version: jive5ab-2.8.0-ETCH-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.8.0-WHEEZY-SDK94-amd64.deb 64 bit NO STREAMSTOR: jive5ab-2.8.0-WHEEZY-NOSSAPI-amd64.deb Source code:
jive5ab-2.8.0.tar.gz
|
2.7.1-ack-udfix |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2/SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4
and source code for systems not fitting these parameters. This unplanned release is a backport to the latest stable
branch of jive5ab (2.7.1 branch) of a severe 32 vs 64 bit cross-system portability bug
that was first fixed in the development head. Testing of the
bugfix revealed two other issues potentially affecting
operational use which were also fixed and included in this
backport. On 64 bit systems the compiler rounded the size of the
disk info meta data structure to a different size then on 32 bit platforms. Those
structures are written verbatim to Mark5A/Mark5B user directory
layouts, thus producing differently sized user directories
depending on which system wrote them. The bug means that disk packs erased on one platform
might potentially not be recognized by software on another
platform: the data becomes mostly inaccessible but to
software that completely ignores the user directory. This is
because the user directory size is the only key to
identifying which permutation it is. To add insult to injury, nobody seems to really use this data
at all ... This update fixes the code such that on all platforms the
structures now have a consistent size. A separate structure
was added to support the erroneously sized user directories
that may have been written since the release of 64 bit
jive5ab. Note that the actual data and user directory
contents were never in danger of being lost, it's just that
the software on another platform might not be able to decode
the user directory layout. During testing it was found that failure to create a
valid user directory (for any reason) would leave the disk
pack without user directory at all and without its given
VSN. The fixed behaviour is that a failed attempt to erase
will leave the disk pack in its current state. It was also found that a failed "protect = off;"
(return code 4 "error during execution") would leave the
system in a state where the next command would be executed
as if "protect = off;" had succeeded - i.e. that it was
still possible to make modifications to the disk pack. The
fixed behaviour is to only clear the protected flag if the
"protect = off" command actually succeeds. SDK8.2 version: jive5ab-2.7.1-ack-udfix-ETCH-SDK82-i386.deb SDK9.2.1 version: jive5ab-2.7.1-ack-udfix-ETCH-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.7.1-ack-udfix-WHEEZY-SDK94-amd64.deb Source code:
jive5ab-2.7.1-ack-udfix.tar.gz
|
2.7.1 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2/SDK9.2.1 or Debian Lenny based
Mark5 A/A+/B/B+/C with SDK9.2.1/SDK9.3a or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4
and source code for systems not fitting these parameters. MIT Haystack Mark6 software writes their data files in a
subdirectory called "/data/" on each disk. jive5ab's
internal Mark6 aliases for disk modules ("1", "2", "3" and
"4") have been updated to reflect this such that a
recording's data files can be found. Also when indexing the
"eMSN" of a module, the extra "/data/" directory is
automatically added. the indexing of a Mark6 d-plane version 2 format recording
has been parallelized per disk rather than doing it
sequentially, resulting in linear speedup. shortly after the release of 2.7.0 it was discovered that
changes in the "net2file=" implementation had made it
vulnerable to a possibility where under certain
circumstances the current runtime would not be able to get
out of "net2file" state, rendering it useless. The impact on
production systems would range from mildly inconvenient
(transient runtimes as used by m5copy) to unacceptable where
the only way to regain control was to "^C" jive5ab and
restart it. it turned out that all "runtime=" command processing happened outside an error-catching block. The net effect being that in the rare occassion of a "runtime=" command failing, jive5ab would not crash but perform an orderly shutdown, as if the user had pressed "^C". This unexpected and very unpleasant behaviour is now fixed. SDK8.2 version: jive5ab-2.7.1-ETCH-SDK82-i386.deb SDK9.2.1 version: jive5ab-2.7.1-ETCH-SDK921-i386.deb jive5ab-2.7.1-LENNY-SDK921-i386.deb SDK9.3a version: jive5ab-2.7.1-LENNY-SDK93a-i386.deb 64 bit SDK9.4 version: jive5ab-2.7.1-WHEEZY-SDK94-amd64.deb Source code:
jive5ab-2.7.1.tar.gz
|
2.7.0 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2/SDK9.2.1 or Debian Lenny based
Mark5 A/A+/B/B+/C with SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4
and source code for systems not fitting these parameters. This version expands FlexBuff and Mark6 usability and
contains many bugfixes. Not in the least some fallout from
releasing the documentation was dealt with. Headlines for this release. A detailed overview of all fixes/edits is contained in the changelog file in the distribution or on this webpage (see above).
It is important to note that 2.7.0 still does NOT support the Mark6 command set. Disk module initialization, mounting and unmounting needs to be done outside jive5ab. Still, no attempt at keeping a "user directory" or grouping of disk modules is made. SDK8.2 version: jive5ab-2.7.0-ETCH-SDK82-i386.deb SDK9.2.1 version: jive5ab-2.7.0-ETCH-SDK921-i386.deb jive5ab-2.7.0-LENNY-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.7.0-WHEEZY-SDK94-amd64.deb Source code:
jive5ab-2.7.0.tar.gz
|
2.6.0 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK9.2.1 or Debian Lenny based
Mark5 A/A+/B/B+/C with SDK9.2.1 or
64bit Debian Wheezy based
Mark5 A/A+/B/B+/C with SDK9.4
and source code for systems not fitting these parameters. This version of jive5ab contains many small fixes and a big new development. Changes affecting production:
As of 2.6.0 jive5ab can record on Mark6. On both FlexBuff and Mark6 there is a choice of recording in FlexBuff mode or in native Mark6 mode - version 2 of the file format written by the MIT Haystack dplane software. It is important to note that 2.6.0 does NOT support the Mark6 command set. Disk module initialization, mounting and unmounting needs to be done outside jive5ab. Also no attempt at keeping a "user directory" or grouping of disk modules is made. SDK9.2.1 version: jive5ab-2.6.0-ETCH-SDK921-i386.deb jive5ab-2.6.0-LENNY-SDK921-i386.deb 64 bit SDK9.4 version: jive5ab-2.6.0-WHEEZY-SDK94-amd64.deb Source code:
jive5ab-2.6.0.tar.gz
|
2.5.1 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2 or Debian Etch or Lenny based
Mark5 A/A+/B/B+/C with SDK9.2
and source code for systems not fitting these parameters. Significant improvements in specific areas. If it's not listed below, it's not changed. The source code distribution contains the latest version of m5copy (1.17).
SDK8.2 version:
jive5ab-2.5.1-ETCH-SDK82-i386.deb SDK9.2 version: jive5ab-2.5.1-ETCH-SDK921-i386.deb jive5ab-2.5.1-LENNY-SDK921-i386.deb Source code:
jive5ab-2.5.1.tar.gz
|
2.5.0 |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2 or Debian Etch or Lenny based
Mark5 A/A+/B/B+/C with SDK9.2
and source code for systems not fitting these parameters. Minor update from 2.5.0-beta to official release
SDK8.2 version:
jive5ab-2.5.0-ETCH-SDK82-i386.deb SDK9.2 version: jive5ab-2.5.0-ETCH-SDK92-i386.deb jive5ab-2.5.0-LENNY-SDK92-i386.deb Source code:
jive5ab-2.5.0.tar.gz
|
2.5.0-beta |
for Debian Etch based
Mark5A/A+/B/B+/C 's with
SDK8.2 or SDK8.1 or Debian Etch or Lenny based
Mark5 A/A+/B/B+/C with SDK9.2
and source code for systems not fitting these parameters. Features in the 2.5 series of jive5ab include
SDK8.1 version:
jive5ab-2.5.0-beta-ETCH-SDK81-i386.deb SDK8.2 version:
jive5ab-2.5.0-beta-ETCH-SDK82-i386.deb SDK9.2 version: jive5ab-2.5.0-beta-ETCH-SDK92-i386.deb jive5ab-2.5.0-beta-LENNY-SDK92-i386.deb Source code:
jive5ab-2.5.0-beta.tar.gz
|
2.4.6 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or Debian Etch or Lenny based
Mark5 A/A+/B/B+ with SDK9.2 CONT14 update:
SDK8.2 version:
jive5ab-2.4.6-ETCH-SDK82-i386.deb SDK9.2 version:
jive5ab-2.4.6-ETCH-SDK92-i386.deb
jive5ab-2.4.6-LENNY-SDK92-i386.deb
|
2.4.5 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK8.1 or Debian Etch or Lenny based
Mark5 A/A+/B/B+ with SDK9.2 This is a minor update, allowing jive5ab to be used with JIVE's version of SSErase - SSErase.py. SSErase.py depends on the Python "argparse" module (https://pypi.python.org/pypi/argparse (so it's available from pypi)). SDK8.1 version:
jive5ab-2.4.5-ETCH-SDK81-i386.deb SDK8.2 version:
jive5ab-2.4.5-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.5-ETCH-SDK9-i386.deb
jive5ab-2.4.5-LENNY-SDK9-i386.deb
|
2.4.4 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 This is an IMPORTANT update, solely for Mark5B/B+ users, fixing a potential issue for geodetic/astrometric VLBI. This fix deletes an implicit "synchronize clock to 1PPS" in the "record=on" and "in2net=on" commands. This implicit synchronization could cause clock jumps on the order of a few clock cycles (samples) between recorded scans, especially on systems where 1PPS and clock are not exactly synchronized. The impact so far seems to have been minimal. This code has been in there for years and no (immediately obvious) problems have been observed in the analysis of astronomical (e-VLBI) or geodetic scans, but it would not hurt to be alert. Other fixes in this update:
SDK8.2 version:
jive5ab-2.4.4-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.4-ETCH-SDK9-i386.deb
|
2.4.3 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 This is a minor update to the 2.4.2 release only to actually fix the annoying and confusing "MARK5B FRAMENUMBER OUT OF RANGE" warning messages displayed during "scan_check?" or "data_check?". SDK8.2 version:
jive5ab-2.4.3-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.3-ETCH-SDK9-i386.deb
|
2.4.2 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 UPDATE: 30 Oct 2013 User(s) reported that the advertised fix of "MARK5B FRAMENUMBER OUT OF RANGE" warning was, in fact, not fixed; the annoying warning message remains. The problem is being diagnosed and an update will be posted as soon as it is fixed. This is a significant update to the 2.4.1 release. Annoying and
confusing warning messages during "scan_check?" or "data_check?"
have been removed. SDK8.2 version:
jive5ab-2.4.2-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.2-ETCH-SDK9-i386.deb
|
2.4.1 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 This is a minor update to the 2.4.0 release. Field testing has shown that "buffered" e-VLBI can not, at this moment, be exploited reliably on all systems. There is a subset for which it does, though. This update sets the default mode to "non buffering", allowing stations to switch it on explicitly when requested, by means of using a command line switch. SDK8.2 version:
jive5ab-2.4.1-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.1-ETCH-SDK9-i386.deb
|
2.4.0 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 This is the official release of the next generation of jive5ab: from this version on it is a direct replacement for MIT Haystack's "Mark5A" and "DIMino" programs, as well as a replacement for earlier versions of jive5a(b). This version supports the full command sets of the Mark5A,A+,B,B+ series of hard disk VLBI data recorders up to the existing e-VLBI capabilities. SDK8.2 version:
jive5ab-2.4.0-ETCH-SDK8-i386.deb SDK9.2 version:
jive5ab-2.4.0-ETCH-SDK9-i386.deb
|
2.0.4 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 or SDK9.2 This is an update to the stable 2.0 series to implement a workaround for a kernel bug causing the time reported by gettimeofday(3) to lie ~4000s in the future. This, in turn, has a devastating effect on the timing of the UDP sending code. This bug has long been fixed but unfortunately many stations are still running the old, broken, kernel. See https://lkml.org/lkml/2007/8/23/96. SDK8.2 version:
jive5a-2.0.4-SDK8-i386.deb SDK9.2 version:
jive5a-2.0.4-SDK9-i386.deb
|
2.0.2 |
for Debian Etch based Mark5A/A+/B/B+ 's with
SDK8.2 This is an update to the stable 2.0 series including the "net_port" command on all systems as well as implementing UDP back traffic to prevent switch flooding during e-VLBI. jive5a-2.0.2-i386.deb |
2.0 |
for Debian Etch base Mark5A/A+/B/B+ 's with
SDK8.2 The 2.0 version of jive5ab. Fixes support for "dot?" query and "tvr= ..." command (to keep the FieldSystem happy). jive5a-2.0-etch-SDK82-i386.deb |
2.0-beta |
for Debian Etch base Mark5A/A+/B/B+ 's with
SDK8.2 The beta version of the upcoming release of jive5ab. This version should include fixes for Mark5B(+) timing commands (dot, dot_set, dot_inc), fixes performance issues when during channeldropping no valid headers are found and many other small fixes to make jive5ab play nicely with the FieldSystem. jive5a-2.0-beta-etch-SDK82-i386.deb |
1.2.3 |
for Debian Etch base Mark5A/A+/B/B+ 's with
SDK8.2 This version fixes issues found in January 2011's testrun and supercedes the 1.2.0 release of jive5a completely. jive5a-1.2.3-etch-SDK82-i386.deb |
1.2.0 |
for Debian Etch base Mark5A/A+/B/B+ 's with
SDK8.2 This version supports channeldropping and e-VLBI with Mark5B+. Support for packetdropping as a means of limiting sending datarate to fit within available bandwidth has been dropped completely. jive5a-1.2.0-etch-SDK82-i386.deb |
Well, for the adventurous, here is the
source-code for jive5a_1411. It is a very minor enhancement (correlator side only) of
0711. I publicize it mainly for 'educational' purposes, some developers may benefit
from the code by not just looking at it but by using/expanding it. The usual
restrictions apply: we cannot be held liable for any damages resulting from (mis)usage
of the software.