IP Pool

Location in GUI: Design » Network Settings » IP Address Pools

Diagram

Classes

network_settings (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
ip_pools	List	`[ip_pools]`	No

ip_pools (catalyst_center.network_settings)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
ip_address_space	Choice	`IPv4`, `IPv6`	Yes	`IPv4`
type	Choice	`generic`, `tunnel`	No	`Generic`
dhcp_servers	List	IP	No
dns_servers	List	IP	No
gateway	String		No
ip_pool_cidr	IP		No
ip_pools_reservations	List	`[ip_pools_reservations]`	No

ip_pools_reservations (catalyst_center.network_settings.ip_pools)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
prefix_length	Integer	min: `1`, max: `32`	No
subnet	IP		No
gateway	IP		No
type	Choice	`generic`, `LAN`, `WAN`, `management`, `service`	No	`Generic`
dhcp_servers	List	IP	No
dns_servers	List	IP	No

Examples

Example 1: Basic IPv4 IP pool configuration with generic type, DHCP and DNS server assignments for centralized network services:

catalyst_center:
  network_settings:
    ip_pools:
      - name: BASIC_IPv4_POOL
        ip_address_space: IPv4
        type: generic
        dhcp_servers:
          - 192.168.1.10
          - 192.168.1.11
        dns_servers:
          - 8.8.8.8
          - 8.8.4.4
        gateway: 192.168.1.1
        ip_pool_cidr: 192.168.0.0/16

Example 2: Enterprise IPv4 deployment with multiple pool types and reservations for different network functions and services including LAN Automation, Access Point and Extended Nodes:

catalyst_center:
  network_settings:
    ip_pools:
      - name: ENTERPRISE_CAMPUS_POOL
        ip_address_space: IPv4
        type: generic
        dhcp_servers:
          - 10.100.1.10
          - 10.100.1.11
        dns_servers:
          - 10.100.1.5
          - 10.100.1.6
        ip_pool_cidr: 10.100.0.0/16
        ip_pools_reservations:
          - name: CAMPUS_LAN_AUTO
            prefix_length: 24
            subnet: 10.100.10.0
            type: LAN
          - name: CAMPUS_AP_POOL
            prefix_length: 26
            subnet: 10.100.20.0
            type: management
          - name: CAMPUS_EXTENDED_NODE_POOL
            prefix_length: 26
            subnet: 10.100.20.0
            type: management

Example 3: Comprehensive IPv4 deployment with multiple pool types including generic, LAN, WAN, management, service, and LAN Automation pools, featuring complete reservation structures for global enterprise network infrastructure:

catalyst_center:
  network_settings:
    ip_pools:
      - name: GLOBAL_IPv4_MAIN_POOL
        ip_address_space: IPv4
        type: generic
        dhcp_servers:
          - 172.16.1.10
          - 172.16.1.11
        dns_servers:
          - 172.16.1.5
          - 172.16.1.6
        ip_pool_cidr: 172.16.0.0/16
        ip_pools_reservations:
          - name: CORPORATE_POOL
            prefix_length: 24
            subnet: 172.16.10.0
            gateway: 172.16.10.1
            type: generic
            dhcp_servers:
              - 172.16.1.10
              - 172.16.1.11
            dns_servers:
              - 172.16.1.5
              - 172.16.1.6
          - name: BRANCH_WAN_POOL
            prefix_length: 24
            subnet: 172.16.20.0
            gateway: 172.16.20.1
            type: WAN
            dhcp_servers:
              - 172.16.1.255
            dns_servers:
              - 172.16.1.256
          - name: MGMT_NETWORK_POOL
            prefix_length: 26
            subnet: 172.16.30.0
            gateway: 172.16.30.1
            type: management
            dhcp_servers:
              - 172.16.1.200
            dns_servers:
              - 172.16.1.201
          - name: SERVICE_NETWORK_POOL
            prefix_length: 25
            subnet: 172.16.40.0
            gateway: 172.16.40.1
            type: service
            dhcp_servers:
              - 172.16.1.10
              - 172.16.1.11
            dns_servers:
              - 172.16.1.5
              - 172.16.1.6
          - name: LAN_AUTOMATION_POOL
            prefix_length: 24
            subnet: 172.16.250.0
            type: LAN

Example 4: Site assignment configuration demonstrating how to apply IP pool reservations to different site types and geographic locations for campus automation, access points, and various network services:

catalyst_center:
  sites:
    areas:
      - name: Main Campus
        parent_name: Global/Americas
        ip_pools_reservations:
          - CORPORATE_POOL
          - MGMT_NETWORK_POOL
          - CAMPUS_EXTENDED_NODE_POOL
          - CAMPUS_AP_POOL
          - CAMPUS_LAN_AUTO
      - name: Branch Offices
        parent_name: Global/Americas
        ip_pools_reservations:
          - BRANCH_WAN_POOL
          - SERVICE_NETWORK_POOL