Upgrading Teracloud® Streams Version 7.2.0

Use these procedures to install a Teracloud® Streams Version 7.2 fix pack or interim fix when Version 7.2 is already installed.

If an earlier version is installed, use the procedures in Upgrading to Teracloud Streams Version 7.2 from prior releases.

Teracloud® Streams product updates include a complete version of the product. When you install a Version 7.2 fix pack or interim fix, the installation procedure installs Version 7.2 and all the product updates for that version.

This procedures includes version management and rolling upgrade options. Managed version support enables you to upgrade a domain and its instances independent of each other. Rolling upgrade support enables you to upgrade a domain or instance while it is running. For more information, see Version management and rolling upgrade options.

Before you begin

Ensure that you satisfy the following requirements:

To install a Teracloud® Streams fix pack or interim fix, you must be the installation owner or have root authority. If you are installing the fix as a root user, you must select the same installation owner as the previous version when prompted.
You must complete this procedure on all resources that have the main installation package installed. This package includes all of the product files. Additional resources with the domain host installation package installed are automatically updated. Teracloud® Streams provisions all updates to these additional resources in the domain.
Important: For the upgrade and automatic resource updates to work correctly, you must install the new version in the same root directory as the previous version.

About this task

When you install the fix pack or interim fix in the same root directory as the previous version, Teracloud® Streams creates a new version directory for the installation. The version directory for the previous installation is not removed.

If an X Window System is installed, the default mode for installing a fix pack or interim fix is interactive GUI. Otherwise, the default mode is interactive console.

Procedure

Download the fix pack or interim fix.
Install the fix pack or interim fix on all resources that have the main installation package installed by using one of the following procedures:
If you are using the automated installation method to upgrade Teracloud® Streams, install the fix pack or interim fix on each resource by using a configuration management tool such as Puppet or Chef.
After installing Teracloud® Streams, complete the following steps:
1. Configure the Teracloud® Streams environment variables for the new version by entering the following command:
```
source product-installation-root-directory/product-version/bin/streamsprofile.sh
```
  Note: If you added the source command for the previous version to the .bashrc or /etc/profile.d file, update the version directory in those files.
2. Optional: Set the instance.startAsVersion and domain.determineInstanceStartAsVersion version management properties.
  For more information about these properties, see Version management and rolling upgrade options.
Upgrade the domain by using the standard or rolling upgrade procedure.
- Standard upgrade: If the domain is stopped, you can upgrade the domain by simply starting it with the new version. To start the domain with the new version, you can enter the following command:
```
streamtool startdomain -d domain-id
```
- Rolling upgrade: If the domain is running, enter the following command:
```
streamtool upgradedomain -d domain-id
```
Teracloud® Streams completes the following operations:
1. Provisions all updates to additional resources in the domain that have the domain host installation package installed.
2. Starts the domain controller service.
3. Starts the domain services with the new version.
Instances in the domain continue to run using the installation of the previous version.
Upgrade the instances in the domain by using the standard or rolling upgrade procedure.
You can upgrade the instances immediately after the domain is upgraded or at a later time. If upgraded later, you can either upgrade the instances at the same time or different times, depending on your requirements.
- Standard upgrade: If the instance is stopped, you can upgrade the instance by simply starting it with the new version. To start the instance with the new version, you can use the Streams Console or the following command:
```
streamtool startinstance -d domain-id -i instance-id
```
- Rolling upgrade: If the instance is running, you can use the Streams Console upgrade option for the instance or enter the following command:
```
streamtool upgradeinstance -d domain-id -i instance-id
```
  You can specify multiple instance IDs on this command, or specify the --all option to upgrade all instances iⁿ the domain.
Verify that the installation of the fix pack or interim fix is successful by entering the following commands:
```
streamtool getdomainstate --long
```
If the installation is successful, the fix pack or interim fix version is the active version. In the version column of the command output, an asterisk (*) indicates which version is active.
```
streamtool lsinstance --long
```
If the upgrade is successful, the fix version is listed in the Version column.