003d5d4439
Add new items with example to sections.
Add new example figure.
Fix numbering.
Resize figures to fit the page.
Update log files name.
Add item 4 in include file.
RS> Conditionalize 'dcmanager subcloud list' states for
various run scenarios
RS> Move step from .. only:: block to .. include::
RS> Pre-process included blocks in non-block context
RS> Remove debug message from script
EG> Added example
EG> Fixed caution box
Story: 2010271
Task: 46946
Signed-off-by: Elisamara Aoki Goncalves <elisamaraaoki.goncalves@windriver.com>
Change-Id: I3791a23fefba8d9d428ae208b3bfcb9274d49278
188 lines
8.0 KiB
ReStructuredText
188 lines
8.0 KiB
ReStructuredText
|
||
.. rrh1558616429378
|
||
.. _managing-subclouds-using-the-cli:
|
||
|
||
==============================
|
||
Manage Subclouds Using the CLI
|
||
==============================
|
||
|
||
You can use the |CLI| to list subclouds, reconfigure subclouds if deployment
|
||
fails, delete subclouds, and monitor or change the managed status of subclouds.
|
||
|
||
.. rubric:: |proc|
|
||
|
||
.. _managing-subclouds-using-the-cli-steps-unordered-r4m-2w5-5cb:
|
||
|
||
- To list subclouds, use the :command:`subcloud list` command.
|
||
|
||
For example:
|
||
|
||
.. 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 |
|
||
+----+-----------+--------------+--------------------+-------------+
|
||
|
||
|
||
- To show information for a subcloud, use the :command:`subcloud show` command.
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud show <subcloud-name>
|
||
|
||
|
||
For example:
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud show subcloud2
|
||
+-----------------------------+----------------------------+
|
||
| Field | Value |
|
||
+-----------------------------+----------------------------+
|
||
| id | 2 |
|
||
| name | subcloud2 |
|
||
| description | subcloud2 description |
|
||
| location | subcloud 2 location |
|
||
| software_version | nn.nn |
|
||
| management | managed |
|
||
| availability | online |
|
||
| deploy_status | complete |
|
||
| management_subnet | 192.168.101.0/24 |
|
||
| management_start_ip | 192.168.101.2 |
|
||
| management_end_ip | 192.168.101.50 |
|
||
| management_gateway_ip | 192.168.101.1 |
|
||
| systemcontroller_gateway_ip | 192.168.204.101 |
|
||
| created_at | 2020-03-05 21:43:46.525251 |
|
||
| updated_at | 2020-03-06 19:53:39.560771 |
|
||
| identity_sync_status | in-sync |
|
||
| patching_sync_status | in-sync |
|
||
| platform_sync_status | in-sync |
|
||
+-----------------------------+----------------------------+
|
||
|
||
|
||
- To show information about the oam-floating-ip field for a specific
|
||
subcloud, use the :command:`subcloud show <subcloud-name> --detail` command.
|
||
|
||
For example,
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud show subcloud2 --detail
|
||
+-----------------------------+----------------------------+
|
||
| Field | Value |
|
||
+-----------------------------+----------------------------+
|
||
| id | 2 |
|
||
| name | subcloud2 |
|
||
| description | subcloud2 description |
|
||
| location | subcloud 2 location |
|
||
| software_version | nn.nn |
|
||
| management | managed |
|
||
| availability | online |
|
||
| deploy_status | complete |
|
||
| management_subnet | 192.168.101.0/24 |
|
||
| management_start_ip | 192.168.101.2 |
|
||
| management_end_ip | 192.168.101.50 |
|
||
| management_gateway_ip | 192.168.101.1 |
|
||
| systemcontroller_gateway_ip | 192.168.204.101 |
|
||
| created_at | 2020-03-05 21:43:46.525251 |
|
||
| updated_at | 2020-03-06 19:53:39.560771 |
|
||
| identity_sync_status | in-sync |
|
||
| patching_sync_status | in-sync |
|
||
| platform_sync_status | in-sync |
|
||
| oam_floating_ip | 10.10.10.12 |
|
||
+-----------------------------+----------------------------+
|
||
|
||
|
||
- To edit the settings for a subcloud, use the :command:`subcloud update`
|
||
command.
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud update \
|
||
[–- description] <description> \
|
||
[– location] <location> \
|
||
<subcloud-name>
|
||
|
||
|
||
- To toggle a subcloud between **Unmanaged** and **Managed**, pass these
|
||
parameters to the :command:`subcloud` command.
|
||
|
||
For example:
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud unmanage <subcloud-name>
|
||
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud manage <subcloud-name>
|
||
|
||
|
||
- To reconfigure a subcloud, if deployment fails, use the :command:`subcloud reconfig` command.
|
||
|
||
.. note::
|
||
You can enter the ``sysadmin`` password to avoid being prompted for the password.
|
||
|
||
.. code-block:: none
|
||
|
||
~(keystone_admin)]$ dcmanager subcloud reconfig <subcloud-id/name> --deploy-config \
|
||
<filepath> --sysadmin-password <<password>>
|
||
|
||
|
||
where ``--deploy-config`` must reference the deployment configuration file.
|
||
|
||
.. only:: partner
|
||
|
||
.. include:: /_includes/managing-subclouds-using-the-cli.rest
|
||
:start-after: deploy-config-begin
|
||
:end-before: deploy-config-end
|
||
|
||
.. note::
|
||
|
||
The subcloud can be managed only if the deploy status is 'complete'.
|
||
|
||
Run the following command to manage the subcloud:
|
||
|
||
.. code-block:: none
|
||
|
||
~(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>
|
||
|
||
|
||
.. caution::
|
||
|
||
You must reinstall a deleted subcloud before re-adding it.
|
||
|
||
- To show detailed information about subcloud ``install/bootstrap/deploy``
|
||
failures, use the :command:`subcloud errors <subcloud-name>` command.
|
||
|
||
For example:
|
||
|
||
.. code-block:: none
|
||
|
||
[sysadmin@controller-0 ~(keystone_admin)]$ dcmanager subcloud errors 1
|
||
FAILED bootstrapping playbook of (subcloud1).
|
||
detail: fatal: [subcloud1]: FAILED! => changed=true
|
||
failed_when_result: true
|
||
msg: non-zero return code
|
||
500 Server Error: Internal Server Error ("manifest unknown: manifest unknown")
|
||
Image download failed: admin-2.cumulus.mss.com: 30093/wind-river/cloud-platform-deployment-manager: WRCP_22.06 500 Server Error: Internal Server Error ("Get https://admin-2.cumulus .mss.com: 30093/v2/: dial tcp: lookup admin-2.cumulus.mss.com on 10.41.0.1:53: read udp 10.41.1.3:40251->10.41.0.1:53: i/o timeout")
|
||
Image download failed: gcd.io/kubebuilder/kube-rdac-proxy:v0.11.0 500 Server Error: Internal Server Error ("Get https://gcd.io/v2/: dial tcp: lookup gcd.io on 10.41.0.1:53: read udp 10.41.1.3:52485->10.41.0.1:53: i/o timeout")
|
||
raise Exception("Failed to download images %s" % failed_downloads)
|
||
Exception: Failed to download images ["admin-2.cumulus.mss.com: 30093/wind-river/cloud-platform-deployment-manager: WRCP_22.06", "gcd.io kubebuilder/kube-rdac-proxy:v0.11.0"]
|
||
FAILED TASK: TASK [common/push-docker-images Download images and push to local registry] Wednesday 12 October 2022 12:27:31 +0000 (0:00:00.042)
|
||
0:16:34.495
|