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.
Streams Console
Use the solutions that are provided to resolve the problems that you might encounter when you work with Streams Console.
Java out-of-memory error
When you use the Streams Console, you might encounter a Java™ out-of-memory error if the amount of memory that is allocated to the web management service is not sufficient.

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
Learn about different Teracloud Streams tools and features to write, compile, run, and test streams applications.
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.
      - Java out-of-memory error
        When you use the Streams Console, you might encounter a Java™ out-of-memory error if the amount of memory that is allocated to the web management service is not sufficient.
      - Problem logging in to the Streams Console when using a domain or instance that is shared by multiple users
        By default, Teracloud® Streams domains and instances are private and can be accessed only by the user who creates the domain or instance. If you have problems logging in to the Streams Console, your security configuration might not satisfy the requirements for accessing the domain or instance.
    - 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.
  - 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 for the Streams Console

When you use the Streams Console, you might encounter a Java™ out-of-memory error if the amount of memory that is allocated to the web management service is not sufficient.

You might encounter one of the following Java™ error messages:

OutOfMemoryError

or

Failed to load data!

The amount of memory that is allocated to the web management service is not sufficient.

Increase the amount of memory that can be allocated to the Java™ environment for the web management service by updating the following domain properties:
- sws.initialJvmSize
- sws.maximumJvmSize
For more information about these properties, enter streamtool man domainproperties.
To view the current property settings, use the streamtool getdomainproperty command, for example:
```
streamtool getdomainproperty -d domain-id sws.initialJvmSize sws.maximumJvmSize
```
To update the property settings, use the streamtool setdomainproperty command, for example:
```
streamtool setdomainproperty -d domain-id sws.initialJvmSize=size sws.maximumJvmSize=size
```
You must specify the new size in megabytes (Mb). This value cannot exceed the amount of memory that is available on the resource where the web management service is running. Valid values are 64-65536 Mb.
Warning: If you specify a value that exceeds the amount of memory that is available, the web management service cannot start and the domain might fail to start.

Stop and restart the domain. For example, run the commands:

streamtool stopdomain -d domain-id
streamtool startdomain -d domain-id