OVN Web Manager

This has been developed on Ubuntu 22.04 minimal server. For best results run it on that. Do not run this in production, it is not even close. Help is apreciated & welcomed.

A modern web application for managing Open Virtual Network (OVN) through a beautiful and intuitive interface, designed to run on Ubuntu Server.

Features

• Logical Switch Management
• Logical Router Management
• ACL Management
• Load Balancer Configuration
• Security Groups
• Port Management
• DHCP Configuration
• NAT Configuration
• Real-time Network Visualization
• Multi-tenant Support

System Requirements

• Ubuntu Server 22.04 LTS (minimal installation)
• Internet connection for package installation
• Minimum 2GB RAM
• 20GB disk space

Quick Start

1. Clone the repository:

   git clone https://github.com/bufanoc/ovn-web-manager.git
   cd ovn-web-manager

2. Make the installation script executable:

   chmod +x start.sh

3. Run the installation script:

   ./start.sh

The script will automatically:

• Install all required system packages
• Set up OVN and its dependencies
• Configure the Python backend environment
• Build and serve the React frontend
• Start all necessary services

Once completed, the application will be accessible at:

• Frontend: http://<server-ip>:3000
• Backend API: http://<server-ip>:5000

Components Installed

• System Packages: git, curl, python3, nodejs, jq, and other dependencies
• OVN: Latest version from Ubuntu repositories
• Frontend: React-based web interface
• Backend: Flask API server
• Database: OVN native databases

Architecture

• Frontend: React with Material-UI
• Backend: Python Flask REST API
• Network: OVN (Open Virtual Network)
• Database: OVN native databases (northbound and southbound)

Attribution & Credits

OVN Web Manager was created and is maintained by Carmine Bufano.

• Website: carminebufano.com
• GitHub: @bufanoc
• Repository: bufanoc/ovn-web-manager

If you use, modify, or distribute this software, please ensure proper attribution to the original creator is maintained in accordance with the BSD-3-Clause License.

Why Attribution Matters

This project represents significant effort and expertise in OVN management tooling. Attribution ensures that the original creator receives appropriate recognition while allowing the open source community to benefit from and build upon this work.

Security Notes

• The application runs services on ports 3000 (frontend) and 5000 (backend)
• Make sure to configure your firewall to allow access to these ports
• Consider setting up HTTPS for production use
• Default configuration listens on all network interfaces

Troubleshooting

If you encounter issues:

1. Check service status:

   systemctl status openvswitch-switch
   systemctl status ovn-northd
   systemctl status ovn-controller

2. View application logs:

   tail -f frontend.log
   tail -f backend.log

3. Check OVN database connectivity:

   sudo ovn-nbctl show
   sudo ovn-sbctl show

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

BSD 3-Clause License - See LICENSE file for details.