starlingx/docs
Code Issues Proposed changes
2b2cc0b045
docs/doc/source/dist_cloud/kubernetes/failure-during-the-installation-or-data-migration-of-n-plus-1-load-on-a-subcloud.rst
Ron Stone 39e3de7291 Fix variable markup (r6,r7,r8,dsR7,dsR8) 
Documentation imported from XML incorrectly wrapped variable names in double
braces such as <<varname>>, instead of <varname>. This review corrects these
instances.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I70cb7e4030a92b3bc83c7b01a6f4135f9cb0e5ad
2023-03-14 14:34:44 +00:00

2.8 KiB
Raw Blame History

Failure During the Installation or Data Migration of N+1 Load on a Subcloud

You may encounter some errors during Installation or Data migration of the N+1 load on a subcloud. This section explains the errors and the steps required to fix these errors.

Errors can occur due to one of the following:

  • One or more invalid install values
  • A network error that results in the subcloud being temporarily unreachable

Failure Caused by Install Values

If the subcloud install values contain an incorrect value, use the following command to fix it.

~(keystone_admin)]$ dcmanager subcloud update <subcloud-name> --install-values <subcloud-install-values-yaml>

This type of failure is recoverable and you can retry the orchestrated upgrade for each of the failed subclouds using the following procedure:

  1. Delete the failed upgrade strategy.

    ~(keystone_admin)]$ dcmanager upgrade-strategy delete

  2. Create a new upgrade strategy for the failed subcloud.

    ~(keystone_admin)]$ dcmanager upgrade-strategy create <subcloud-name> --force <additional options>

    Note

    If the upgrade failed during the -SX upgrade or data migration, the subcloud availability status is displayed as 'offline'. Use the --force option when creating the new strategy.

  3. Apply the new upgrade strategy.

    ~(keystone_admin)]$ dcmanager upgrade-strategy apply

  4. Verify the upgrade strategy status.

    ~(keystone_admin)]$ dcmanager strategy-step list

Failure Post Data Migration on a Subcloud

Once the data migration on the subcloud is completed, the upgrade is activated and finalized. If failure occurs:

  • Check specified log files
  • Follow the recovery procedure. See failure-prior-to-the-installation-of-n-plus-1-load-on-a-subcloud

partner