sync_arc ::
   Arclink Merging Tool



About

sync_arc is a tool that will merge inventory from different Arclink sources into your seiscomp3 database by following a list of nodes (master table) provided by the webdc.eu portal.

This tool is today used inside the EIDA network to keep its nodes synchronized (the inventory and routing parts). But could also be used by other group of ArcLink networks to achieve the same result as EIDA today.

Before you install it

Attention !!!! This package is incompatible with the autosync/sync_db program currently shipped with seiscomp3 package. You should make sure to disable the execution of this program in your system before installing this package.

Normally this program is invoked from your crontab every day to keep your inventory synchronized. Make sure that you don't have any entry on your crontab file related to this program. To check your crontab you can type in:

% crontab -e

Also, to disable the synchronization in general inside seiscomp one can run 'seiscomp config' and change the value 'Master ArcLink node for DB synchronization' during the seiscomp config -> G -> arclink in your system.

During the config step you should answer '_' (underscore) to the question above as shown below:

Following packages are selectable: trunk acquisition arclink diskmon 
Select package: arclink
Enable local ArcLink [yes]: 
Master ArcLink node for DB synchronization: _
Time of DB synchronization [07:43]: 
Maximum size of data product (MB) [500]: 
ArcLink admin password [-]: 
Enable arclink encryption (true/false) [false]: 

Downloading

You can download the sync_arc package from the following link. The package is distributed in a gzipped tar file. This file contains a install script (install.sh), the program itself (sync_arc.py) with its sample configuration file, and two versions of the documentation.

Versions available:

  • Version 0.10a (bug on sanity) 28-09-2012 [tgz]
  • Version 0.9a (added a poolTidy method) 24-07-2012 [tgz]
  • Version 0.8a (compatibility with old python) 05-07-2012 [tgz]
  • Version 0.7a (improved sanity check and clean) 02-07-2012 [tgz]
  • Version 0.6a (improved merging reporting) 28-06-2012 [tgz]
  • Version 0.5a (initial release) 26-06-2012 [tgz]

Release notes:

Here we will keep on adding important release notes. For a full set of releases notes please check the documentation provided on each release.

  • 0.12a

    In this version we added support for virtual networks (station groups inside the inventory). Handling virtual network is not a simple task since a virtual network can be composed of station from different nodes. In this implementation we added support for cleaning station groups (--erase) and on the remove (--remove). To support the virtual network was introduced a backyard compatible change in the master table. For syncing virtual networks you should use the option --with-sg during the merge.

  • 0.8a

    The options --sanity and --keep were renamed to --sanity-check and to --keep-synced becase of a bug on the libboost-program-options on early versions. Current libboost version are correct but for keeping compatibility with those earlier version we modified the program option names keeping its functions.

Installing

This package is a add-on package to the seiscomp3 software. To install it you should have a seiscomp3 system pre-installed and configured in your home directory.

To install this package you need to untar it, and run the install.sh script supplied. The package should find your seiscomp3 installation folder and update it.

% tar xvzf syncArc-0.5a.tgz
% cd syncArc-0.5a
% ./install.sh

Before installing it and using it please read the manual supplied.

Documentation

The documentation are supplied in PDF format in two different flavors. One contained only the documentation itself, and a second version with commented notes on it. The version with notes is binded together in a way that you can just print it in a double side printer to get a final document with the main topics on the front pages while the comments are on the back. The binding of the pages on double side printing mode should be on the short-edge of the paper.

Here you can see a preview of the documentation (click to advance)



This tool and this releasing web page were created by the GEOFON group.
© 2012 Helmholtz Centre Potsdam GFZ German Research Centre for Geosciences