Bug 1946902 - Add a note in upgrade guide to backup /etc/ssh and restore post host reprovisioning
Summary: Add a note in upgrade guide to backup /etc/ssh and restore post host reprovis...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: Documentation
Version: rhhiv-1.8
Hardware: x86_64
OS: Linux
unspecified
high
Target Milestone: ---
: RHHI-V 1.8.z Batch Update 4
Assignee: Disha Walvekar
QA Contact: SATHEESARAN
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-04-07 08:19 UTC by SATHEESARAN
Modified: 2021-04-29 05:49 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-04-29 05:49:03 UTC
Embargoed:


Attachments (Terms of Use)

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


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