DNS Backend Configuration

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 openrc.sh
Access to XDeploy for DNS service configuration changes

View Current Configuration

List DNS pools
Verify pool health

List DNS pools

openstack zone pool list

Show pool detail

openstack zone pool show <pool-id>

Pool detail fields:

Field	Description
`name`	Pool identifier used when assigning zones
`description`	Administrative description
`nameservers`	List of authoritative nameserver hostnames for this pool
`targets`	Backend server endpoints the worker pushes zone data to
`also_notifies`	Additional servers notified of zone changes (for AXFR)
`attributes`	Key-value tags used to match zones to pools via scheduling policies

Verify that the pool’s nameservers are authoritatively answering queries:

Check zone on each nameserver

dig @<nameserver-ip> example.com. SOA +norecurse

A healthy pool nameserver returns the SOA record with AUTHORITY: 1. If the nameserver returns SERVFAIL, the zone has not synchronized to that nameserver.

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:

Parameter	Description	Example
`backend`	DNS server backend type	`bind9`, `pdns4`
`targets`	Backend RNDC/API endpoints for zone push	`<host>:<port>`
`nameservers`	Public-facing nameserver FQDNs	`ns1.example.com.`
`also_notifies`	Hosts to NOTIFY after zone changes	Secondary server IPs
`attributes`	Scheduling attributes	`service_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

Core Services

Other Services

DNS Backend Configuration

Overview

View Current Configuration

Assign a Zone to a Pool

Pool Configuration Reference

Next Steps

Pool Management

Zone Transfers

Architecture

Admin Troubleshooting

Core Services

Other Services

Documentation Index

​Overview

​View Current Configuration

​Assign a Zone to a Pool

​Pool Configuration Reference

​Next Steps

Pool Management

Zone Transfers

Architecture

Admin Troubleshooting

Overview

View Current Configuration

Assign a Zone to a Pool

Pool Configuration Reference

Next Steps