Skip to main content

​
Overview

The DNS service backend driver determines which DNS server software is used to serve zone data. The backend is configured through XDeploy and the xavs-ansible deployment tool. This page covers viewing and managing current pool configuration and assigning zones to specific pools.
Administrator Access Required — This operation requires the admin role. Contact your Xloud administrator if you do not have sufficient permissions.
Prerequisites
  • Administrator credentials sourced via admin-openrc.sh
  • Access to XDeploy for DNS service configuration changes

​
View Current Configuration

List DNS pools
openstack zone pool list
Show pool detail
openstack zone pool show <pool-id>
Pool detail fields:
FieldDescription
namePool identifier used when assigning zones
descriptionAdministrative description
nameserversList of authoritative nameserver hostnames for this pool
targetsBackend server endpoints the worker pushes zone data to
also_notifiesAdditional servers notified of zone changes (for AXFR)
attributesKey-value tags used to match zones to pools via scheduling policies

​
Assign a Zone to a Pool

By default, new zones are assigned to the default pool based on scheduling policies. You can override pool assignment:
Show zone's current pool assignment
openstack zone show <zone-name> -c masters -c attributes
Assign a zone to a specific pool
openstack zone set <zone-name> --attributes pool_id:<pool-id>
Reassigning a zone to a different pool triggers a full zone synchronization to the new pool’s nameservers. During synchronization, queries may return stale data from the old pool if resolver caches have not expired.

​
Pool Configuration Reference

Pool configuration is managed through XDeploy service configuration files and applied via xavs-ansible deploy. The following fields control backend behavior:
ParameterDescriptionExample
backendDNS server backend typebind9, pdns4
targetsBackend RNDC/API endpoints for zone push<host>:<port>
nameserversPublic-facing nameserver FQDNsns1.example.com.
also_notifiesHosts to NOTIFY after zone changesSecondary server IPs
attributesScheduling attributesservice_tier: premium

​
Next Steps

Pool Management

Add nameservers, configure attributes, and manage pool health

Zone Transfers

Configure AXFR/IXFR zone transfer policies

Architecture

Understand the DNS service topology and component roles

Admin Troubleshooting

Diagnose backend connectivity and synchronization failures