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.
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.

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.
      - Supported Java™ development kits for application development
        For application development, Teracloud® Streams requires Java™ SDK Version 17 or later to be installed.
      - Configuration settings for Java™ memory issues
        If Java™ out-of-memory errors occur when you use Teracloud® Streams, you can allocate more memory for the Java environment by increasing the maximum JVM size for Teracloud Streams services and user interfaces.
      - Upgrading Java
    - Dependency checker script
      The dependency checker script verifies that your system satisfies the operating system, RPM, and other software requirements for Teracloud® Streams.
  - 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.

Java™ requirements, options, and settings for Teracloud® Streams

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.

Note:

Java SDK 17 or later must be installed before running Teracloud® Streams.

You are recommended to install OpenJDK via RPM. Then, use alternatives to set the current active Java. Alternatives sets up a symlink to the latest (current) active java: /etc/alternatives/java_sdk. To make it easier to upgrade to a newer version of Java™, use a symlink for the Java location.

Teracloud® Streams is using a new environment variable STREAMS_JAVA_HOME for identifying the Java location on your system. This variable can be set automatically by the Streams profile script or specified explicitly before running the script. If you set this environment variable manually, you are recommended to set it to a symlink that does not contain the Java version. This will make it easier to upgrade to a newer version of Java.

Installing OpenJDK 17 and updating alternatives

To install OpenJDK as an RPM (recommended), run the following command with root privileges:

dnf install java-17-openjdk-devel

To set the default version for java and javac, you must update the javac alternative. It is also recommended to update the java alternative as well. To do so, use the following commands:

update-alternatives --config 'javac'
update-alternatives --config 'java'

Setting alternatives to designate active java (without OpenJDK)

If you are not using OpenJDK, it is recommended to use alternatives to designate active java. Otherwise, you must explicitly set the STREAMS_JAVA_HOME environment variable. It is recommended to set it to a symlink to make upgrading Java to a newer version easier.

Run the following command to verify that javac is set correctly:

$ javac -version
javac 17.0.11