Home
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.
Software requirements
Before you install Teracloud® Streams, run the dependency checker script to verify that the target system satisfies the product software requirements.
Dependency checker script
The dependency checker script verifies that your system satisfies the operating system, RPM, and other software requirements for Teracloud® Streams.
Running the dependency checker script
Run the dependency checker script before or after you install Teracloud® Streams to ensure that your system meets the product requirements. In an environment that includes multiple resources, run this script on all resources and correct any incompatibilities before you use Teracloud Streams.

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.
  - Preparing to install Teracloud® Streams
    Use the information in this topic to plan and prepare for your Teracloud® Streams installation. The plan that you create for your environment determines your tasks and choices throughout the installation process.
  - Considerations for environments with multiple resources
    Review these options and requirements for Teracloud® Streams environments before you install the product.
  - Hardware requirements
    Before you install Teracloud® Streams, ensure that the target system satisfies the minimum hardware requirements.
  - Software requirements
    Before you install Teracloud® Streams, run the dependency checker script to verify that the target system satisfies the product software requirements.
    - Operating system requirements for Teracloud® Streams
      Teracloud® Streams supports Red Hat Enterprise Linux™ (RHEL).
    - Required RPMs for Teracloud® Streams
      To operate correctly, Teracloud® Streams requires a set of prerequisite RPMs.
    - Java requirements, options, and settings
      Ensure that you use a Java™ development kit that is supported by Teracloud® Streams. If Java memory issues occur, Teracloud Streams provides configuration properties that you can use to allocate more memory for the Java environment.
    - Dependency checker script
      The dependency checker script verifies that your system satisfies the operating system, RPM, and other software requirements for Teracloud® Streams.
      - Running the dependency checker script
        Run the dependency checker script before or after you install Teracloud® Streams to ensure that your system meets the product requirements. In an environment that includes multiple resources, run this script on all resources and correct any incompatibilities before you use Teracloud Streams.
      - Example: x86_64 system running RHEL 9.4
      - Example: Dependency checker script output example for an x86_64 system running RHEL 8.10
  - Domain controller service options
    A domain controller service runs on every resource in a Teracloud® Streams domain and manages all of the other services on that resource. You can set up the domain controller service as a registered Linux™ system service or an unregistered service.
  - Firewall configuration guidelines
    If firewall usage is required, the preferred configuration is to set up a firewall at the perimeter of the Teracloud® Streams cluster to restrict network access to resources in the cluster but not communication between the resources. When any communication passes through a firewall, latency is introduced. These guidelines apply to clients that are in the Teracloud Streams cluster as well as clients that are external to the cluster.
  - Linux ulimit configuration guidelines
    The default Linux™ user limit (ulimit) values might be too small for some Teracloud® Streams environments. Use these guidelines to ensure that your ulimit settings are sufficient for Teracloud Streams.
  - Name resolution requirements for resources
    All resources must satisfy the product network configuration requirements or Teracloud® Streams fails to start on the resource.
- 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.
- 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.

Running the Teracloud® Streams dependency checker script

Run the dependency checker script before or after you install Teracloud® Streams to ensure that your system meets the product requirements. In an environment that includes multiple resources, run this script on all resources and correct any incompatibilities before you use Teracloud® Streams.

Before you begin

The script must be run by the installation owner.

The dependency checker script requires Java 8 or later to run. It will validate Java for running the Teracloud® Streams for the user that runs the dependency_checker.sh script.

This script will report an error if the following requirements are not met:

Java must be an SDK (i.e. javac must be found).
The Java version must be 17 or later.

To find Java, the script uses the following search order:

STREAMS_JAVA_HOME
JAVA_HOME
Alternatives - (/etc/alternatives/java_sdk)

Procedure

To run the dependency checker script before installing Teracloud® Streams:
1. If you have not extracted the contents of the product installation package, enter the following command:
```
  tar -zxvf product-installation-package-name.tar.gz
```
  The tar command creates the StreamsInstallFiles directory, that contains the self-extracting binary file (StreamsSetup.bin) and other installation files.
2. Change to the Teracloud® Streams installation files directory:
```
  cd product-installation-package-directory/StreamsInstallFiles
```
3. To run the dependency checker script, enter the following command:
```
    ./dependency_checker.sh
```
To run the dependency checker script after installingTeracloud® Streams, enter the following commands:
```
  cd product-installation-root-directory/7.2.0.0/bin
  ./dependency_checker.sh
```
The following command options are optional:

-v level

Verbose option that displays additional messages. Possible values for level are:

1

Includes additional informational messages.

2

Includes additional debug messages.

-h

Display the help information.