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.

Procedure

Check the known problems and solutions for possible solutions to your issue.
If you need to contact Teracloud® Support, there is some information that you can gather to assist Teracloud® Support in resolving problems with Teracloud® Streams. You can speed up your support experience by having this information ready before you contact Teracloud® support.
1. For issues running streamtool commands, rerun the command with --trace trace and save the output.
2. For ZooKeeper issues:
  1. Collect the zoo.cfg file, located under zookeeper-installation-directory/conf
  2. For each node in the zookeeper quorum, collect all files under the configured zookeeper log directory:
    1. By default, this will be zookeeper-installation-directory/logs
    2. Otherwise, the location can be found using the $ZOO_LOG_DIR environment variable or zookeeper.log.dir in the zoo.cfg file.
3. For host issues:
  1. For individual hosts, run the following command on the host:
```
streamsVersionInstallationDirectory/bin/dependency_checker.sh
```
  2. To check hosts in an instance, run the following commands:
```
source streamsVersionInstallationDirectory/bin/streamsprofile.sh
streamtool checkinstancehosts -v 3
```
  3. To check hosts in a domain, run the following commands:
```
source streamsVersionInstallationDirectory/bin/streamsprofile.sh
streamtool checkdomainhosts -v 3
```
4. For general Streams runtime issues, run the following commands and collect their output files:
```
source streamsVersionInstallationDirectory/bin/streamsprofile.sh
streamtool getlog --includeapps -d streamsDomain -i streamsInstance ¹
streamtool getdomainstate --long -d streamsDomain > domainState.txt
streamtool getresourcestate --long -d streamsDomain -i streamsInstance > instanceState.txt
streamtool lsjobs -d streamsDomain -i streamsInstance > lsjobs.txt
streamtool lspes -d streamsDomain -i streamsInstance > lspes.txt
streamtool getzkstate > getzkstate.txt
```

¹ See StreamsLogs.tgz for output.