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.

Procedure

To list subclouds, use the subcloud list command.

For example:

~(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 subcloud show command.

~(keystone_admin)]$ dcmanager subcloud show <subcloud-name>

For example:

~(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 subcloud show <subcloud-name> --detail command.

For example,

~(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 subcloud update command.

~(keystone_admin)]$ dcmanager subcloud update \
[–- description] <description> \
[– location] <location> \
<subcloud-name>

To toggle a subcloud between Unmanaged and Managed, pass these parameters to the subcloud command.

For example:

~(keystone_admin)]$ dcmanager subcloud unmanage <subcloud-name>

~(keystone_admin)]$ dcmanager subcloud manage <subcloud-name>

To reconfigure a subcloud, if deployment fails, use the subcloud reconfig command.

Note

You can enter the sysadmin password to avoid being prompted for the password.
```
~(keystone_admin)]$ dcmanager subcloud reconfig <subcloud-id/name> --deploy-config \
<filepath> --sysadmin-password <<password>>
```
where --deploy-config must reference the deployment configuration file.

Note

The subcloud can be managed only if the deploy status is ‘complete’.

Run the following command to manage the subcloud:
```
~(keystone_admin)]$ dcmanager subcloud manage <subcloud-id/name>
```
To delete a subcloud, use the subcloud delete command.
```
~(keystone_admin)]$ dcmanager subcloud delete <subcloud-name>
```
Caution

You must reinstall a deleted subcloud before re-adding it.

Manage Subclouds Using the CLI

Manage Subclouds Using the CLI¶

StarlingX