Home
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
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.
Installation
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.
CDISI5019E
You cannot install the prior version of product_name product_version over existing_product_name existing_product_version in the existing_installation_directory directory.

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.
- 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.
  - Naming conventions for Teracloud® Streams log message IDs
    Each log message has a unique message ID. The naming convention for each Teracloud® Streams message ID is CDISXNNNNT.
  - Streams Console
    These messages describe the conditions and problems that can occur when you work with Streams Console.
  - Streamtool and command line user interfaces
    These messages describe the conditions and problems that can occur when you work with the streamtool commands.
  - Installation
    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.
    - CDISI0001I
      The dependency checker evaluated the system and found error_count errors.
    - CDISI0002I
      The software dependency rules are not defined for the target system.
    - CDISI0003I
      The dependency checker evaluated the system and did not find errors or warnings.
    - CDISI0004I
      The dependency checker evaluated the system and found error_count errors and warning_count warnings.
    - CDISI0005I
      The dependency checker evaluated the system and found warning_count warnings.
    - CDISI0014I
      The system_service_name system service already exists for the domain_id domain.
    - CDISI0015I
      The system_service_name system service for the domain_id domain is defined to use the following installation: installation-directory.
    - CDISI0016I
      Installing the product in the following directory: installation_directory...
    - CDISI0017I
      Registering the local host with the following domain: domain_id...
    - CDISI0018I
      The host setup completed successfully.
    - CDISI0019I
      The host setup completed with warnings.
    - CDISI0020I
      Uninstalling the product using console mode because an uninstallation mode was not specified.
    - CDISI0021I
      The uninstallation was cancelled by the following user: user_id.
    - CDISI0022I
      The user_id user can remove the contents of the installation_directory directory but does not have permission to remove the directory.
    - CDISI0023I
      The uninstallation program completed with return_code return code.
    - CDISI0024I
      The following option is not supported and will be ignored: option.
    - CDISI0025I
      The installation directory is located on a shared file system.
    - CDISI0026I
      The uninstallation program will attempt to remove the following directory and all of its contents: directory.
    - CDISI0027I
      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.
    - CDISI0028I
      The uninstallation program will not attempt to remove the directory directory because other versions or other files and directories exist.
    - CDISI0029I
      Starting the controller service as an unregistered service for the following domain: domain_id...
    - CDISI0030I
      The following command was canceled: specified_command.
    - CDISI0031I
      The operation was completed.
    - CDISI0032I
      The user did not have sufficient privileges to run the check.
    - CDISI0033I
      The check cannot be run because the following system command was not found: command.
    - CDISI3000W
      The install_package_version installation image that you are trying to install is not supported on your target_operating_system operating system version.
    - CDISI3001W
      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.
    - CDISI3002W
      The install_image_architecture architecture of the installation image does not match the target_system_architecture architecture of your system.
    - CDISI3003W
      The character_encoding character encoding of your locale configuration is not supported by the product.
    - CDISI3004W
      The installation process might not be able to reach the hostname host.
    - CDISI3006W
      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.
    - CDISI3008W
      The installation log file was not copied from the source_directory directory to the target_directory directory.
    - CDISI3009W
      Your target_system operating system and target_system_architecture architecture are not supported by the product.
    - CDISI3010W
      No network interfaces were detected on the host.
    - CDISI3011W
      The upgrade program cannot remove all the files for the current installation.
    - CDISI3012W
      The hostname host name did not resolve to an IPV4 address. The host name resolved to IP_address.
    - CDISI3013W
      IBM Java ibm_java_version is not installed.
    - CDISI3016W
      The install_image_architecture architecture of the installation image does not match the target_system_architecture architecture of the system.
    - CDISI3018W
      The root user cannot change the owner of the deployed files to the install_owner user and the install_owner_group group.
    - CDISI3019W
      The hostname host name is not known to the system name resolver.
    - CDISI3021W
      The system cannot determine whether the installer is the root user.
    - CDISI3022W
      An error occurred during the uninstallation of the existing version of the product. The error is: error
    - CDISI3023W
      Certain required software is not installed, or certain required software that is installed is not the required version. However, the installation process continued.
    - CDISI3024W
      An error occurred when the owner of the deployed file was changed. The error is: error
    - CDISI3025W
      The character encoding of the system cannot be determined. The product requires the character_encoding character encoding.
    - CDISI3027W
      The product does not support the character_encoding character encoding of your locale configuration.
    - CDISI3028W
      Software dependency checking might not be accurate for your environment.
    - CDISI3032W
      The hostname host name is not valid or resolves to a loopback address.
    - CDISI3034W
      Your target_system system is not supported by the install_image_target installation image.
    - CDISI3036W
      Software dependencies are not installed or are not at the correct version.
    - CDISI3040W
      The Streams Domain Manager cannot be opened.
    - CDISI3042W
      The process might not have finished. The warning is: error.
    - CDISI3043W
      Some of the current installation files might not be removed during the requested process.
    - CDISI3044W
      The system soft limit for the maximum number of processes is low: maximum_processes.
    - CDISI3045W
      The system soft limit for the open files is low: open_files.
    - CDISI3046W
      The system hard limit for the maximum number of processes is low: maximum_processes.
    - CDISI3047W
      The system hard limit for the open files is low: open_files.
    - CDISI3048W
      The product was installed with warnings that are logged in the installation summary log in the following directory: summary_log_directory.
    - CDISI3049W
      The trace log file for the product uninstallation cannot be created because of the following error: additional_message
    - CDISI3050W
      The uninstallation program could not remove the following file or directory; file_or_directory.
    - CDISI3051W
      The DNS lookup by IP address failed. The hostname host name resolves to the following IP address: IP_address.
    - CDISI3052W
      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.
    - CDISI3053W
      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.
    - CDISI3054W
      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.
    - CDISI3055W
      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.
    - CDISI3056W
      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.
    - CDISI3057W
      The hostname host name resolved to the IP_address IP address, but the DNS lookup failed.
    - CDISI3058W
      An unexpected exception was detected while performing name resolution checking. The exception error message is: error_message
    - CDISI3059W
      You may be running a firewall which may prevent communication between the cluster hosts.
    - CDISI3060W
      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.
    - CDISI3061W
      The hostname host name did not resolve to an IP address using DNS lookup.
    - CDISI5001E
      The installed version installed_version of the software dependency exceeds the maximum_version maximum version that is supported by the product.
    - CDISI5002E
      IBM Java java_version is not installed.
    - CDISI5003E
      The hostname host name was resolved to an IPV6 address, which is not supported by the product.
    - CDISI5004E
      The system name resolver does not recognize the hostname host name.
    - CDISI5005E
      The hostname host name is not valid or resolves to a loopback address.
    - CDISI5006E
      No network interfaces were detected on the host.
    - CDISI5007E
      The software_dependency software dependency does not meet the required version of required_version.
    - CDISI5008E
      The parameter is not valid. Use help_parameter to see the valid parameters.
    - CDISI5009E
      The install_package_information installation image is not supported by your target_operating_system operating system.
    - CDISI5010E
      The software_dependency_name software dependency is not installed. A minimum version of minimum_version is required.
    - CDISI5011E
      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.
    - CDISI5012E
      An IP address, which is required for name resolution, could not be detected for the host.
    - CDISI5013E
      The host resolved the hostname hostname to the IP_address IP address, which is not associated with the local network interfaces.
    - CDISI5014E
      The version of the software_dependency software dependency exceeds the maximum supported version of maximum_version. The minimum required version is minimum_version.
    - CDISI5015E
      The argument is not valid because verbose_parameter must be followed by valid level of the verbose parameter.
    - CDISI5016E
      The install_package_architecture architecture of the installation image does not match the target_operating_system_architecture architecture of your system.
    - CDISI5017E
      The version of the software_dependency software dependency is below the minimum required version of minimum_version.
    - CDISI5018E
      Your target_system operating system is not supported by this installation image. This image supports the build_target operating system.
    - CDISI5019E
      You cannot install the prior version of product_name product_version over existing_product_name existing_product_version in the existing_installation_directory directory.
    - CDISI5020E
      An error occurred when the software dependencies were checked.
    - CDISI5022E
      The global configuration was not set up.
    - CDISI5023E
      The owner of the file must be specified.
    - CDISI5025E
      The path to the installation directory must be an absolute path. A relative path is specified.
    - CDISI5026E
      You cannot install Streams version previous_version, which is a prior version, over the later version newer_version.
    - CDISI5028E
      The installation was cancelled because software dependencies are missing. The response file specifies that the installation be cancelled.
    - CDISI5029E
      The silent installation stopped because you are not the root user or the LICENSE_ACCEPTED property in the response file is set to "false."
    - CDISI5030E
      An error occurred when the command command was run.
    - CDISI5031E
      An error occurred when the installation software was extracted.
    - CDISI5032E
      The product cannot be upgraded. The user must be the installation owner or the root user.
    - CDISI5033E
      The owner_group owner group does not exist. Before the product can be installed, the specified owner group must exist.
    - CDISI5034E
      The installation_directory directory is not a valid installation directory.
    - CDISI5035E
      An IO error occurred when the product version was validated. The error is: error_detected
    - CDISI5036E
      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.
    - CDISI5037E
      You do not have the required permissions for the install_directory installation directory.
    - CDISI5038E
      The owner group of the installation files must be specified.
    - CDISI5039E
      The owner installation owner does not exist. An existing user must be specified.
    - CDISI5040E
      An error occurred when the system configuration was checked. The error is: error
    - CDISI5041E
      You are not the root user or the owner of the installed files.
    - CDISI5042E
      The install_image_architecture architecture of the installation image does not match the target_system_architecture architecture of your system.
    - CDISI5043E
      The root user cannot be the owner of the deployed files.
    - CDISI5044E
      An error occurred. The function that was in progress might not have completed. The error is: error.
    - CDISI5045E
      You are installing product_name product_version over existing_product_name existing_product_version.
    - CDISI5046E
      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.
    - CDISI5047E
      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.
    - CDISI5048E
      The active java is not an SDK: java_path.
    - CDISI5052E
      You must be the root user to run this script.
    - CDISI5070E
      The software_dependency_name software dependency is not installed.
    - CDISI5071E
      The product upgrade cannot continue because the following version is being used: product_version.
    - CDISI5072E
      The owner user does not have read, write, and execute permissions to the root_directory directory.
    - CDISI5074E
      The installation program cannot find the following response file: reponse_file_name.
    - CDISI5075E
      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.
    - CDISI5076E
      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.
    - CDISI5077E
      The following required file is not found in the current directory: missing_required_file.
    - CDISI5078E
      The following command option requires a value: command_option.
    - CDISI5079E
      The following option is not valid for the command: command_option.
    - CDISI5080E
      The response_property property was not found in the following response file: response_file. This property is required.
    - CDISI5081E
      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.
    - CDISI5082E
      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.
    - CDISI5083E
      The following installation owner that is specified on the FILE_OWNER_USER_ID response file property does not exist: installation_owner.
    - CDISI5084E
      The following installation owner group that is specified on the FILE_OWNER_GROUP response file property does not exist: installation_owner_group.
    - CDISI5085E
      An exception occurred during the product uninstallation. The error is: error_message
    - CDISI5086E
      The version_to_uninstall version that you are uninstalling is in use by the following processes on this system: process_ids.
    - CDISI5087E
      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.
    - CDISI5088E
      You cannot uninstall the product. The product must be uninstalled by the owner of the installed files or the root user.
    - CDISI5089E
      The following option requires a value: parameter.
    - CDISI5090E
      The IS_EDITION_TYPE property is missing.
    - CDISI5091E
      The following value of the IS_EDITION_TYPE property is not valid: edition_type.
    - CDISI5092E
      The file_name file required by the system_service_name system service for the domain_id domain is missing.
    - CDISI5093E
      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.
    - CDISI5094E
      The DNS lookup by IP address failed. The hostname host name resolves to the following IP address: IP_address.
    - CDISI5095E
      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.
    - CDISI5096E
      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.
    - CDISI5097E
      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.
    - CDISI5098E
      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.
    - CDISI5099E
      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.
    - CDISI5100E
      The hostname host name resolved to the IP_address IP address, but the DNS lookup failed.
    - CDISI5101E
      An unexpected exception was detected while performing name resolution checking. The exception error message is: error_message
    - CDISI5102E
      The command_name command cannot be invoked by the operating system.
    - CDISI5103E
      The operating system cannot successfully run the command_name command. The operating system exception is: os_exception_text.
    - CDISI5104E
      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.
    - CDISI5105E
      The hostname host name did not resolve to an IP address using DNS lookup.
    - CDISI5106E
      The following required file is not found in the installation package: missing_required_file.
    - CDISI5107E
      The following product marker file is either empty or corrupted: help_parameter.
  - Streams Processing Language (SPL)
    These messages describe the conditions and problems that can occur when you work with the Streams Processing Language compiler, utility, and documentation (SPLDOC).
  - Runtime services and utilities
    These messages describe the conditions and problems that can occur during the processing of the runtime services and utilities.
  - Application manager service
    These messages describe the conditions and problems that can occur when you work with the application manager service (SAM).
  - Web management service
    These messages describe the conditions and problems that can occur when you work with the REST API and the web management service (SWS).
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

CDISI5019E

You cannot install the prior version of product_name product_version over existing_product_name existing_product_version in the existing_installation_directory directory.

You cannot install a prior version of the product over a later version in the same installation directory.

Select a new directory in which to install the product. Alternatively, you can stop the installation, uninstall the existing version of the product, and try to install again.