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

Note

In the output you will be able to find the version of all applications you have installed.

<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

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.

Source the environment.

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

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
```
Monitor the status of the application-apply operation until it has completed successfully.
```
~(keystone_admin)$ system application-show stx-openstack
```