docs/doc/source/dist_cloud/managing-subclouds-using-the-cli.rst

Manage Subclouds Using the CLI

You can use the to list subclouds, reconfigure subclouds if deployment fails, delete subclouds, and monitor or change the managed status of subclouds.

• 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. For more information, see either,

• 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.