docs/doc/source/updates/openstack/apply-update-to-the-openstack-application.rst

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- | armada-manifest | -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 | openstack-armada-manifest | | name | -openstack | | progress | completed | | status | applied | | updated_at | 2020-05-02T17:44:40.152201+00:00 | +---------------+----------------------------------+