YGGDRA logo YGGDRA

Demo 1.2

Install YGGDRA Demo

The demo is provided as a Docker archive. It lets you test YGGDRA locally, with no service guarantee, using read-only SNMP access to your switches.

Demo presentation video

Watch the full walkthrough before downloading: installation, launch and first uses of YGGDRA Demo.

Contents

Before you start

  • Plan for at least 40 GB of free disk space.
  • Enable read-only SNMP on the switches you want to test.
  • Make sure the demo machine can reach the management network.
  • Keep the downloaded file locally: it contains the complete demo image.

Windows

Use Docker Desktop with the WSL2 backend.

  1. Install Docker Desktop and enable WSL2.
  2. Open PowerShell in the downloaded file folder.
  3. Check SHA-256 if you want to verify the file.
  4. Load the image, then start the demo with local ports.

Copy-paste commands

Get-FileHash .\yggdra-demo-v1.2.tar.gz -Algorithm SHA256
docker load -i .\yggdra-demo-v1.2.tar.gz
docker run --name yggdra-demo --privileged -p 8080:80 -p 8443:443 --restart unless-stopped -d yggdra-demo:v1.2
docker ps --filter name=yggdra-demo

Example STDOUT

Algorithm       Hash                                                                   Path
---------       ----                                                                   ----
SHA256          13CF673740989CC51000C02C56DE16F951BDCF49F300DC62849A9D9D5B8610F2       yggdra-demo-v1.2.tar.gz
Loaded image: yggdra-demo:v1.2
5d8f4d4a6f2f9a0b7c1e4f5a8c9d2e3f4a5b6c7d8e9f0123456789abcdef0123
CONTAINER ID   IMAGE              STATUS          PORTS                                      NAMES
5d8f4d4a6f2f   yggdra-demo:v1.2   Up 12 seconds   0.0.0.0:8080->80/tcp, 0.0.0.0:8443->443/tcp   yggdra-demo

Then open: https://localhost:8443 or http://localhost:8080

Mac

Docker Desktop is enough on Apple Silicon and Intel.

  1. Install Docker Desktop for macOS.
  2. Put the archive in a working folder.
  3. Verify the file with shasum.
  4. Load the image, then start the demo with local ports.

Copy-paste commands

cd ~/Downloads
shasum -a 256 yggdra-demo-v1.2.tar.gz
docker load -i yggdra-demo-v1.2.tar.gz
docker run --name yggdra-demo --privileged -p 8080:80 -p 8443:443 --restart unless-stopped -d yggdra-demo:v1.2
docker ps --filter name=yggdra-demo

Example STDOUT

13cf673740989cc51000c02c56de16f951bdcf49f300dc62849a9d9d5b8610f2  yggdra-demo-v1.2.tar.gz
Loaded image: yggdra-demo:v1.2
5d8f4d4a6f2f9a0b7c1e4f5a8c9d2e3f4a5b6c7d8e9f0123456789abcdef0123
CONTAINER ID   IMAGE              STATUS          PORTS                                      NAMES
5d8f4d4a6f2f   yggdra-demo:v1.2   Up 12 seconds   0.0.0.0:8080->80/tcp, 0.0.0.0:8443->443/tcp   yggdra-demo

Then open: https://localhost:8443 or http://localhost:8080

Linux

Docker Engine or Docker Desktop both work.

  1. Install Docker Engine.
  2. Put the archive in a working folder.
  3. Verify SHA-256.
  4. Run the demo with host networking to make SNMP access easier.

Copy-paste commands

cd ~/Downloads
sha256sum yggdra-demo-v1.2.tar.gz
docker load -i yggdra-demo-v1.2.tar.gz
docker run --name yggdra-demo --privileged --network host --restart unless-stopped -d yggdra-demo:v1.2
docker ps --filter name=yggdra-demo

Example STDOUT

13cf673740989cc51000c02c56de16f951bdcf49f300dc62849a9d9d5b8610f2  yggdra-demo-v1.2.tar.gz
Loaded image: yggdra-demo:v1.2
5d8f4d4a6f2f9a0b7c1e4f5a8c9d2e3f4a5b6c7d8e9f0123456789abcdef0123
CONTAINER ID   IMAGE              STATUS          PORTS     NAMES
5d8f4d4a6f2f   yggdra-demo:v1.2   Up 12 seconds             yggdra-demo

Then open: https://machine-ip-address/ or http://machine-ip-address/

Synology

Use Container Manager on recent DSM versions.

  1. Copy the archive to the NAS, for example in /volume1/docker/yggdra.
  2. Import the image with Container Manager or over SSH.
  3. Run the container in host mode if the NAS must poll your switches over SNMP.
  4. Check that the DSM firewall allows access from your workstation.

Copy-paste commands

ssh admin@nas-ip-address
cd /volume1/docker/yggdra
sudo docker load -i yggdra-demo-v1.2.tar.gz
sudo docker run --name yggdra-demo --privileged --network host --restart unless-stopped -d yggdra-demo:v1.2
sudo docker ps --filter name=yggdra-demo

Example STDOUT

Loaded image: yggdra-demo:v1.2
5d8f4d4a6f2f9a0b7c1e4f5a8c9d2e3f4a5b6c7d8e9f0123456789abcdef0123
CONTAINER ID   IMAGE              STATUS          PORTS     NAMES
5d8f4d4a6f2f   yggdra-demo:v1.2   Up 12 seconds             yggdra-demo

Then open: https://nas-ip-address/ or http://nas-ip-address/