starlingx/docs
Code Issues Proposed changes

Merge "Subcloud install or restore of previous release"

Browse Source
This commit is contained in:
Zuul 2024-11-18 15:12:00 +00:00 committed by Gerrit Code Review
commit 362541dad6
2 changed files with 43 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/source/dist_cloud/kubernetes/deploy-restore-and-manage-subclouds-of-previous-release-5e986615cb4b.rst
View File

@ -219,8 +219,8 @@ release version.
.. note::
The deploy files for N-1 release are automatically uploaded when
running the :command:`system --os-region-name SystemController
load-import --inactive` command. It is not mandatory to upload deploy
running the :command:`software --os-region-name SystemController upload
<bootimage>.iso <bootimage>.sig` command. It is not mandatory to upload deploy
files for the N release. If the deploy files are not uploaded, the
software will use the default deploy files included in the active load.
@ -428,7 +428,7 @@ one or both of the following steps:
.. code-block:: none
~(keystone_admin)]$ system --os-region-name SystemController load-import --inactive --local <bootimage.iso> <bootimage.sig>
~(keystone_admin)]$ software --os-region-name SystemController upload <bootimage>.iso <bootimage>.sig
#. |optional| Upload the N-1 release images list by using the following
command:
@ -449,19 +449,24 @@ one or both of the following steps:
+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------+
- To prestage a single subcloud, use :command:`dcmanager subcloud prestage`
command. The following command prestages a single subcloud with |prod|
|v_r6| data:
command. The following commands can be used to prestage a single subcloud
with |prod| |v_r6| data:
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud prestage --release <xx.xx> --sysadmin-password <sysadmin_password> <subcloud-name-or-id>
or
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud prestage --for-install --sysadmin-password <sysadmin-password> --release <xx.xx> <subcloud-name-or-id>
Where, <xx.xx> is the |prod| |v_r6| version.
- To prestage a group of subclouds use :command:`dcmanager prestage-strategy`
related commands. The following commands prestages a group of subclouds
with |prod| |v_r8| data:
related commands. The following commands can be used to prestage a group of
subclouds with |prod| |v_r8| data:
.. code-block:: none
@ -469,6 +474,14 @@ one or both of the following steps:
~(keystone_admin)]$ dcmanager prestage-strategy apply
or
.. code-block:: none
~(keystone_admin)]$ dcmanager prestage-strategy create --for-install --release <xx.xx> --sysadmin-password <sysadmin_password> --group <group_name>
~(keystone_admin)]$ dcmanager prestage-strategy apply
Where, <xx.xx> is the |prod| |v_r8| version.
Rehome a Subcloud

40
doc/source/dist_cloud/kubernetes/managing-subclouds-using-the-cli.rst
View File

@ -17,29 +17,33 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud list
+----+-----------+--------------+--------------------+-------------+
| id | name | management | availability | sync |
+----+-----------+--------------+--------------------+-------------+
| 1 | subcloud1 | managed | online | in-sync |
| 2 | subcloud2 | managed | online | in-sync |
| 3 | subcloud3 | managed | online | out-of-sync |
| 4 | subcloud4 | managed | offline | unknown |
+----+-----------+--------------+--------------------+-------------+
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud list
+----+-----------+------------+--------------+---------------+-------------+------------------+-----------------+
| id | name | management | availability | deploy status | sync | backup status | prestage status |
+----+-----------+------------+--------------+---------------+-------------+------------------+-----------------+
| 1 | subcloud1 | managed | online | complete | in-sync | complete-central | Complete |
| 2 | subcloud2 | managed | online | complete | in-sync | None | None |
| 3 | subcloud3 | managed | online | complete | out-of-sync | None | None |
| 4 | subcloud4 | unmanaged | offline | rehome-failed | unknown | None | None |
+----+-----------+------------+--------------+---------------+-------------+------------------+-----------------+
Options:
'd/-detail': Display all columns for the subclouds.
'c/-column': Specify the column(s) for the subclouds. eg. '-c column1 -c column2 ...'
- To show information for a subcloud, use the :command:`subcloud show` command.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud show <subcloud-name>
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud show <subcloud-name>
For example:
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud show subcloud2
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud show subcloud2
+-----------------------------+----------------------------+
| Field | Value |
+-----------------------------+----------------------------+
@ -71,7 +75,7 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud show subcloud2 --detail
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud show subcloud2 --detail
+-----------------------------+----------------------------+
| Field | Value |
+-----------------------------+----------------------------+
@ -102,7 +106,7 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud update \
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud update \
[–- description] <description> \
[– location] <location> \
<subcloud-name>
@ -115,12 +119,12 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud unmanage <subcloud-name>
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud unmanage <subcloud-name>
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud manage <subcloud-name>
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud manage <subcloud-name>
- To reconfigure a subcloud, if deployment fails, use the :command:`subcloud deploy config` command.
@ -130,7 +134,7 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud deploy config <subcloud-id/name> --deploy-config \
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud deploy config <subcloud-id/name> --deploy-config \
<filepath> --sysadmin-password <password>
@ -150,14 +154,14 @@ fails, delete subclouds, and monitor or change the managed status of subclouds.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud manage <subcloud-id/name>
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud manage <subcloud-id/name>
- To delete a subcloud, use the :command:`subcloud delete` command.
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud delete <subcloud-name>
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud delete <subcloud-name>
.. caution::