Apply Update to the OpenStack ApplicationΒΆ

StarlingX OpenStack is managed using the StarlingX Application Package Manager.

About this task

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 |
| stx-openstack            | 21.07-0-  | stx-openstack-fluxcd-manifests| stx-openstack.yaml        | applied  | completed |
|                          | centos-   |                               |                           |          |           |
|                          | stable-   |                               |                           |          |           |
|                          | versioned |                               |                           |          |           |
+--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+

The output indicates that the currently installed version of
stx-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 Distributed Cloud configuration the System Controllers should be upgraded before the subclouds.

Procedure

  1. Retrieve the latest StarlingX OpenStack application tarball, stx-openstack-<major>.<minor>-patch.tgz, from a StarlingX mirror.

    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 stx-openstack-21.07-0.tgz
  4. Monitor the status of the application-apply operation until it has completed successfully.

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