Taikun Logo

Taikun OCP Guide

Table of Contents

DNS Server Pools


In designate we support the concept of multiple “pools” of DNS

This allows operators to scale out their DNS Service by adding more
pools, avoiding the scaling problems that some DNS servers have for
number of zones, and the total number of records hosted by a single

This also allows providers to have tiers of service (i.e. the
difference between GOLD vs SILVER tiers may be the number of DNS
Servers, and how they are distributed around the world.)

In a private cloud situation, it allows operators to separate
internal and external facing zones.

To help users create zones on the correct pool we have a “scheduler”
that is responsible for examining the zone being created and the pools
that are available for use, and matching the zone to a pool.

The filters are pluggable (i.e. operator replaceable) and all follow
a simple interface.

The zones are matched using “zone attributes” and “pool attributes”.
These are key: value pairs that are attached to the zone when it is
being created, and the pool. The pool attributes can be updated by the
operator in the future, but it will not trigger zones
to be moved from one pool to another.


Currently the only zone attribute that is accepted is the pool_id attribute. As more filters are merged
there will be support for dynamic filters.

Target vs. Nameserver

One thing that can be confusing about pools is the differentiation
between a target and a nameserver. The target is where Designate will
try to write the change, while a namserver is where Designate checks
that the change exists.

A great example of this is bind’s stealth
master system
. In this configuration, there could be a stealth
master that you configure as your target and a set of slaves pointed to
that master as your nameservers. Designate will write to the master and
then look for the changes on the slaves before considering the change

Another example would be where Designate uses an API backend such as
DynDNS or even another Designate instance. In this situation, you will
typically have a single target with a set of nameservers to test that
meet your requirements.

Yet another example is when using a Designate agent. In this scenario
your agent instances are the targets and the nameservers the agent
updates would be checked for the correct information.

Managing Pools

In mitaka we moved the method of updating pools to a CLI in designate-manage

There is a YAML file that defines the pool, and is used to load this
information into the database.


Designate Manage Pools
Command Reference

Update Pools Information

designate-manage pool update [options]


–file Input file (Default: /etc/designate/pools.yaml)
–dry-run This will simulate what will happen when you run this command
–delete Any Pools not listed in the config file will be deleted


Running with --delete can be
extremely dangerous.
It will delete any pools that are not in the supplied YAML file, and
zones that are in that Pool.
Before running with --delete we recommend operators run
--delete --dry-run to view the outcome.

Generate YAML File

designate-manage pool generate_file [options]


–file YAML file output too (Default:

Generate YAML File from
Liberty Config

designate-manage pool export_from_config [options]


–file YAML file output too (Default: