Bug 1946902

Summary:	Add a note in upgrade guide to backup /etc/ssh and restore post host reprovisioning
Product:	[Red Hat Storage] Red Hat Gluster Storage	Reporter:	SATHEESARAN <sasundar>
Component:	Documentation	Assignee:	Disha Walvekar <dwalveka>
Status:	CLOSED CURRENTRELEASE	QA Contact:	SATHEESARAN <sasundar>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	rhhiv-1.8	CC:	rcyriac, rhs-bugs, storage-doc, storage-qa-internal
Target Milestone:	---
Target Release:	RHHI-V 1.8.z Batch Update 4
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2021-04-29 05:49:03 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description SATHEESARAN 2021-04-07 08:19:24 UTC

Describe the issue:
-------------------
Technically the SSH keys should be backed up before hyperconverged host reprovisioning and same should be restored post reprovisioning.

This step was missing in the RHHI-V 1.8 upgrade guide.

Describe the task you were trying to accomplish:
------------------------------------------------
Add a missing steps

Document URL:
-------------
https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.8/html-single/upgrading_red_hat_hyperconverged_infrastructure_for_virtualization/index

Chapter/Section Number and Title:
---------------------------------
4.4.2. Backing up the Gluster configurations
and
4.4.7. Copying the backup files to the newly installed host

Product Version:
-----------------
RHHI-V 1.8

Additional information:
------------------------
Section 4.4.2 should add one more last step to backup SSH keyfiles on all the hyperconverged hosts

3. Backup the SSH keyfiles under /etc/ssh on all the hyperconverged hosts
# [host1]# cp -a /etc/ssh /tmp/
# [host1]# cd /tmp; tar -cvzf `hostname`-etc-ssh.tar.gz ./ssh
# [host1]# scp `hostname`-etc-ssh.tar.gz root.com:/backup/

Perform the above steps in other hyperconverged hosts as well.

Section 4.4.7 to add one more last step to copy the backup of SSH keys
* Copy the SSH keys corresponding to the hyperconverged host
# scp root.com:/backupdir/host1.example.com-etc-ssh.tar.gz /root/

Edit 2nd point in 4.4.8 ( 4.4.8. Restoring gluster configuration files to the newly installed host ) to include extraction of SSH keys as well
# mkdir /archive
# tar -xvf /root/rhvh-host-host1.example.com.tar.gz -C /archive/
# tar -xvf /root/host1.example.com-etc-ssh.tar.gz -C /archive/

Update Section 4.4.10, point 4 with the following commands for the existing commands:
# scp root.com:/backupdir/rhvh-node-<hostname>-backup.tar.gz /root/
# scp root.com:/backupdir/<hostname>-etc-ssh.tar.gz /root/
# tar -xvf /root/rhvh-host-<hostname>-backup.tar.gz -C /archive/
# tar -xvf /root/<hostname>-etc-ssh.tar.gz -C /archive/

Comment 1 Disha Walvekar 2021-04-08 06:13:15 UTC

Hi Sas, 

I have made the changes as per the description of the bug if you can please verify the same.

LINK - https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.8/html-single/upgrading_red_hat_hyperconverged_infrastructure_for_virtualization/index?lb_target=preview#backing_up_the_gluster_configurations



Thank you!

-Disha Walvekar


P.S- Keeping the bug in a MODIFIED state as we do not have all the ACKS yet.

Comment 2 Disha Walvekar 2021-04-08 10:54:18 UTC

All ACKS are in place now, moving this bug to ON QA, please check comment 1.


I have made the changes as per the description of the bug if you can please verify the same.

LINK - https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.8/html-single/upgrading_red_hat_hyperconverged_infrastructure_for_virtualization/index?lb_target=preview#backing_up_the_gluster_configurations



Thank you!

Comment 3 Disha Walvekar 2021-04-12 06:49:25 UTC

Hi Sas, 

I have made the suggested changes as:

CHANGE 1:

Section 4.4.8
Point-3, just remove first lines of the command.
Current content: 3. Extract the SSH keys.

# mkdir /archive
# tar -xvf /root/rhvh-host-host1.example.com.tar.gz -C /archive/
# tar -xvf /root/host1.example.com-etc-ssh.tar.gz -C /archive/
Proposed content:3.  Extract the SSH keys.

# tar -xvf /root/host1.example.com-etc-ssh.tar.gz -C /archive/
-----------------------------------------------------------------------

CHANGE 2: 

Section 4.4.10
Existing content:Copy the gluster configuration tar files from the backup host to the newly installed host and untar the content.

# scp root.com:/backupdir/rhvh-node-<hostname>-backup.tar.gz /root/
# scp root.com:/backupdir/<hostname>-etc-ssh.tar.gz /root/
# tar -xvf /root/rhvh-host-<hostname>-backup.tar.gz -C /archive/
# tar -xvf /root/<hostname>-etc-ssh.tar.gz -C /archive/
proposed content:
------------------------------------------------------------------------------------------------------------------------------------
Copy the gluster configuration tar files and SSH keyfiles from the backup host to the newly installed host and untar the content.

# scp root.com:/backupdir/rhvh-node-<hostname>-backup.tar.gz /root/
# scp root.com:/backupdir/<hostname>-etc-ssh.tar.gz /root/
# mkdir /archive
# tar -xvf /root/rhvh-host-<hostname>-backup.tar.gz -C /archive/
# tar -xvf /root/<hostname>-etc-ssh.tar.gz -C /archive/
------------------------------------------------------------------------------------------------------------------

LINK - https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure_for_virtualization/1.8/html-single/upgrading_red_hat_hyperconverged_infrastructure_for_virtualization/index?lb_target=preview#restore-files

If you can please verify these changes.

Thank you!

-Disha Walvekar

Comment 4 SATHEESARAN 2021-04-12 07:20:00 UTC

Verified with the internal doc link. The content looks good