Upgrading to Teracloud® Streams Version 7.2.1 from prior releases

Depending on the version of Teracloud® Streams that you are upgrading from, the upgrade procedure might differ.

Upgrading from Version 7.2.0.x

If you are upgrading from Teracloud® Streams Version 7.2.0.x, use the Standard upgrade option described in Version management and rolling upgrade options for Teracloud Streams

Upgrading from Version 7.1.0 or prior

New Streams domains and instances must be created and existing applications must be recompiled.

Additionally, some aspects of the product have changed:

  • Installation file names changes
    Table 1. Installation file name changes in Version 7.2.0
    File name before Version 7.2 File name in Version 7.2.0.x
    IBMStreamsSetup.bin StreamsSetup.bin
    IBMStreamsDomainHostSetup.bin StreamsDomainHostSetup.bin
    IBMStreams_SampleResponseFile.properties Streams_SampleResponseFile.properties
    IBMStreamsSetup.properties StreamsSetup.properties
  • The default installation directory has changed to /opt/teracloud/streams (for root user installation) and $HOME/teracloud/streams (for non-root user installation).
  • The name of the Linux system service has changed from ibm-streams-domain-id to teracloud-streams-domain-id. If the domain ID contains globalization characters, the system service name will be encoded.
  • Toolkit namespaces have changed from com.ibm.streams[x]. to com.teracloud.streams. To help migrate existing applications to the new namespace, see the product-installation-root-directory/7.2.1.0/bin/teracloud-toolkit-migration-tool.sh script.
  • All toolkit major version number have been incremented. If applications depend on specific versions of toolkits, they will need to be updated.
  1. You must perform a new product installation by using the procedure in Installing the Teracloud Streams product.
  2. Create a Streams domain and instance. See how to set up a Teracloud Streams domain in the Postinstallation roadmap.
  3. Configure your domain and instance properties and application configs.
  4. Update your applications.