Chapter 18. Backup and Restore

Because the restore procedure involves a complete reinstallation, save all the files used in the initial installation. This may include:

Install packages that provide various utility commands:

# yum install etcd

Save all the certificates and keys, on each master:

# cd /etc/origin/master
# tar cf /tmp/certs-and-keys-$(hostname).tar \
    master.proxy-client.crt \
    master.proxy-client.key \
    proxyca.crt \
    proxyca.key \
    master.server.crt \
    master.server.key \
    ca.crt \
    ca.key \
    master.etcd-client.crt \
    master.etcd-client.key \
    master.etcd-ca.crt

If etcd is running on more than one host, stop it on each host:

# sudo systemctl stop etcd

Although this step is not strictly necessary, doing so ensures that the etcd data is fully synchronized.

Create an etcd backup:

# etcdctl backup \
    --data-dir $ETCD_DATA_DIR \
    --backup-dir $ETCD_DATA_DIR.bak

Create a template for all cluster API objects:

$ oc export all \
    --exact \1
    --all-namespaces \
    --as-template=mycluster \2
    > mycluster.template.yaml

The object types included in oc export all are:

Reinstall OpenShift Enterprise.

This should be done in the same way that OpenShift Enterprise was previously installed.

Restore the certificates and keys, on each master:

# cd /etc/origin/master
# tar xvf /tmp/certs-and-keys-$(hostname).tar

Restore from the etcd backup:

# mv $ETCD_DATA_DIR $ETCD_DATA_DIR.orig
# cp -Rp $ETCD_DATA_DIR.bak $ETCD_DATA_DIR
# chcon -R --reference $ETCD_DATA_DIR.orig $ETCD_DATA_DIR
# chown -R etcd:etcd $ETCD_DATA_DIR

Create the API objects for the cluster:

$ oc create -f mycluster.template.yaml