SiLK Analysis Suite

File Release Notes and Changelog

Release Name: silktools-0.4

Notes:
Release 0.4.  Friday March 19, 2004

Public releases of the SiLK Tool Suite prior to this release (v0.3 and
earlier) contained a bug that affected the packing of web records.
This bug caused the source and destination ports for web records to be
swapped, e.g., web connections from your network to sourceforge.net
would show the sourceforge.net web service on a high port and have
your client machine on port 80.

This v0.4 release fixes that bug, and we've provided a Perl script,
rwpatchwww.pl, that will repair files you've packed with previous
versions.  The rwpatchwww.pl script will also migrate your all of your
packed files to Version 2 of the SiLK file format.  Release v0.4 of
the SiLK Tools will read files packed either in Version 1 or Version 2
format.

The suggested upgrade path is as follows:

1. Download, build, and install this new release.
2. Shut down the packing tool, rwflowpack.
3. Use the rwpatchwww.pl Perl script to upgrade your files.

Assuming the root of your data tree is $SILK_DATA_ROOTDIR, you can
process all of your data files with the command:

  find $SILK_DATA_ROOTDIR -type f -print | xargs rwpatchwww.pl

The previous versions of packed files are saved as <name>.bak.  You
may want to compare the output of running rwcut on the old and new
versions of a selected set of files to make certain the upgrade went
smoothly.  For example, comparing a web file with its backup, swapping
the order in which the source and destination ports are printed should
produce the same result:

  rwcut --fields=1,2,3,4,5-12 --no-title \
      inweb/2004/03/01/iw-S0_20040301.00 | md5sum

  rwcut --fields=1,2,4,3,5-12 --no-title \
      inweb/2004/03/01/iw-S0_20040301.00.bak | md5sum

For non-web data, the files should be identical with the exception of
the longer header (assuming your version of cmp takes offset
arguments):

  cmp in/2004/03/01/in-S0_20040301.00 \
      in/2004/03/01/in-S0_20040301.00.bak 22 12

Once you are comfortable that the files have been modified correctly,
remove the backup files, and then start the new version of the packer.


Changes: