75b4f9f0b4
Since armada (deprecated) is being replaced by FluxCD in the stx-openstack application [1], it is needed to also replace the mentions of Armada in the stx-openstack related docs to FluxCD. [1] - https://review.opendev.org/c/starlingx/openstack-armada-app/+/862516 Signed-off-by: Rafael Falcao <rafael.vieirafalcao@windriver.com> Change-Id: I0b2959630c970b51979db5eaefa81d59db477125
114 lines
4.7 KiB
ReStructuredText
114 lines
4.7 KiB
ReStructuredText
|
|
.. uqi1590003050708
|
|
.. _apply-update-to-the-openstack-application:
|
|
|
|
=========================================
|
|
Apply Update to the OpenStack Application
|
|
=========================================
|
|
|
|
|prod-os| is managed using the StarlingX Application Package Manager.
|
|
|
|
.. rubric:: |context|
|
|
|
|
Use the StarlingX Application Package Manager :command:`application-update`
|
|
command to perform an update.
|
|
|
|
.. code-block:: none
|
|
|
|
~(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
|
|
:command:`application-list` command:
|
|
|
|
.. parsed-literal::
|
|
|
|
~(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 |
|
|
| |prefix|-openstack |s| | 21.07-0- | stx-openstack-fluxcd-manifests| |prefix|-openstack.yaml |s| | applied | completed |
|
|
| | centos- | | | | |
|
|
| | stable- | | | | |
|
|
| | versioned | | | | |
|
|
+--------------------------+-----------+-------------------------------+---------------------------+----------+-----------+
|
|
|
|
The output indicates that the currently installed version of
|
|
|prefix|-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 |prod-dc| configuration the System Controllers should be
|
|
upgraded before the subclouds.
|
|
|
|
.. rubric:: |proc|
|
|
|
|
|
|
.. _apply-update-to-the-openstack-application-steps-inn-llt-kmb:
|
|
|
|
#. Retrieve the latest |prod-os| application tarball,
|
|
|prefix|-openstack-<major>.<minor>-patch.tgz, from |dnload-loc|.
|
|
|
|
.. 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.
|
|
|
|
.. code-block:: none
|
|
|
|
$ source /etc/platform/openrc
|
|
~(keystone_admin)$
|
|
|
|
#. Update the application.
|
|
|
|
This will upload the software version and automatically apply it to the
|
|
system.
|
|
|
|
For example:
|
|
|
|
.. parsed-literal::
|
|
|
|
~(keystone_admin)$ system application-update |prefix|-openstack-21.07-0.tgz
|
|
|
|
#. Monitor the status of the application-apply operation until it has
|
|
completed successfully.
|
|
|
|
.. parsed-literal::
|
|
|
|
~(keystone_admin)$ system application-show |prefix|-openstack
|
|
+---------------+----------------------------------+
|
|
| Property | Value |
|
|
+---------------+----------------------------------+
|
|
| active | True |
|
|
| app_version | 21.07-0 |
|
|
| created_at | 2020-05-02T17:11:48.718963+00:00 |
|
|
| manifest_file | |prefix|-openstack.yaml |s| |
|
|
| manifest_name | stx-openstack-fluxcd-manifests |
|
|
| name | |prefix|-openstack |s| |
|
|
| progress | completed |
|
|
| status | applied |
|
|
| updated_at | 2020-05-02T17:44:40.152201+00:00 |
|
|
+---------------+----------------------------------+
|
|
|