docs/doc/source/dist_cloud/kubernetes/configuration-for-specific-subclouds.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8)
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

6.0 KiB

Configuration for Specific Subclouds

To determine how upgrades are applied to the nodes on each subcloud, the upgrade strategy refers to separate configuration settings.

The following settings are applied by default:

  • storage apply type: parallel
  • worker apply type: parallel
  • max parallel workers: 10
  • alarm restriction type: relaxed
  • default instance action: migrate (This parameter is only applicable to hosted application with the -openstack application.)

To update the default values, use the dcmanager strategy-config update command. You can also use this command to configure custom behavior for individual subclouds.

  • To list the default upgrade strategy and any custom configurations configured for individual subclouds, use the strategy-config list command.

    For example:

    ~(keystone_admin)]$ dcmanager strategy-config list
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
    | cloud              | storage apply type | worker apply type  | max parallel workers  | alarm restriction type | default instance |
    |                    |                    |                    |                       |                        | action           |
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
    | all clouds default | parallel           | parallel           |                    10 | relaxed                | migrate          |
    | subcloud-6         | parallel           | parallel           |                     2 | relaxed                | stop-start       |
    +--------------------+--------------------+--------------------+-----------------------+------------------------+------------------+
  • To show the configuration settings applicable to all subclouds by default, use the strategy-config show command.

    ~(keystone_admin)]$ dcmanager strategy-config show
    +-------------------------+--------------------+
    | Field                   | Value              |
    +-------------------------+--------------------+
    | cloud                   | all clouds default |
    | storage apply type      | parallel           |
    | worker apply type       | parallel           |
    | max parallel workers    | 10                 |
    | alarm restriction type  | relaxed            |
    | default instance action | migrate            |
    | created_at              | None               |
    | updated_at              | None               |
    +-------------------------+--------------------+
  • To update the settings, or to create a custom configuration for a subcloud, use the strategy-config update command.

    ~(keystone_admin)]$ dcmanager strategy-config update \
     \
    --storage-apply-type <type> \
    --worker-apply-type <type> \
    --max-parallel-workers <i> \
    --alarm-restriction-type <level> \
    --default-instance-action <action> \
    [<subcloud_name>]

    where

    storage apply type

    parallel or serial — determines whether storage nodes are upgraded in parallel or serially.

    worker apply type

    parallel or serial — determines whether worker nodes are upgraded in parallel or serially.

    max parallel workers

    Set the maximum number of worker nodes that can be upgraded in parallel.

    alarm restriction type

    relaxed or strict — determines whether the orchestration is aborted for alarms that are not management-affecting. For more information, refer to the

default instance action

Note

This parameter is only applicable to hosted application with the -openstack application.

migrate or stop-start — determines whether hosted application are migrated or stopped and restarted when a worker host is upgraded

subcloud_name

The name of the subcloud to use the custom strategy. If this omitted, the default upgrade strategy is updated.

Note

You must specify all of the settings.

  • To show the configuration settings for a subcloud, use the strategy-config show <subcloud> command.

    ~(keystone_admin)]$ dcmanager strategy-config show [<name>]

    For example:

    ~(keystone_admin)]$ dcmanager strategy-config show subcloud-6
    +-------------------------+----------------------------+
    | Field                   | Value                      |
    +-------------------------+----------------------------+
    | cloud                   | subcloud-6                 |
    | storage apply type      | parallel                   |
    | worker apply type       | parallel                   |
    | max parallel workers    | 2                          |
    | alarm restriction type  | relaxed                    |
    | default instance action | stop-start                 |
    | created_at              | 2020-03-12 20:08:48.917866 |
    | updated_at              | None                       |
    +-------------------------+----------------------------+

    If custom configuration settings have not been created for the subcloud, the following message is displayed:

    ERROR (app) No options found for Subcloud with id 1, defaults will be
    used.