openstack-manuals/doc/install-guide/source/environment-etcd-ubuntu.rst

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.

   As for Ubuntu 24.04 install the package with following name:

   # apt install etcd-server

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