starlingx/docs
Code Issues Proposed changes
47040fa69b
docs/doc/source/updates/openstack/apply-update-to-the-openstack-application.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

4.7 KiB
Raw Blame History

Apply Update to the OpenStack Application

is managed using the StarlingX Application Package Manager.

Use the StarlingX Application Package Manager application-update command to perform an update.

~(keystone_admin)$ system application-update [-n | --app-name] <app_name>
[-v | --app-version] <version> <tar_file>

where the following are optional arguments:

<app_name>

The name of the application to update.

You can look up the name of an application using the application-list command:

~(keystone_admin)$ system application-list +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+ | application | version | manifest name | manifest file | status | progress | +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+ | cert-manager | 20.06-5 | cert-manager-manifest | certmanager-manifest.yaml | applied | completed | | nginx-ingress-controller | 20.06-0 | nginx-ingress-controller- | nginx_ingress_controller | applied | completed | | | | -manifest | _manifest.yaml | | | | oidc-auth-apps | 20.06-28 | oidc-auth-manifest | manifest.yaml | uploaded | completed | | platform-integ-apps | 20.06-11 | platform-integration-manifest | manifest.yaml | applied | completed | | -openstack | 21.07-0- | stx-openstack-fluxcd-manifests| -openstack.yaml | applied | completed | | | centos- | | | | | | | stable- | | | | | | | versioned | | | | | +--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+

The output indicates that the currently installed version of -openstack is 21.07-0.

<version>

The version to update the application to.

and the following is a positional argument which must come last:

<tar_file>

The tar file containing the application manifest, Helm charts and configuration file.

Note

In a configuration the System Controllers should be upgraded before the subclouds.

  1. Retrieve the latest application tarball, -openstack-<major>.<minor>-patch.tgz, from .

    Note

    The major-minor version is based on the current product release version. The patch version will change within the release based on incremental updates.

  2. Source the environment.

    $ source /etc/platform/openrc
~(keystone_admin)$

  3. Update the application.

    This will upload the software version and automatically apply it to the system.

    For example:

    ~(keystone_admin)$ system application-update -openstack-21.07-0.tgz

  4. Monitor the status of the application-apply operation until it has completed successfully.

    ~(keystone_admin)$ system application-show -openstack +---------------+----------------------------------+ | Property | Value | +---------------+----------------------------------+ | active | True | | app_version | 21.07-0 | | created_at | 2020-05-02T17:11:48.718963+00:00 | | manifest_file | -openstack.yaml | | manifest_name | stx-openstack-fluxcd-manifests | | name | -openstack | | progress | completed | | status | applied | | updated_at | 2020-05-02T17:44:40.152201+00:00 | +---------------+----------------------------------+