Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
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.
These messages describe the conditions and problems that can occur during the product installation, a reinstallation of the product, the migration to a different version of the product, and the uninstallation process.
The host setup completed successfully.
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
streamtool
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
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 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.
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 provides log and trace services and troubleshooting tools that can help you resolve the issues that you encounter when you work with the product.
Each log message has a unique message ID. The naming convention for each Teracloud® Streams message ID is CDISXNNNNT.
These messages describe the conditions and problems that can occur when you work with Streams Console.
These messages describe the conditions and problems that can occur when you work with the streamtool commands.
The dependency checker evaluated the system and found error_count errors.
The software dependency rules are not defined for the target system.
The dependency checker evaluated the system and did not find errors or warnings.
The dependency checker evaluated the system and found error_count errors and warning_count warnings.
The dependency checker evaluated the system and found warning_count warnings.
The system_service_name system service already exists for the domain_id domain.
The system_service_name system service for the domain_id domain is defined to use the following installation: installation-directory.
Installing the product in the following directory: installation_directory...
Registering the local host with the following domain: domain_id...
The host setup completed with warnings.
Uninstalling the product using console mode because an uninstallation mode was not specified.
The uninstallation was cancelled by the following user: user_id.
The user_id user can remove the contents of the installation_directory directory but does not have permission to remove the directory.
The uninstallation program completed with return_code return code.
The following option is not supported and will be ignored: option.
The installation directory is located on a shared file system.
The uninstallation program will attempt to remove the following directory and all of its contents: directory.
The uninstallation program will not remove the global files and directories that are used by this version because they are used by other installed versions.
The uninstallation program will not attempt to remove the directory directory because other versions or other files and directories exist.
Starting the controller service as an unregistered service for the following domain: domain_id...
The following command was canceled: specified_command.
The operation was completed.
The user did not have sufficient privileges to run the check.
The check cannot be run because the following system command was not found: command.
The install_package_version installation image that you are trying to install is not supported on your target_operating_system operating system version.
Your target_operating_system target_operating_system_version operating system is not supported by the product. The installation package supports operating_system operating_system_version.
The install_image_architecture architecture of the installation image does not match the target_system_architecture architecture of your system.
The character_encoding character encoding of your locale configuration is not supported by the product.
The installation process might not be able to reach the hostname host.
The IP address of the host is not associated with a local network interface. The hostname host resolved to the following IP address: IP_address.
The installation log file was not copied from the source_directory directory to the target_directory directory.
Your target_system operating system and target_system_architecture architecture are not supported by the product.
No network interfaces were detected on the host.
The upgrade program cannot remove all the files for the current installation.
The hostname host name did not resolve to an IPV4 address. The host name resolved to IP_address.
IBM Java ibm_java_version is not installed.
The install_image_architecture architecture of the installation image does not match the target_system_architecture architecture of the system.
The root user cannot change the owner of the deployed files to the install_owner user and the install_owner_group group.
The hostname host name is not known to the system name resolver.
The system cannot determine whether the installer is the root user.
An error occurred during the uninstallation of the existing version of the product. The error is: error
Certain required software is not installed, or certain required software that is installed is not the required version. However, the installation process continued.
An error occurred when the owner of the deployed file was changed. The error is: error
The character encoding of the system cannot be determined. The product requires the character_encoding character encoding.
The product does not support the character_encoding character encoding of your locale configuration.
Software dependency checking might not be accurate for your environment.
The hostname host name is not valid or resolves to a loopback address.
Your target_system system is not supported by the install_image_target installation image.
Software dependencies are not installed or are not at the correct version.
The Streams Domain Manager cannot be opened.
The process might not have finished. The warning is: error.
Some of the current installation files might not be removed during the requested process.
The system soft limit for the maximum number of processes is low: maximum_processes.
The system soft limit for the open files is low: open_files.
The system hard limit for the maximum number of processes is low: maximum_processes.
The system hard limit for the open files is low: open_files.
The product was installed with warnings that are logged in the installation summary log in the following directory: summary_log_directory.
The trace log file for the product uninstallation cannot be created because of the following error: additional_message
The uninstallation program could not remove the following file or directory; file_or_directory.
The DNS lookup by IP address failed. The hostname host name resolves to the following IP address: IP_address.
The DNS lookup by IP address resolves to the wrong host name. The hostname host name resolves to IP_address IP address, but the DNS lookup by IP address resolves to the following host name: incorrect_hostname.
The round trip DNS lookup does not resolve correctly. The hostname host name resolves to the IP_address IP address using DNS. The DNS lookup of the IP address resolves to the incorrect_hostname host name; but the DNS lookup of the host name resolves to the following IP address: incorrect_IP_address.
The IP address does not resolve to the correct host name. The hostname host name resolved to the IP_address IP address, but that IP address resolves to the following host name incorrect_hostname.
The full name resolution of the host name does not resolve the to the correct IP address. The hostname host name resolved to the IP_address IP address using DNS, but the full name resolution for that host name resolves to the following IP addresses: list_of_IP_addresses.
The IP address does not resolve to the correct host name. The hostname host name resolved to the IP_address IP address, but the DNS lookup resolves to the following host name: DNS_hostname.
The hostname host name resolved to the IP_address IP address, but the DNS lookup failed.
An unexpected exception was detected while performing name resolution checking. The exception error message is: error_message
You may be running a firewall which may prevent communication between the cluster hosts.
During the product installation, embedded ZooKeeper was upgraded in the following directory: installation_directory. This directory is located in a shared file system, and the installation program cannot detect if embedded ZooKeeper is in use.
The hostname host name did not resolve to an IP address using DNS lookup.
The installed version installed_version of the software dependency exceeds the maximum_version maximum version that is supported by the product.
IBM Java java_version is not installed.
The hostname host name was resolved to an IPV6 address, which is not supported by the product.
The system name resolver does not recognize the hostname host name.
The software_dependency software dependency does not meet the required version of required_version.
The parameter is not valid. Use help_parameter to see the valid parameters.
The install_package_information installation image is not supported by your target_operating_system operating system.
The software_dependency_name software dependency is not installed. A minimum version of minimum_version is required.
The version of the software_dependency software dependency is below the minimum required version of minimum_version. The maximum version that is supported is maximum_version.
An IP address, which is required for name resolution, could not be detected for the host.
The host resolved the hostname hostname to the IP_address IP address, which is not associated with the local network interfaces.
The version of the software_dependency software dependency exceeds the maximum supported version of maximum_version. The minimum required version is minimum_version.
The argument is not valid because verbose_parameter must be followed by valid level of the verbose parameter.
The install_package_architecture architecture of the installation image does not match the target_operating_system_architecture architecture of your system.
The version of the software_dependency software dependency is below the minimum required version of minimum_version.
Your target_system operating system is not supported by this installation image. This image supports the build_target operating system.
You cannot install the prior version of product_name product_version over existing_product_name existing_product_version in the existing_installation_directory directory.
An error occurred when the software dependencies were checked.
The global configuration was not set up.
The owner of the file must be specified.
The path to the installation directory must be an absolute path. A relative path is specified.
You cannot install Streams version previous_version, which is a prior version, over the later version newer_version.
The installation was cancelled because software dependencies are missing. The response file specifies that the installation be cancelled.
The silent installation stopped because you are not the root user or the LICENSE_ACCEPTED property in the response file is set to "false."
An error occurred when the command command was run.
An error occurred when the installation software was extracted.
The product cannot be upgraded. The user must be the installation owner or the root user.
The owner_group owner group does not exist. Before the product can be installed, the specified owner group must exist.
The installation_directory directory is not a valid installation directory.
An IO error occurred when the product version was validated. The error is: error_detected
The installation was cancelled because version version of the product is already installed in the install_directory directory. The response file specifies that the installation be cancelled when a later version is already installed in the installation directory.
You do not have the required permissions for the install_directory installation directory.
The owner group of the installation files must be specified.
The owner installation owner does not exist. An existing user must be specified.
An error occurred when the system configuration was checked. The error is: error
You are not the root user or the owner of the installed files.
The root user cannot be the owner of the deployed files.
An error occurred. The function that was in progress might not have completed. The error is: error.
You are installing product_name product_version over existing_product_name existing_product_version.
The alpha or beta edition for this product version is already installed. You cannot install the product in the same directory as the alpha or beta edition.
The active java version of java_version is lower than the version required by the product. The product requires version req_java_version or later.
The active java is not an SDK: java_path.
You must be the root user to run this script.
The software_dependency_name software dependency is not installed.
The product upgrade cannot continue because the following version is being used: product_version.
The owner user does not have read, write, and execute permissions to the root_directory directory.
The installation program cannot find the following response file: reponse_file_name.
The product installation failed with return code return_code. Analyze the messages in the installation summary log in the following directory: installation_summary_log_directory.
The following required file is not found: missing_required_file. You might need to reinstall the product. Analyze the messages in the installation summary log in the following directory: installation_summary_log_directory.
The following required file is not found in the current directory: missing_required_file.
The following command option requires a value: command_option.
The following option is not valid for the command: command_option.
The response_property property was not found in the following response file: response_file. This property is required.
An exception occurred during the creation of the working directories. The error code is error_code. Messages in the installation summary log can provide more detailed information.
There are other versions installed in the following installation root directory: installation_root_directory. The owner and group must be the same for all versions that are installed in this root directory.
The following installation owner that is specified on the FILE_OWNER_USER_ID response file property does not exist: installation_owner.
The following installation owner group that is specified on the FILE_OWNER_GROUP response file property does not exist: installation_owner_group.
An exception occurred during the product uninstallation. The error is: error_message
The version_to_uninstall version that you are uninstalling is in use by the following processes on this system: process_ids.
The version_to_uninstall version that you are uninstalling is in use by the system_service_name system service for the domain_name domain and the zk_connection_string ZooKeeper. Remove the system service by using the streamtool unregisterdomainhost command.
You cannot uninstall the product. The product must be uninstalled by the owner of the installed files or the root user.
The following option requires a value: parameter.
The IS_EDITION_TYPE property is missing.
The following value of the IS_EDITION_TYPE property is not valid: edition_type.
The file_name file required by the system_service_name system service for the domain_id domain is missing.
The controller service could not be started for the following domain: domain_id. See previous messages, correct any issues and manually start the controller using the streamtool startdomainhost command with the --unregistered option.
The command_name command cannot be invoked by the operating system.
The operating system cannot successfully run the command_name command. The operating system exception is: os_exception_text.
Embedded ZooKeeper is in use and cannot be upgraded in the following directory: global_installation_directory. The following versions of the product are using embedded ZooKeeper: list_versions_in_use.
The following required file is not found in the installation package: missing_required_file.
The following product marker file is either empty or corrupted: help_parameter.
These messages describe the conditions and problems that can occur when you work with the Streams Processing Language compiler, utility, and documentation (SPLDOC).
These messages describe the conditions and problems that can occur during the processing of the runtime services and utilities.
These messages describe the conditions and problems that can occur when you work with the application manager service (SAM).
These messages describe the conditions and problems that can occur when you work with the REST API and the web management service (SWS).
Find details on the SPL language, toolkits, APIs, commands, and more.
Use this glossary to find terms and definitions for Teracloud® Streams.
