Home
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Known problems and solutions
Use the solutions that are provided to resolve known problems that you might encounter when you work with different components of the product.
Teracloud® Streams problems and solutions
Use the solutions that are provided to resolve the problems that you can encounter when you work with Teracloud® Streams.
Teracloud® Streams runtime
Use the solutions that are provided to resolve the problems encountered during the Teracloud® Streams runtime processes.
Java out-of-memory error
When you use streamtool commands, you can encounter a Java™ out-of-memory error if the command calls the java command with insufficient memory allocation settings.

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.
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.
- Before contacting Teracloud® Support
  Review this information before you contact Teracloud® Support. These resources might help you to find possible solutions for your issue, or make your support experience more efficient if you need to contact Teracloud Support.
- Troubleshooting techniques
  Troubleshooting is a systematic approach to solving a problem. The goal of troubleshooting is to determine why something does not work as you expect it to work, and then decide how to resolve the problem.
- Known problems and solutions
  Use the solutions that are provided to resolve known problems that you might encounter when you work with different components of the product.
  - Teracloud® Streams problems and solutions
    Use the solutions that are provided to resolve the problems that you can encounter when you work with Teracloud® Streams.
    - Authentication
      Use the solutions that are provided to resolve problems with Teracloud® Streams authentication.
    - Connectivity
      Use the solutions that are provided to resolve connectivity problems with the product.
    - Domain configuration and administration
      Use the solutions that are provided to resolve the problems that can occur when you work with Teracloud® Streams domains.
    - Installation
      Use the solutions that are provided to resolve the problems that you can encounter when you install Teracloud® Streams.
    - Instance configuration and administration
      Use the solutions that are provided to resolve the problems that can occur when you work with Teracloud® Streams instances.
    - Streams Console
      Use the solutions that are provided to resolve the problems that you might encounter when you work with Streams Console.
    - Stream applications
      Use these solutions to resolve the problems that you might encounter when you develop stream applications.
    - Teracloud® Streams runtime
      Use the solutions that are provided to resolve the problems encountered during the Teracloud® Streams runtime processes.
      - Common run time problems
        The common run time problems include difficulties with starting an instance, adding a resource, and accessing the services.
      - Java out-of-memory error
        When you use streamtool commands, you can encounter a Java™ out-of-memory error if the command calls the java command with insufficient memory allocation settings.
      - The streamtool commands always prompt for a password
        To avoid being prompted for your password when you enter a streamtool command, you can run the streamtool genkey command.
  - Toolkit problems and solutions
    Use the solutions that are provided to resolve the problems that you can encounter when you work with toolkits in Teracloud® Streams.
  - ZooKeeper problems and solutions
    Use these solutions to resolve the problems that you might encounter with Apache ZooKeeper.
- Troubleshooting services and diagnostic tools
  Teracloud® Streams provides log and trace services and troubleshooting tools that can help you resolve the issues that you encounter when you work with the product.
- Teracloud® Streams messages
  The Teracloud® Streams messages describe the errors and solutions, warnings of potentially problematic conditions, and helpful information that you can use to troubleshoot the problems that can occur when you work with the product. These messages are displayed in the user interfaces and log files.
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™ out-of-memory error when using streamtool commands

When you use streamtool commands, you can encounter a Java™ out-of-memory error if the command calls the java command with insufficient memory allocation settings.

You encounter a Java™ out-of-memory error message, for example:

JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError"
...
Exception in thread "P=627353:O=0:CT" java.lang.OutOfMemoryError: Java heap space

The streamtool command fails if there is not sufficient memory in the Java™ heap.

Increase the maximum amount of memory that can be allocated to the Java™ environment by the streamtool commands. You can set this value by using the STREAMTOOL_MAX_JVM_SIZE environment variable, for example:

export STREAMTOOL_MAX_JVM_SIZE=size

Notes:

The size that you specify cannot exceed the amount of memory that is available on the resource where you run streamtool commands. For a size of 256 megabytes, specify 256m. For a size of 1 gigabyte, specify 1g.
If the STREAMTOOL_MAX_JVM_SIZE environment variable is not set, Teracloud® Streams selects a maximum JVM size based on the system default size.