Skip to content
Ziggy: the RPKI Wayback Machine
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
rv2ris.py
sample-ziggy.conf
simple_config.py
ziggy.py

README.md

Ziggy: the RPKI Wayback Machine

Copyright (c) 2019 NLnet Labs (https://nlnetlabs.nl/)

All rights reserved. Distributed under a 3-clause BSD-style license. For more information, see LICENSE

Dependencies

Ziggy requires Python 3 to run, and has been tested with Python 3.6 on Ubuntu 18.04LTS.

Note that the script also requires the Python dateutil package to be installed. This is available for most distributions as a native package, for example, on an Ubuntu system the following command installs this package:

$ apt install python3-dateutil

Running Ziggy

Configuration file

Ziggy uses a very simple configuration file in JSON format. Currently, the following keys should be defined in the config:

  • routinator -- the full path to the routinator executable to run
  • routinator-cache -- path to the Routinator repository cache (note: for Routinator version older than 0.6 you should change the value in the sample configuration to ~/.rpki-cache/repository)
  • routinator-tals -- path to the Routinator TAL cache
  • vrp-out-format -- output format to ask Routinator for
  • vrp-out-name -- output filename for VRP data, {} is replaced by the date in ISO notation (e.g. 2018-01-01)
  • routinator-log-name -- filename for the log, {} is replaced by the date in ISO notation
  • ignore-tals -- a list of repositories for which Ziggy should not generate a TAL, even if a TA certificate is available

A sample file called sample-ziggy.conf is included in the repository.

Running

Running Ziggy is as simple as invoking:

$ ./ziggy.py -c <config-file> -d <date-in-ISO>

Where <date-in-ISO> is the date for which to extract data in ISO notation (e.g. 2018-01-01 for January 1st, 2018).

Ziggy will end by running the Routinator. It shows you the command line it uses to invoke Routinator so you can easily re-run Routinator if you wish to.

You can’t perform that action at this time.