openstack/openstack-manuals
Code Issues Proposed changes
9767938a16
openstack-manuals/doc/install-guide/source/environment-etcd-ubuntu.rst
Jens Harbott 49457f47ed Fix etcd setup on Ubuntu 18.04 
The etcd service is enabled by default on Ubuntu 18.04, so it is already
running after installing the package. We need to restart the service
instead of only starting it in order to pick up our new configuration.

Change-Id: Ie1d25eb6afe606d75865542b3fdea5d48db4c46a
2019-10-07 07:27:07 +00:00

1.5 KiB
Raw Blame History

Etcd for Ubuntu

OpenStack services may use Etcd, a distributed reliable key-value store for distributed key locking, storing configuration, keeping track of service live-ness and other scenarios.

The etcd service runs on the controller node.

Install and configure components

  1. Install the etcd package:

    # apt install etcd

    Note

    As of Ubuntu 18.04, the etcd package is no longer available from the default repository. To install successfully, enable the Universe repository on Ubuntu.

  2. Edit the /etc/default/etcd file and set the ETCD_INITIAL_CLUSTER, ETCD_INITIAL_ADVERTISE_PEER_URLS, ETCD_ADVERTISE_CLIENT_URLS, ETCD_LISTEN_CLIENT_URLS to the management IP address of the controller node to enable access by other nodes via the management network:

    ETCD_NAME="controller"
ETCD_DATA_DIR="/var/lib/etcd"
ETCD_INITIAL_CLUSTER_STATE="new"
ETCD_INITIAL_CLUSTER_TOKEN="etcd-cluster-01"
ETCD_INITIAL_CLUSTER="controller=http://10.0.0.11:2380"
ETCD_INITIAL_ADVERTISE_PEER_URLS="http://10.0.0.11:2380"
ETCD_ADVERTISE_CLIENT_URLS="http://10.0.0.11:2379"
ETCD_LISTEN_PEER_URLS="http://0.0.0.0:2380"
ETCD_LISTEN_CLIENT_URLS="http://10.0.0.11:2379"

Finalize installation

  1. Enable and restart the etcd service:

    # systemctl enable etcd
# systemctl restart etcd