docs/doc/source/updates/openstack/apply-update-to-the-stx-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 | 20.10-0- | armada-manifest | -openstack.yaml | applied | completed | | | centos- | | | | | | | stable- | | | | | | | versioned| | | | | +--------------------------+----------+-------------------------------+---------------------------+----------+-----------+

The output indicates that the currently installed version of -openstack is 20.10-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 upgrade 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 |prefix|-openstack-20.10-1.tgz

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

   ~(keystone_admin)$ system application-show |prefix|-openstack
   +---------------+----------------------------------+
   | Property      | Value                            |
   +---------------+----------------------------------+
   | active        | True                             |
   | app_version   | 20.06-1                          |
   | created_at    | 2020-05-02T17:11:48.718963+00:00 |
   | manifest_file | |prefix|-openstack.yaml |s|              |
   | manifest_name | openstack-armada-manifest        |
   | name          | |prefix|-openstack |s|                   |
   | progress      | completed                        |
   | status        | applied                          |
   | updated_at    | 2020-05-02T17:44:40.152201+00:00 |
   +---------------+----------------------------------+