← Back to branch summary

~openstack-charmers/charms/trusty/openstack-dashboard/next

« back to all changes in this revision

Viewing changes to README.md

  • Committer: James Page
  • Author(s): David Ames
  • Date: 2016-06-23 08:24:49 UTC
  • Revision ID: james.page@ubuntu.com-20160623082449-t95bhe2ml26vhjo6
DNS HA

Implement DNS high availability. Pass the correct information to
hacluster to register a DNS entry with MAAS 2.0 or greater rather
than using a virtual IP.

Charm-helpers sync to bring in DNS HA helpers

Change-Id: Iec7b94b2e97d770dfc4b6f4f0c52983e39078b98

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.md
36
36
 
37
37
The service will be reconfigured to use the supplied information.
38
38
 
39
 
High Availability
40
 
=================
41
 
 
42
 
The OpenStack Dashboard charm supports HA in-conjunction with the hacluster
43
 
charm:
44
 
 
45
 
    juju deploy hacluster dashboard-hacluster
46
 
    juju set openstack-dashboard vip="192.168.1.200"
47
 
    juju add-relation openstack-dashboard dashboard-hacluster
48
 
    juju add-unit -n 2 openstack-dashboard
49
 
 
50
 
After addition of the extra 2 units completes, the dashboard will be
51
 
accessible on 192.168.1.200 with full load-balancing across all three units.
52
 
 
53
 
Please refer to the charm configuration for full details on all HA config
54
 
options.
55
 
 
 
39
HA/Clustering
 
40
=============
 
41
 
 
42
There are two mutually exclusive high availability options: using virtual
 
43
IP(s) or DNS. In both cases, a relationship to hacluster is required which
 
44
provides the corosync back end HA functionality.
 
45
 
 
46
To use virtual IP(s) the clustered nodes must be on the same subnet such that
 
47
the VIP is a valid IP on the subnet for one of the node's interfaces and each
 
48
node has an interface in said subnet. The VIP becomes a highly-available API
 
49
endpoint.
 
50
 
 
51
At a minimum, the config option 'vip' must be set in order to use virtual IP
 
52
HA. If multiple networks are being used, a VIP should be provided for each
 
53
network, separated by spaces. Optionally, vip_iface or vip_cidr may be
 
54
specified.
 
55
 
 
56
To use DNS high availability there are several prerequisites. However, DNS HA
 
57
does not require the clustered nodes to be on the same subnet.
 
58
Currently the DNS HA feature is only available for MAAS 2.0 or greater
 
59
environments. MAAS 2.0 requires Juju 2.0 or greater. The clustered nodes must
 
60
have static or "reserved" IP addresses registered in MAAS. The DNS hostname(s)
 
61
must be pre-registered in MAAS before use with DNS HA.
 
62
 
 
63
At a minimum, the config option 'dns-ha' must be set to true and at least one
 
64
of 'os-public-hostname', 'os-internal-hostname' or 'os-internal-hostname' must
 
65
be set in order to use DNS HA. One or more of the above hostnames may be set.
 
66
 
 
67
The charm will throw an exception in the following circumstances:
 
68
If neither 'vip' nor 'dns-ha' is set and the charm is related to hacluster
 
69
If both 'vip' and 'dns-ha' are set as they are mutually exclusive
 
70
If 'dns-ha' is set and none of the os-{admin,internal,public}-hostname(s) are
 
71
set
56
72
 
57
73
Use with a Load Balancing Proxy
58
74
===============================