From 265d21ee17e61c07b30b770e5c8f3aeb08600dc8 Mon Sep 17 00:00:00 2001 From: Juanita Balaraj Date: Tue, 13 Jun 2023 20:26:28 +0000 Subject: [PATCH] Updated Restore Operation steps (r8, dsr8) Updated Patchset 5 comments Updated Includes file Updated Patchset 4 comments Added an additional note regarding storage space and transfer time. Updated Patchset 2 comments and added the ``* exclude_dirs=/opt/patching/**/*` parameter. Updated Patchset 1 comments Change-Id: I929f8a707c06fd91b99e94bc14e199a79687c3a0 Signed-off-by: Juanita Balaraj --- ...-system-data-and-storage-b92b8bdaf16d.rest | 5 ++ ...ring-starlingx-system-data-and-storage.rst | 65 +++++++++---------- ...kup-playbook-locally-on-the-controller.rst | 15 +++++ ...louds-using-dcmanager-cli-f12020a8fc42.rst | 13 +++- 4 files changed, 61 insertions(+), 37 deletions(-) create mode 100644 doc/source/_includes/restore-platform-system-data-and-storage-b92b8bdaf16d.rest diff --git a/doc/source/_includes/restore-platform-system-data-and-storage-b92b8bdaf16d.rest b/doc/source/_includes/restore-platform-system-data-and-storage-b92b8bdaf16d.rest new file mode 100644 index 000000000..bddca2734 --- /dev/null +++ b/doc/source/_includes/restore-platform-system-data-and-storage-b92b8bdaf16d.rest @@ -0,0 +1,5 @@ + +.. sw-patch-query-begin +.. sw-patch-query-end + + diff --git a/doc/source/backup/kubernetes/restoring-starlingx-system-data-and-storage.rst b/doc/source/backup/kubernetes/restoring-starlingx-system-data-and-storage.rst index 91c15fb86..4cf50b92c 100644 --- a/doc/source/backup/kubernetes/restoring-starlingx-system-data-and-storage.rst +++ b/doc/source/backup/kubernetes/restoring-starlingx-system-data-and-storage.rst @@ -24,15 +24,14 @@ optional data if not defined.- See :ref:`Back Up System Data ` for more details on the backup. - .. warning:: The system backup file can only be used to restore the system from which the backup was made. You cannot use this backup file to restore the system to different hardware. - - To restore the backup, use the same version of the boot image (ISO) that - was used at the time of the original installation. + + To restore the backup, use the same version of the boot image (ISO) and + patches that were installed at the time of the backup. The |prod| restore supports the following optional modes: @@ -54,12 +53,12 @@ The |prod| restore supports the following optional modes: wipe_ceph_osds=true - Restoring a |prod| cluster from a backup file is done by re-installing the -ISO on controller-0, running the Ansible Restore Playbook, applying updates -\(patches), unlocking controller-0, and then powering on, and unlocking the +ISO on controller-0, applying updates (patches), running the Ansible Restore +Playbook, unlocking controller-0, and then powering on, and unlocking the remaining hosts, one host at a time, starting with the controllers, and then the storage hosts, ONLY if required, and lastly the compute (worker) hosts. +Lastly, running :command:`system restore-complete` command. .. rubric:: |prereq| @@ -102,6 +101,12 @@ conditions are in place: where ```` is the name of the subcloud to be unmanaged. + For more information, see: + + - `Backup a Subcloud/Group of Subclouds using DCManager CLI ` + + - `Restore a Subcloud/Group of Subclouds from Backup Data Using DCManager CLI ` + .. rubric:: |proc| #. Power down all hosts. @@ -125,6 +130,20 @@ conditions are in place: #. Install network connectivity required for the subcloud. +#. Any patches that were present at the time of the backup will need to be + manually applied. This may include doing a reboot if required. + See :ref:`Install Kubernetes Platform on All-in-one Simplex `; + ``Install Software on Controller-0`` for steps on how to install patches + using the :command:`sw-patch install-local` command. + + After the reboot, you can verify that the updates were applied. + + .. only:: partner + + .. include:: /_includes/restore-platform-system-data-and-storage-b92b8bdaf16d.rest + :start-after: sw-patch-query-begin + :end-before: sw-patch-query-end + #. Ensure that the backup files are available on the controller. Run both Ansible Restore playbooks, restore_platform.yml and restore_user_images.yml. For more information on restoring the back up file, see :ref:`Run Restore @@ -140,37 +159,13 @@ conditions are in place: The restore operation will pull images from the Upstream registry, they are not part of the backup. -#. If the backup file contains patches, Ansible Restore playbook - restore_platform.yml will apply the patches and prompt you to reboot the - system, you will need to re-run Ansible Restore playbook. - - The current software version on the controller is compared against the - version available in the backup file. If the backed-up version includes - updates, the restore process automatically applies the updates and - forces an additional reboot of the controller to make them effective. - - After the reboot, you can verify that the updates were applied, as - illustrated in the following example: - - .. code-block:: none - - $ sudo sw-patch query - Patch ID RR Release Patch State - ======================== ========== ======= =========== - COMPUTECONFIG Available nn.nn n/a - LIBCUNIT_CONTROLLER_ONLY Applied nn.nn n/a - STORAGECONFIG Applied nn.nn n/a - - Rerun the Ansible Playbook if there were patches applied and you were - prompted to reboot the system. - - .. note:: - - After restore is completed it is not possible to restart (or rerun) the - restore playbook. #. Restore the local registry using the file restore_user_images.yml. + .. note:: + + This step applies only if it was created during the backup operation. + This must be done before unlocking controller-0. #. Unlock Controller-0. diff --git a/doc/source/backup/kubernetes/running-ansible-backup-playbook-locally-on-the-controller.rst b/doc/source/backup/kubernetes/running-ansible-backup-playbook-locally-on-the-controller.rst index 902edbe79..f39689031 100644 --- a/doc/source/backup/kubernetes/running-ansible-backup-playbook-locally-on-the-controller.rst +++ b/doc/source/backup/kubernetes/running-ansible-backup-playbook-locally-on-the-controller.rst @@ -30,6 +30,21 @@ the optional parameter: in order to ensure there is sufficient free space in the required directories in any event. +.. note:: + + To exclude multiple files and directories, separate them with a comma. + + Excluding patch data can save a significant amount of storage space, + transfer time, and compress/decompress computation. + +To exclude patch data from being included in the backup, you can use the parameter: +``-e exclude_dirs=/opt/patching/**/*``. + +.. warning:: + + Patch data should only be excluded for |AIO-SX| deployments when optimized + Restore is used. + The and need to be set correctly using the ``-e`` option on the command line, with an override file secured with ansible-vault (recommended). diff --git a/doc/source/dist_cloud/kubernetes/backup-a-subcloud-group-of-subclouds-using-dcmanager-cli-f12020a8fc42.rst b/doc/source/dist_cloud/kubernetes/backup-a-subcloud-group-of-subclouds-using-dcmanager-cli-f12020a8fc42.rst index 60d160d9f..f0ddd34e7 100644 --- a/doc/source/dist_cloud/kubernetes/backup-a-subcloud-group-of-subclouds-using-dcmanager-cli-f12020a8fc42.rst +++ b/doc/source/dist_cloud/kubernetes/backup-a-subcloud-group-of-subclouds-using-dcmanager-cli-f12020a8fc42.rst @@ -47,10 +47,19 @@ parameters/options: The yaml file containing the customization parameters for the backup operation. + - ``exclude_dirs=/opt/patching/**/*``: To exclude patch data from being + included in the Backup. + + .. warning:: + Patch data should only be excluded for |AIO-SX| subcloud deployments + when optimized Restore is used. + + .. note:: + Excluding patch data can save a significant amount of storage space, + transfer time, and compress/decompress the compute node. + - ``wipe_ceph_osds=false``: To keep the Ceph cluster data intact. - ``wipe_ceph_osds=true``: To wipe the Ceph cluster entirely - - ``on_box_data=true``: To indicate that the backup data file is under - /opt/platform-backup directory on the local machine See :ref:`Run Ansible Backup Playbook Locally on the Controller ` for the list