https://github.com/nlnetlabs/ziggy
Ziggy: the RPKI Wayback Machine
https://github.com/nlnetlabs/ziggy
rpki
Last synced: 6 months ago
JSON representation
Ziggy: the RPKI Wayback Machine
- Host: GitHub
- URL: https://github.com/nlnetlabs/ziggy
- Owner: NLnetLabs
- License: other
- Created: 2019-05-17T15:52:21.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-09-13T11:56:53.000Z (about 6 years ago)
- Last Synced: 2025-03-28T04:02:20.609Z (6 months ago)
- Topics: rpki
- Language: Python
- Size: 14.6 KB
- Stars: 6
- Watchers: 18
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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 -d
```
Where `` 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.