Taurine-Technology / sdn-launch-control

Install, manage and do everything Open vSwitch and SDN related.

SDN Launch Control AKA Launch Control

Install, manage and do everything Open vSwitch and SDN.

Launch Control is a central management tool for software defined networking (SDN) built to enable easy and automated adoption/installation of the SDN paradigm into new or pre-existing networks.

Video demo of the pre-production alpha release.

Documentation

Feature Set

Find details about the feature set here.

Errors

Find details about errors and debugging here.

Controllers

Find documentation on the controllers here.

Running this code

Dependencies

1. To run the backend you need to install Ansible, ansible galaxy collections in requirements.yml, openssh, sshpass, Python requirements in requirements.txt locally using the convenience script in the backend folder. To install it them: run the script in this folder: ./install.sh
2. To run the frontend you need the NPM packages installed. Navigate to ui/control-center and run the convenience script: ./install.sh

Running from Source

1. Install the dependencies.
2. Activate the virtual environment: source venv/bin/activate
3. Navigate to the backend folder and run the Redis docker container: docker compose up -d
4. Start the Django server, make the necessary migrations and create an admin user:

python manage.py runserver 0.0.0.0:8000
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser

5. Navigate the frontend folder to install the UI packages and start the frontend:

npm install
npm start

6. Navigate to the UI here and the backend here.

Run from Convenience Script

1. To start the backend navigate to the backend/control_center and run the run.sh script ./run.sh. You will still need to create a user:

python manage.py createsuperuser

2. To start the UI navigate to ui/control-center and run the run.sh script ./run.sh

Contribute

Find out what we are doing and what needs to be done here. Email [e-mail] to contribute or open a draft pull request.