Introduction

This repository is a demo for using Netdisco in a Cumulus VX Network.

The steps below will spin up a reference network of: two spine routers, four leaf routers (in MLAG pairs), four servers dual-connected to upstream leaf switches, together with an out-of-band (OOB) management switch and server (not shown):

On the OOB server will be running an instance of Netdisco Backend in a Docker container. This is configured to connect to PostgreSQL running on your host computer system.

Preparation

Before running this demo, install VirtualBox and Vagrant.

You will need to edit the Vagrantfile, to change the NETDISCO_DB_NAME and NETDISCO_DB_USER for your system. You can add NETDISCO_DB_PASS if required.

Startup

git clone --recurse-submodules https://github.com/netdisco/cumulus-netdisco-demo.git

cd cumulus-netdisco-demo && vi Vagrantfile
# edit the DB configuration as mentioned above

vagrant up

# now wait for 10 minutes (after "vagrant up" finishes),
# starting the network is sloooooooow

vagrant up --provision oob-mgmt-server

Access Netdisco Backend

Should you wish to visit the oob-mgmt-server host running the backend:

vagrant ssh

The Netdisco configuration is in ./environments as usual.

Caveats

You will need to run the web frontend on your workstation. Obviously, this does not share configuration with the backend docker container running on oob-mgmt-server. You will also need a provisioned (deployed) and up-to-date Netdisco database schema.