Jump to: navigation, search

Difference between revisions of "Designate/Atlanta/Workshop 1"

(Install Designate)
Line 37: Line 37:
 
#: $ sudo su -
 
#: $ sudo su -
 
# Install Designate and its dependencies
 
# Install Designate and its dependencies
#: $ cd to /home/vagrant/designate
+
#: $ cd /home/vagrant/designate
 
#: $ apt-get build-dep python-lxml. Respond "Y" to question (or just hit enter)
 
#: $ apt-get build-dep python-lxml. Respond "Y" to question (or just hit enter)
 
#: $ [sudo] pip install -r requirements.txt -r test-requirements.txt
 
#: $ [sudo] pip install -r requirements.txt -r test-requirements.txt
Line 73: Line 73:
 
==== Check services are up ====
 
==== Check services are up ====
 
* $ ps aux | grep designate
 
* $ ps aux | grep designate
 +
 
=== Exercise the Designate API ===
 
=== Exercise the Designate API ===
 
# Test API locally on VM:  
 
# Test API locally on VM:  

Revision as of 19:18, 28 April 2014

Designate: Interactive Workshop - Install and Operate - Openstack Summit, May 2014

Designate provides DNSaaS services for OpenStack.

This interactive workshop will guide attendees on how Designate can be installed with PowerDNS. For the purposes of the workshop the various designate components will be installed on a single node. Once installed it shows some of the V1 and V2 APIs for domain and record management. The workshop will conclude by using a tool like dig to retrieve the added records from the PowerDNS backend, showing a fully functional by-hand deployment.

The workshop will also cover the steps for contributing to the development of Designate.

Several of the Designate contributors will be on hand during the workshop to help attendees work through the deployment.

See also: "Designate: An Overview of DNSaaS for Openstack" and “Designate: Deep Dive for Operators/Deployers”

Designate Installation Instructions - DRAFT

Verify VM and Openstack core components are installed and correctly configured

  1. verify python environment is installed
    $ which pip
    /usr/bin/pip
    $ which virtualenv
    /usr/bin/virtualenv
  2. verify RabbitMQ Server is installed and configured correctly:
  3. verify Glance Service is installed and configured correctly:
  4. verify Glance Client is installed and configured correctly:
  5. verify Keystone Service is installed and configured correctly:
  6. verify Keystone Client is installed and configured correctly:
  7. verify Neutron Service is installed and configured correctly:
  8. verify Neutron Client is installed and configured correctly:
  9. verify Nova Service is installed and configured correctly:
  10. verify Nova Client is installed and configured correctly:
  11. verify MySQL is installed: <cmd>
  12. verify MySQl is configured correctly:

Install Designate

  1. Start the VM
    $ vagrant up
  2. Log into the VM
    $ vagrant ssh
  3. Be super user
    $ sudo su -
  4. Install Designate and its dependencies
    $ cd /home/vagrant/designate
    $ apt-get build-dep python-lxml. Respond "Y" to question (or just hit enter)
    $ [sudo] pip install -r requirements.txt -r test-requirements.txt
    $ python setup.py develop
  5. Copy sample designate files and edit
    $ cd etc/designate (/home/vagrant/designate/etc/designate)
    $ ls *.sample | while read f; do cp $f $(echo $f | sed "s/.sample$//g"); done
    (See section below for config values - "Other Designate Workshop Command Lines")
  6. Create directory for maintaining designate state information (this directory was referenced by 'state_path' variable in designate.conf file)
    $ mkdir /var/lib/designate
  7. Create directory for maintaining designate log files (this directory was referenced by 'logdir' variable in designate.conf file)
    $ mkdir /var/log/designate

Install the DNS server (PowerDNS)

Suppress default behavior of PowerDNS package creating it's own database, then install
  • $ echo 'set pdns-backend-mysql/dbconfig-install false' | debconf-communicate
  • $ DEBIAN_FRONTEND=noninteractive apt-get install pdns-server pdns-backend-mysql
(Hit <Enter> or enter 'Y' to question 'Do you want to continue [Y/n]?')
Change the 'gmysql-dbname' entry in /etc/powerdns/pdns.d/pdns.local.gmysql to point to appropriate location as ff:
  • gmysql-dbname=/var/lib/designate/pdns

Create, Initialize and sync the databases

The Designate database
  • $ mysql -e 'CREATE DATABASE `designate` CHARACTER SET utf8 COLLATE utf8_general_ci;'
  • $ designate-manage database init
  • $ designate-manage database sync
The PowerDNS database
  • $ mysql -e 'CREATE DATABASE `pdns` CHARACTER SET utf8 COLLATE utf8_general_ci;'
  • $ designate-manage powerdns init
  • $ designate-manage powerdns sync

Start the Designate Central Service

  • $ designate-central&

Start the Designate API Service

  • $ designate-api&

Start PowerDNS

  • $ service pdns start

Check services are up

  • $ ps aux | grep designate

Exercise the Designate API

  1. Test API locally on VM:
    $ curl http://localhost:9001
  2. Test API from External Client (e.g. Google Chrome HTTP Client):
    http://localhost:9001/v2/

More Sample Helpful commands below in "Other Designate Workshop Command Lines"

Other Designate Workshop Command Lines

  • $ killall designate-api
  • $ killall designate-central

Additional Notes on the workshop

I chose PowerDNS as the backend rather than BIND as it is more well tested as of now. I put in a single node – so that it is easier to control and easier for newbies to install. Also we talked about the workshop showing migration to Designate. However I think it is early at this point for us to talk about migration as we have not yet done a migrate with Designate.

Removed

  • REST API for domain & record management
  • Multi-tenant
  • Integrated with Keystone for authentication
  • Framework in place to integrate with Nova and Neutron notifications (for auto-generated records)
  • Support for PowerDNS and Bind9 out of the box