Home
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Upgrading Teracloud® Streams
Use these procedures to install a new version of Teracloud® Streams when a previous version of the product is already installed, or to update a Version 7.2 Non-Production Edition license.
Upgrading to Teracloud® Streams Version 7.2 from prior releases
Due to major changes, better security, and a more modern technology stack, you must perform a new product installation.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
- Planning to install Teracloud® Streams
  To plan for installing Teracloud® Streams, start by reviewing the information in the planning roadmap.
- Installing the Teracloud® Streams product
  Use these procedures to install Teracloud® Streams Version 7.2.
- Upgrading Teracloud® Streams
  Use these procedures to install a new version of Teracloud® Streams when a previous version of the product is already installed, or to update a Version 7.2 Non-Production Edition license.
  - Upgrading to Teracloud® Streams Version 7.2 from prior releases
    Due to major changes, better security, and a more modern technology stack, you must perform a new product installation.
  - Version management and rolling upgrade options
    Teracloud® Streams supports managed versions and rolling upgrade.
  - 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.
  - Updating a Version 7.2 Non-Production Edition license
    Use this procedure to update a Teracloud® Streams Version 7.2.0 Non-Production Edition license to the Teracloud Streams Version 7.2.0 product license.
- Uninstalling Teracloud® Streams
  Use this procedure to remove the Teracloud® Streams product from your system.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

Upgrading to Teracloud® Streams Version 7.2 from prior releases

Due to major changes, better security, and a more modern technology stack, you must perform a new product installation.

About this task

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
In this table, the first column lists the file name before Version 7.2. The second column lists the file name beginning in Version 7.2.
File name before Version 7.2	File name in Version 7.2
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.0.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.

Procedure

You must perform a new product installation by using the procedure in Installing the Teracloud Streams product.
Create a Streams domain and instance. See how to set up a Teracloud Streams domain in the Postinstallation roadmap.
Configure your domain and instance properties and application configs.
Update your applications.