To upgrade a Heat orchestration engine that you extended, rerun the script that extends
the engine.
- Root access is required for installation.
- The operating system must be configured with required packages and
dependencies before you install the engine. The system might need network access to install these
packages. Make sure that the system is connected to a package manager, such as a Yum server.
- If the
akonadi
package is installed, remove
it:yum remove -y akonadi
- Determine whether the program
qpid
is installed on the system.
- If the program
qpid
is running on the system, stop its service.
These steps are for upgrading Heat orchestration engines that you extended as described in
Extending an existing OpenStack engine or for upgrading Heat engines that you
installed with IBM® UrbanCode® Deploy version 6.2.1.1 or later. For other Heat engines, use the instructions in Upgrading engines that you installed with IBM UrbanCode Deploy.
-
Check the current version of the custom types in the engine.
You need to know the current version of the types so you will know if the upgrade was
successful. To check the current version, log in to the system that hosts the engine and run the
following command:
pip list | grep ibm-cloud-ext
Then, find the version of the
ibm-cloud-ext
package in the output of the command.
For example, assume that the output looks like the following
code:
ibm-cloud-ext (6.2.1.dev70)
In this example, the version of the custom
types is
(6.2.1.dev70)
.
-
Download and extract the installation files for the engine.
-
Change to the ibm-ucd-patterns-install/engine-install/ directory.
-
From the command line, run the ./upgrade-standalone-ucd-heat-engine.sh
command to upgrade the IBM UrbanCode Deploy plug-in.
-
The installer asks if you have satisfied the dependencies. If you configured the system with
the prerequisites for the engine, press
Y
.
-
Read the license agreements for the software package. Press Space to show one page at a time,
or press
F
to show the entire license.
-
If you agree to the terms of all of the license agreements, press
Y
, and then
press Enter.
-
Restart the engine and the Heat API.
See the documentation for your cloud system.
-
Run the following command and verify that the version of the
ibm-cloud-ext
package has been updated:
pip list | grep ibm-cloud-ext