This repository contains binaries and code to setup a SCION endhost inside the OVGU Education AS. It should serve as dummy to create a more sophisticated tooling later.
So far Linux (amd64), Windows (amd64) MacOS (arm64/amd64) are supported. While some parts of this documentation are OVGU specific, you can transfer these settings to your AS.
Note: At the moment, for MacOS and Windows, it is recommended to build the binaries on your local machine, otherwise MacOS won't start them and Windows may block them via BitDefender. We are working on signed packages and installers, but please build the binaries locally on these platforms. You need to have make, go, and git installed.
At first you need to build the scion-host binaries. We provide a Makefile to build everything, so ensure you have make installed on your machine. So far building relies on .sh scripts, so on Windows you might need to use WSL for building.
Initialize your build environment via make dev, this will clone the required dependencies into the dev folder.
Then run make build to build the scion-host binaries for all supported platforms. You can find the binaries in the build/ folder.
You need to have access to a Bootstrapper-Server URL inside your SCION AS. Let's refer to this URL as $bootstrapUrl, which is the combination of IP:Port for your local bootstrapper server. Inside of the Ovgu AS this would be 141.44.25.151:8041. You need this URl to continue with the next steps.
To run the endhost stack on Windows, just download the scion-host.exe from this repository (from the releases) or build it locally.
You need to open a Commandline Terminal as Administrator to run the endhost stack, e.g. by typing cmd into Windows search, right click on Command Line and use Open as Administrator. Now move to the folder where you downloaded the scion-host.exe e.g. via cd C:\Users\User\Downloads\. If you are in the correct folder, type scion-host.exe /bootstrap=$bootstrapUrl in the terminal and press Enter.
You should see some logging output and the program should stay open.
SCION is installed in your Program Files directory, e.g. under C:\Program Files\scion\windowsx64. In this folder you can also find the scion.exe binary. To use this, either open a Commandline Terminal in this directory, or add this directory to your Path, following this documentation.
You can test SCION connectivity by using the scion.exe binary, e.g. scion.exe showpaths -r 71-2546 or scion.exe ping 71-2546,127.0.0.1.
Ovgu Specific: You need to be in the OvGU university network to connect to the SCION network properly in our AS. This can be done either by connecting to OvGU WIFI or LAN being on the campus, or using the OvGU VPN. In the end, you need an OvGU IP Address in the range of 141.44.xx.xx.
You can test SCION connectivity by using scion.exe. You may need to set your local address properly: Run arp -a in your terminal and find your OvGU IP address (should start with 141.44.).
Now you can show paths to a given destination (e.g. Demokritos): scion.exe showpaths -r 71-2546 --local <your_ovgu_ip> or ping a SCION host scion.exe ping 71-2546,127.0.0.1 --local <your_ovgu_ip>.
There will be a Windows Installer for SCION available soon, which makes it easier to run it on windows. Also the output of the SCION binary will be improved.
Warning: Sometimes the Bitdefender will mark the scion-host.exe binary as virus, which it isn't. So you need to "ignore" this binary in Bitdefender to allow it to run on your system.
Note: You need to stop any scionlab installations before running the scion-host binary, since they use similar ports.
To run the endhost stack on Linux, just download the scion-host binary from this repository. Run it as root via sudo ./scion-host --bootstrap=$bootstrapUrl and keep this binary running. You should see some logging output and the program should stay open. SCION is installed under /etc/scion-host/linuxx64/, in this folder, you can also find the scion binary. You can use the binary from this folder or add it to your Path. Warning: Be sure to run the newly installed scion binary when configuring this to your PATH, since an older one won't work with the new dispatcher.
You can test SCION connectivity by using the scion binary, e.g. scion showpaths -r 71-2546 or scion ping 71-2546,127.0.0.1.
Ovgu Specific: You need to be in the OvGU university network to connect to the SCION network properly in our AS. This can be done either by connecting to OvGU WIFI or LAN being on the campus, or using the OvGU VPN. In the end, you need an OvGU IP Address in the range of 141.44.xx.xx.
You can test SCION connectivity by using the scion binary. You may need to set your local address properly: Run ip a in your terminal and find your OvGU IP address (should start with 141.44.).
Now you can show paths to a given destination (e.g. Demokritos): scion showpaths -r 71-2546 --local <your_ovgu_ip> or ping a SCION host scion ping 71-2546,127.0.0.1 --local <your_ovgu_ip>.
To run the endhost stack on MacOS, just download the scion-host-darwin-arm64 binary for arm-based platforms or scion-host-darwin-amd64 for x64-based platforms. We recommend to rename it to scion-host. If you can't start this binary on your system for security reasons, please build it locally until we provide official packages.
Run it as root via sudo ./scion-host --bootstrap=$bootstrapUrl and keep this binary running. You should see some logging output and the program should stay open. SCION is installed under /Applications/scion-host/darwinx64/ or /Applications/scion-host/darwinamd64/, in this folder, you can also find the scion binary. You can use the binary from this folder or add it to your Path.
You can test SCION connectivity by using the scion binary, e.g. scion showpaths -r 71-2546 or scion ping 71-2546,127.0.0.1.
Ovgu Specific: You need to be in the OvGU university network to connect to the SCION network properly in our AS. This can be done either by connecting to OvGU WIFI or LAN being on the campus, or using the OvGU VPN. In the end, you need an OvGU IP Address in the range of 141.44.xx.xx.
You can test SCION connectivity by using the scion binary. You may need to set your local address properly: Open Settings->Network and find your OvGU IP address (should start with 141.44.).
Now you can show paths to a given destination (e.g. Demokritos): scion showpaths -r 71-2546 --local <your_ovgu_ip> or ping a SCION host scion ping 71-2546,127.0.0.1 --local <your_ovgu_ip>.