Subcloud reinstall need error logging on failure for incorrect version
Worked on a bug. Worked on new upstream updates by Yuxing. Worked on Mary's comments. Worked on Tee's comments. Signed-off-by: egoncalv <elisamaraaoki.goncalves@windriver.com> Change-Id: I06197a78ae3badc7b1c934a17939c145d86be78d
This commit is contained in:
egoncalv
parent
f610de3196
commit
817e899ba5
@ -0,0 +1,13 @@
|
||||
|
||||
|
||||
.. begin-ref-1
|
||||
.. end-ref-1
|
||||
|
||||
.. begin-ref-2
|
||||
.. end-ref-2
|
||||
|
||||
.. begin-ref-3
|
||||
.. end-ref-3
|
||||
|
||||
.. begin-ref-4
|
||||
.. end-ref-4
|
||||
@ -7,16 +7,16 @@ Reinstall a Subcloud with Redfish Platform Management Service
|
||||
=============================================================
|
||||
|
||||
For subclouds with servers that support Redfish Virtual Media Service
|
||||
\(version 1.2 or higher\), you can use the Central Cloud's CLI to re-install
|
||||
\(version 1.2 or higher\), you can use the Central Cloud's CLI to reinstall
|
||||
the ISO and bootstrap subclouds from the Central Cloud.
|
||||
|
||||
.. caution::
|
||||
|
||||
All application and data on the subcloud will be lost after re-installation.
|
||||
All application and data on the subcloud will be lost after reinstallation.
|
||||
|
||||
.. rubric:: |context|
|
||||
|
||||
The subcloud reinstallation has two phases:
|
||||
The subcloud reinstallation has these phases:
|
||||
|
||||
Executing the dcmanager subcloud reinstall command in the Central Cloud:
|
||||
|
||||
@ -25,25 +25,36 @@ Executing the dcmanager subcloud reinstall command in the Central Cloud:
|
||||
|
||||
- Uses Ansible to bootstrap |prod| on controller-0.
|
||||
|
||||
.. only:: partner
|
||||
|
||||
.. include:: ../_includes/reinstalling-a-subcloud-with-redfish-platform-management-service.rest
|
||||
:start-after: begin-ref-1
|
||||
:end-before: end-ref-1
|
||||
|
||||
.. rubric:: |prereq|
|
||||
|
||||
- The install values are required for subcloud reinstallation. By default,
|
||||
install values are stored in the database after a subcloud installation or
|
||||
upgrade, and the reinstallation will re-use the install values. If you want
|
||||
to update the install values, use the following CLI command in the Central
|
||||
Cloud.
|
||||
install values are stored in database after a subcloud installation or
|
||||
upgrade, and the reinstallation will re-use these values. You can use the
|
||||
following CLI command in the Central Cloud to update them if necessary:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
~(keystone_admin)]$ dcmanager subcloud update subcloud1 --install-values install-values.yaml --bmc-password <password>
|
||||
~(keystone_admin)]$ dcmanager subcloud update subcloud1 --install-values\ install-values.yml --bmc-password <password>
|
||||
|
||||
For more information on install-values.yaml file, see :ref:`Installing a Subcloud Using Redfish Platform Management Service
|
||||
For more information on install-values.yml file, see :ref:`Install a
|
||||
Subcloud Using Redfish Platform Management Service
|
||||
<installing-a-subcloud-using-redfish-platform-management-service>`.
|
||||
|
||||
You can only reinstall the same software version with the Central Cloud on
|
||||
the subcloud.
|
||||
the subcloud. If the software version of the subcloud is not same as the
|
||||
system controller, the reinstall command will update the software version of
|
||||
the subcloud and install the correct version afterwards.
|
||||
|
||||
- Check the subcloud's availability in the Central Cloud, for example,
|
||||
|
||||
- Check the subcloud's availability in the Central Cloud.
|
||||
|
||||
For example:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
@ -56,16 +67,39 @@ Executing the dcmanager subcloud reinstall command in the Central Cloud:
|
||||
+----+----------+------------+--------------+---------------+---------+
|
||||
|
||||
As the reinstall will cause data and application loss, it is not necessary
|
||||
and not recommended to reinstall a healthy subcloud. The dcmanager rejects
|
||||
the reinstallation of a managed or online subcloud.
|
||||
and not recommended to reinstall a healthy subcloud. Reinstallation request
|
||||
of a managed or online subcloud will therefore be rejected.
|
||||
|
||||
.. rubric:: |proc|
|
||||
|
||||
#. Execute the reinstall using the CLI. For example,
|
||||
#. Create the subcloud bootstrap-values.yml file if it is not available
|
||||
already. This file contains the configuration parameters used to bootstrap
|
||||
the controller-0 of the subcloud that differ from the default bootstrap
|
||||
values.
|
||||
|
||||
For more information on bootstrap-values.yml file, see :ref:`Install a
|
||||
Subcloud Using Redfish Platform Management Service
|
||||
<installing-a-subcloud-using-redfish-platform-management-service>`.
|
||||
|
||||
.. only:: partner
|
||||
|
||||
.. include:: ../_includes/reinstalling-a-subcloud-with-redfish-platform-management-service.rest
|
||||
:start-after: begin-ref-2
|
||||
:end-before: end-ref-2
|
||||
|
||||
#. Execute the reinstall CLI.
|
||||
|
||||
For example:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
~(keystone_admin)]$ dcmanager subcloud reinstall subcloud1
|
||||
~(keystone_admin)]$ dcmanager subcloud reinstall subcloud1 --bootstrap-values /home/sysadmin/subcloud1-bootstrap-values.yml –sysadmin-password <sysadmin_password>
|
||||
|
||||
.. only:: partner
|
||||
|
||||
.. include:: ../_includes/reinstalling-a-subcloud-with-redfish-platform-management-service.rest
|
||||
:start-after: begin-ref-3
|
||||
:end-before: end-ref-3
|
||||
|
||||
#. Confirm the reinstall of the subcloud.
|
||||
|
||||
@ -80,9 +114,11 @@ Executing the dcmanager subcloud reinstall command in the Central Cloud:
|
||||
|
||||
Any other input will abort the reinstallation.
|
||||
|
||||
#. At the Central Cloud, monitor the progress of the subcloud installation
|
||||
and bootstrapping by using the deploy status field of the dcmanager
|
||||
subcloud list command, for example,
|
||||
#. In the Central Cloud, monitor the progress of the subcloud installation
|
||||
and bootstrapping by viewing the deploy status field of the dcmanager
|
||||
subcloud list command.
|
||||
|
||||
For example:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
@ -94,18 +130,24 @@ Executing the dcmanager subcloud reinstall command in the Central Cloud:
|
||||
| 1 | subcloud1 | unmanaged | offline | installing | unknown |
|
||||
+----+-----------+------------+--------------+---------------+---------+
|
||||
|
||||
For more information on the deploy status filed, see :ref:`Installing a Subcloud Using Redfish Platform Management Service
|
||||
For more information on the deploy status filed, see :ref:`Install a Subcloud Using Redfish Platform Management Service
|
||||
<installing-a-subcloud-using-redfish-platform-management-service>`.
|
||||
|
||||
You can also monitor detailed logging of the subcloud installation,
|
||||
bootstrapping by monitoring the following log files on the active
|
||||
controller in the Central Cloud.
|
||||
You can also monitor detailed logging of the subcloud installation and
|
||||
bootstrapping by monitoring the following log file on the active
|
||||
controller in the Central Cloud:
|
||||
|
||||
- /var/log/dcmanager/subcloud_name_install_date_stamp.log
|
||||
- /var/log/dcmanager/subcloud_name_bootstrap_date_stamp.log
|
||||
- /var/log/dcmanager/ansible/subcloud1_playbook_output.log
|
||||
|
||||
#. After the subcloud is successfully reinstalled and bootstrapped, use the
|
||||
following command to reconfigure the subcloud, **subcloud reconfig**.
|
||||
For more information, see :ref:`Managing Subclouds Using the CLI
|
||||
<managing-subclouds-using-the-cli>`.
|
||||
#. After the subcloud is successfully reinstalled and bootstrapped, run the
|
||||
subcloud reconfig command to complete the process. The subcloud
|
||||
availability status will change from offline to online when the
|
||||
reconfiguration is complete. For more information, see :ref:`Manage
|
||||
Subclouds Using the CLI <managing-subclouds-using-the-cli>`.
|
||||
|
||||
.. only:: partner
|
||||
|
||||
.. include:: ../_includes/reinstalling-a-subcloud-with-redfish-platform-management-service.rest
|
||||
:start-after: begin-ref-4
|
||||
:end-before: end-ref-4
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user