Bug 1402734 - [DOCS] Request for update downgrade Documentation for containerized etcd
Summary: [DOCS] Request for update downgrade Documentation for containerized etcd
Keywords:
Status: CLOSED EOL
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.4.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: ---
Assignee: Vikram Goyal
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-12-08 09:43 UTC by Anping Li
Modified: 2019-08-10 06:46 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-08-10 06:46:08 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Anping Li 2016-12-08 09:43:18 UTC
Document URL: 
https://docs.openshift.com/container-platform/3.3/install_config/downgrade.html

Section Number and Name: 

Describe the issue: 
The containerized etcd use different service name and systemd configure file. so it is better to adjust the document for it.

Suggestions for improvement: 

A single containerized etcd downgrade steps is as following. 

1) systemctl stop etcd_container
2) copy backup etcd data file
# ETCD_DIR=/var/lib/etcd/
# mv $ETCD_DIR /var/lib/etcd.orig
# cp -Rp /var/lib/origin/etcd-backup-<timestamp>/ $ETCD_DIR
# chcon -R --reference /var/lib/etcd.orig/ $ETCD_DIR
# chown -R etcd:etcd $ETCD_DIR

3) Modify /etc/systemd/system/etcd_container.service;
  3.1)  set correct image version
  3.2)  add --force-new-cluster
  For example
   ExecStart=/usr/bin/docker run --name etcd_container --rm -v /var/lib/etcd:/var/lib/etcd:z -v /etc/etcd:/etc/etcd:z --env-file=/etc/etcd/etcd.conf --net=host --entrypoint=/usr/bin/etcd registry.access.redhat.com/rhel7/etcd3:3.0.14
   ExecStart=/usr/bin/docker run --name etcd_container --rm -v /var/lib/etcd:/var/lib/etcd:z -v /etc/etcd:/etc/etcd:z --env-file=/etc/etcd/etcd.conf --net=host --entrypoint=/usr/bin/etcd registry.access.redhat.com/rhel7/etcd --force-new-cluster
4) systemctl daemon-reload
5) systemctl start etcd_container
6) remove the --force-new-cluster in /etc/systemd/system/etcd_container.service
   
7)  systemctl daemon-reload; systemctl restart etcd_container


Additional information:


Note You need to log in before you can comment on or make changes to this bug.