Merge "AIO-DX:[BnR] Ansible platform restore fails in TASK (dsMR2, dsRM3)"

This commit is contained in:
Zuul 2024-04-23 14:02:06 +00:00 committed by Gerrit Code Review
commit 51cf539d90
3 changed files with 44 additions and 23 deletions

View File

@ -48,9 +48,10 @@ The |prod| restore supports the following optional modes:
wipe_ceph_osds=false wipe_ceph_osds=false
- To wipe the Ceph cluster entirely (true), where the Ceph cluster will - To wipe the Ceph cluster entirely (true), where the Ceph cluster will need
need to be recreated, or if the Ceph partition was wiped somehow before or to be recreated, or if the Ceph partition was previously wiped, such as
during reinstall, use the following parameter: during a fresh install between backup and restore or during reinstall, use
the following parameter:
.. code-block:: none .. code-block:: none

View File

@ -49,10 +49,22 @@ Below you can find other ``-e`` command line options:
(Optional): You can select one of the following restore modes: (Optional): You can select one of the following restore modes:
- To keep the Ceph cluster data intact (false - default option), use the - To keep the Ceph cluster data intact (false - default option), use the
``wipe_ceph_osds=false`` parameter. following parameter, when passing the extra arguments to the Ansible
Restore playbook command:
- To wipe the Ceph cluster entirely (true), where the Ceph cluster will .. code-block:: none
need to be recreated, use the ``wipe_ceph_osds=true`` parameter.
wipe_ceph_osds=false
To wipe the Ceph cluster entirely (true), where the Ceph cluster will need
to be recreated, or if the Ceph partition was previously wiped, such as
during a fresh install between backup and restore or during reinstall, use
the following parameter:
.. code-block:: none
wipe_ceph_osds=true
- To define a convinient place to store the backup files, defined by - To define a convinient place to store the backup files, defined by
``initial-backup_dir``, on the system (such as the home folder for ``initial-backup_dir``, on the system (such as the home folder for

View File

@ -54,22 +54,31 @@ In this method you can run Ansible Restore playbook and point to controller-0.
where ``optional-extra-vars`` can be: where ``optional-extra-vars`` can be:
- To keep Ceph data intact (false - default option), use the - To keep the Ceph cluster data intact (false - default option), use the
following parameter: following parameter when passing the extra arguments to the Ansible
Restore playbook command:
:command:`wipe_ceph_osds=false` .. code-block::
- To start with an empty Ceph cluster (true), where the Ceph wipe_ceph_osds=false
cluster will need to be recreated, use the following parameter:
:command:`wipe_ceph_osds=true` To wipe the Ceph cluster entirely (true), where the Ceph cluster will
need to be recreated, or if the Ceph partition was previously wiped
(for example, during a fresh install between backup and restore), or
during a reinstall, use the following parameter:
- To define a convinient place to store the backup files, defined by .. code-block::
``initial-backup_dir``, on the system (such as the home folder for
wipe_ceph_osds=true
- To set a convinient place to store the backup files defined by
``initial-backup_dir`` on the system (such as the home folder for
sysadmin, or /tmp, or even a mounted USB device), use the following sysadmin, or /tmp, or even a mounted USB device), use the following
parameter: parameter:
:command:`on_box_data=true/false` .. code-block::
on_box_data=true/false
If this parameter is set to true, Ansible Restore playbook will look If this parameter is set to true, Ansible Restore playbook will look
for the backup file provided on the target server. The parameter for the backup file provided on the target server. The parameter
@ -77,11 +86,11 @@ In this method you can run Ansible Restore playbook and point to controller-0.
case, the backup file will be under ``/opt/platform-backup`` directory. case, the backup file will be under ``/opt/platform-backup`` directory.
If this parameter is set to false, the Ansible Restore playbook will If this parameter is set to false, the Ansible Restore playbook will
look for backup file provided where is the Ansible controller. In this look for a backup file provided on the Ansible controller. In this
case, both the ``initial_backup_dir`` and ``backup_filename`` must be case, both the ``initial_backup_dir`` and ``backup_filename`` must be
specified in the command. specified in the command.
- The ``backup_filename`` is the platform backup tar file. It must be - ``backup_filename`` is the platform backup tar file. It must be
provided using the ``-e`` option on the command line, for example: provided using the ``-e`` option on the command line, for example:
.. code-block:: none .. code-block:: none
@ -102,10 +111,9 @@ In this method you can run Ansible Restore playbook and point to controller-0.
:command:`ansible_ssh_pass` is the password to the sysadmin user :command:`ansible_ssh_pass` is the password to the sysadmin user
on controller-0. on controller-0.
- The :command:`ansible_remote_tmp` should be set to a new - The :command:`ansible_remote_tmp` should be set to a new directory (not
directory (not required to create it ahead of time) under required to create it ahead of time) under ``/home/sysadmin`` on
/home/sysadmin on controller-0 using the ``-e`` option on the command controller-0 using the ``-e`` option on the command line.
line.
For example: For example:
@ -118,7 +126,7 @@ In this method you can run Ansible Restore playbook and point to controller-0.
If ``ansible_remote_tmp`` is not set, ``/tmp`` will be used. ``/tmp`` If ``ansible_remote_tmp`` is not set, ``/tmp`` will be used. ``/tmp``
can only hold 1GB. can only hold 1GB.
An example of what happens when ``ansible_remote_tmp`` is not used: Below is sample output without ``ansible_remote_tmp``:
.. code-block:: none .. code-block:: none
@ -130,7 +138,7 @@ In this method you can run Ansible Restore playbook and point to controller-0.
scp: /tmp/.ansible-sysadmin/tmp/ansible-tmp-1687355968.13-696694507261/source: No space left on device scp: /tmp/.ansible-sysadmin/tmp/ansible-tmp-1687355968.13-696694507261/source: No space left on device
- The ``ssl_ca_certificate_file`` defines a single certificate that - ``ssl_ca_certificate_file`` defines a single certificate that
contains all the ssl_ca certificates that will be installed during the contains all the ssl_ca certificates that will be installed during the
restore. It will replace the restore. It will replace the
``/opt/platform/config/<software-version>/ca-cert.pem``, which is a ``/opt/platform/config/<software-version>/ca-cert.pem``, which is a