Skip to main content

Overview

Polystack Networking administration covers the full lifecycle of the SDN fabric — from deploying and monitoring the agents that drive the virtual switching layer to defining provider networks, enforcing QoS policies, and hardening the network plane against misconfiguration and spoofing attacks. Use this guide to maintain the networking infrastructure across your cluster.
Administrator Access Required — This operation requires the admin role. Contact your Polystack administrator if you do not have sufficient permissions.
Network configuration is managed through the deployment console Configuration panel:

Open Configuration

Navigate to the deployment console → Configuration and select the Network tab.

Configure network settings

Set the following options as needed:

Save and deploy

Click Save Configuration, then navigate to the deployment console → Operations and run a Deploy or Reconfigure for the Networking service.
Network configuration is applied across all nodes.
Prerequisites
  • Admin credentials sourced from openrc.sh
  • openstack CLI installed and configured
  • the deployment console access for cluster-level configuration changes
  • All networking agents running and healthy on all nodes

Administration Topics

Service Architecture

Distributed SDN agent model — API server, message bus, L2/L3 agents, DHCP, and metadata

Provider Networks

Configure VLAN, flat, and VXLAN provider networks and physical interface mappings

Network Agent Management

Monitor agent health, enable or disable agents for maintenance, and recover failed agents

DHCP Configuration

Manage DHCP agents, network assignments, and high-availability DHCP

L3 Router Configuration

Enable HA routers with VRRP failover and distributed virtual routing for scale

Quality of Service

Apply bandwidth limits and burst controls to ports and networks

Network Quotas

Set per-project limits for networks, subnets, routers, floating IPs, and security groups

Security Hardening

Port security, anti-spoofing enforcement, allowed address pairs, and default group hardening

Troubleshooting

Diagnose agent failures, VXLAN tunnel issues, HA router failover, and MTU problems

Architecture Overview

Agent Health Quick Check

Check all networking agent status
All agents should show Alive: True and Admin State: UP. If any agent shows Alive: False, see Network Agent Management for recovery procedures.

Related Resources

Networking User Guide

User-facing workflows for creating networks, routers, floating IPs, and security groups

Compute Admin Guide

Manage compute hosts, flavors, and quotas alongside networking configuration

Authentication

Configure admin credentials and project-scoped access for networking operations

CLI Setup

Install and configure the openstack CLI for full administrative control