mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
61 lines
2.9 KiB
Plaintext
61 lines
2.9 KiB
Plaintext
//Module included in the following assemblies:
|
|
//
|
|
// * microshift_updating/microshift-update-options.adoc
|
|
// * microshift_backup_and_restore/microshift-auto-recover-manual-backup.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="microshift-restoring-data-backups-manually_{context}"]
|
|
= Restoring {microshift-short} data backups manually
|
|
|
|
You can restore {microshift-short} data from a backup manually. Backups can be restored after updates, or after other system events that remove or damage required data. When you restore a backup, you must use the entire file path.
|
|
|
|
[NOTE]
|
|
====
|
|
On an `rpm-ostree` system, {microshift-short} backs up and restores data automatically. Automated backups are in the `/var/lib/microshift-backups` directory by default.
|
|
====
|
|
|
|
.Prerequisites
|
|
|
|
* Root access to the host.
|
|
* You have the full path of the data backup file.
|
|
* The {microshift-short} service is stopped.
|
|
|
|
.Procedure
|
|
|
|
. Manually restore {microshift-short} data by using the full file path of the backup you want to restore by running the following command:
|
|
+
|
|
[source,terminal,subs="+quotes"]
|
|
----
|
|
$ sudo microshift restore /var/lib/microshift-backups/_<manual_backup>_ <1>
|
|
----
|
|
<1> Replace `_<manual_backup>_` with the backup name that you used. Optional: You can also restore automatic `ostree` backups using the full file path.
|
|
+
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
??? I1017 07:39:52.055165 6007 data_manager.go:131] "Copying backup to data directory" storage="/var/lib/microshift-backups" name="test" data="/var/lib/microshift"
|
|
??? I1017 07:39:52.055243 6007 data_manager.go:154] "Renaming existing data dir" data="/var/lib/microshift" renamedTo="/var/lib/microshift.saved"
|
|
??? I1017 07:39:52.055326 6007 data_manager.go:227] "Starting copy" cmd="/bin/cp --verbose --recursive --preserve --reflink=auto /var/lib/microshift-backups/test /var/lib/microshift"
|
|
??? I1017 07:39:52.061363 6007 data_manager.go:241] "Finished copy" cmd="/bin/cp --verbose --recursive --preserve --reflink=auto /var/lib/microshift-backups/test /var/lib/microshift"
|
|
??? I1017 07:39:52.061404 6007 data_manager.go:175] "Removing temporary data directory" path="/var/lib/microshift.saved"
|
|
??? I1017 07:39:52.063745 6007 data_manager.go:180] "Copied backup to data directory" name="test" data="/var/lib/microshift"
|
|
----
|
|
|
|
. Optional. Manually restore data from a customized directory by using the full file path of the backup. Run the following command:
|
|
+
|
|
[source,terminal,subs="+quotes"]
|
|
----
|
|
$ sudo microshift restore /mnt/_<other_backups_location>_/_<another_manual_backup>_ <1>
|
|
----
|
|
<1> Replace `_<other_backups_location>_` with the directory you used and `_<my_manual_backup>_` with the backup name you used when creating the backup you are restoring.
|
|
|
|
. Restart the host. Restarting the host enables all workloads and pods to restart.
|
|
|
|
.Verification
|
|
|
|
* Use the `oc get pods -A` command to verify that the node is running, then check the restored data.
|
|
+
|
|
--
|
|
include::snippets/microshift-healthy-pods-snip.adoc[leveloffset=+2]
|
|
--
|