Skip to content

README.md

Latest commit

 

History

History
69 lines (44 loc) · 2.27 KB

README.md

File metadata and controls

69 lines (44 loc) · 2.27 KB

JPAN Command Line Tool

JPAN-CLI is a tool that allows echo, traceroute, showpaths, ... and other functionality, similar to the SCION CLI tool. JPAN-CLI is stand-alone based on JPAN and does not require any locally installed SCION software.

The executable jar can be found in the GitHub Releases section.

JPAN-CLI provides several tools:

  • jpan-cli address - Show (one of) this host’s SCION address(es)

  • jpan-cli ping - Test connectivity to a remote SCION host using SCMP echo packets

  • jpan-cli ping-responder - Run a local server that responds to incoming SCION pings

  • jpan-cli showpaths - Display paths to a SCION AS

  • jpan-cli traceroute - Trace the SCION route to a remote SCION AS using SCMP traceroute packets

  • jpan-cli version - Show the SCION version information

Usage

All tools can be run from the executable jar file which is available in the GitHub Releases section. It can be executed with:

java -jar jpan-cli.jar [tool-command]

For example, to get command line help, the tool can be executed with:

java -jar jpan-cli.jar help

Known Issues

  • jpan-cli should detect automatically if the AS dispatcher range is limited and then either start on 30041 or start a SHIM. See issue #8.

Troubleshooting

No ping/traceroute answers received

In some ASes, border routers will send return packets to port 30041. To receive these packets, please start the tool with --port 30041.

No DNS search domain found. Please check your /etc/resolv.conf or similar.

This happens, for example, on Windows when using a VPN. One solution is to execute the jar with the following property ( the example works only for ethz.ch):

java -Dorg.scion.dnsSearchDomains=ethz.ch. -jar jpan-cli.jar

Acknowledgements

Functionality and documentation borrow heavily from the original scion tool (docs).