Install Designate¶

This section describes how to install Designate on a new or existing MCP cluster.

Before you proceed to installing Designate:

1. Configure and deploy a DNS back end for Designate as described in Deploy a DNS back end for Designate.
2. Prepare your cluster model for the Designate deployment as described in Prepare a deployment model for the Designate deployment.

To install Designate on a new MCP cluster:

1. Log in to the Salt Master node.

2. Apply the following states:

   salt -C 'I@designate:server and *01*' state.sls designate.server
   salt -C 'I@designate:server' state.sls designate
   

To install Designate on an already deployed MCP cluster:

1. Log in to the Salt Master node.

2. Refresh Salt pillars:

   salt '*' saltutil.refresh_pillar
   

3. Create databases for Designate by applying the mysql state:

   salt -C 'I@galera:master' state.sls galera
   

4. Create the HAProxy configuration for Designate:

   salt -C 'I@haproxy:proxy' state.sls haproxy
   

5. Create endpoints for Designate in Keystone:

   salt -C 'I@keystone:client' state.sls keystone.client
   

6. Apply the designate states:

   salt -C 'I@designate:server and *01*' state.sls designate.server
   salt -C 'I@designate:server' state.sls designate
   

7. Verify that the Designate services are up and running:

   salt -C 'I@designate:server' cmd.run ". /root/keystonercv3; openstack dns service list"
   

   Example of the system response extract:

   ctl02.virtual-mcp-ocata-ovs.local:
   +-------------------+---------+-------------+-------+------+-------------+
   | id                |hostname |service_name |status |stats |capabilities |
   +-------------------+---------+-------------+-------+------+-------------+
   | 72df3c63-ed26-... | ctl03   | worker      | UP    | -    | -           |
   | c3d425bb-131f-... | ctl03   | central     | UP    | -    | -           |
   | 1af4c4ef-57fb-... | ctl03   | producer    | UP    | -    | -           |
   | 75ac49bc-112c-... | ctl03   | api         | UP    | -    | -           |
   | ee0f24cd-0d7a-... | ctl03   | mdns        | UP    | -    | -           |
   | 680902ef-380a-... | ctl02   | worker      | UP    | -    | -           |
   | f09dca51-c4ab-... | ctl02   | producer    | UP    | -    | -           |
   | 26e09523-0140-... | ctl01   | producer    | UP    | -    | -           |
   | 18ae9e1f-7248-... | ctl01   | worker      | UP    | -    | -           |
   | e96dffc1-dab2-... | ctl01   | central     | UP    | -    | -           |
   | 3859f1e7-24c0-... | ctl01   | api         | UP    | -    | -           |
   | 18ee47a4-8e38-... | ctl01   | mdns        | UP    | -    | -           |
   | 4c807478-f545-... | ctl02   | api         | UP    | -    | -           |
   | b66305e3-a75f-... | ctl02   | central     | UP    | -    | -           |
   | 3c0d2310-d852-... | ctl02   | mdns        | UP    | -    | -           |
   +-------------------+---------+-------------+-------+------+-------------+