Preparing to install Teracloud® Streams

Use the information in this topic to plan and prepare for your Teracloud® Streams installation. The plan that you create for your environment determines your tasks and choices throughout the installation process.

Before you begin

These preparation tasks apply only to new installations of Teracloud® Streams. To prepare to upgrade your Teracloud® Streams environment, see the following information: Upgrading Teracloud Streams

Decide what kind of Teracloud® Streams environment best suits your needs. The preferred and most reliable environment for multiple resources is a production environment. If you do not need high availability, a development or test environment might be your preferred option.

Use the environment considerations to make planning decisions on the following installation details:
  • Installing as the root vs. non-root user
  • Running management or application services on separate resources
  • Setting up ZooKeeper on a dedicated resource

To review the considerations and make decisions for each environment type, see the following information: Considerations for Teracloud Streams environments with multiple resources.

Procedure

  1. Set up the hardware that you need for all of the resources in your environment.
    A Teracloud® Streams resource refers to an entity on which streams application and Teracloud® Streams services can be run, for example a host.

    Verify that your resources meets the hardware requirements for Teracloud® Streams by using the following information: Hardware requirements for Teracloud Streams

  2. Configure the operating systems on your Teracloud® Streams resources.
    Dependencies and restrictions exist for some of the operating system choices. Verify that your target systems meet the operating system requirements by using the following information: Operating system requirements for Teracloud Streams
  3. On every resource, ensure that the character encoding of your Linux system locale configuration is set to UTF-8.
  4. On every resource where you want to use a Teracloud® Streams interface, install an X Window System.
    An X Window System is required to use the Teracloud® Streams Interactive GUI installation method and Streams Console on Linux.
  5. Determine whether your environment requires additional software. Use the following information to determine whether you need additional software prerequisites:
  6. Download the Teracloud® Streams installation files.

    For information about downloading the current version of Teracloud® Streams, see Downloading Teracloud Streams.

    The download package includes the installation dependency checker tool.

  7. After you download the installation package to your system, use the dependency checker to find and fix any issues with your resources and environment.

    The Teracloud® Streams installation package provides a script that verifies whether your environment meets the requirements for Teracloud® Streams. Use the instructions at the following link to run the checking tool: Teracloud Streams dependency checker script

  8. Fix any dependency issues and optimize the environment.
    The dependency checker provides results that you can use to prepare and fix your Teracloud® Streams environment before installation. Use the information in the following sections to determine the correct updates and settings for your resources:

What to do next

After you prepare the environment and install the prerequisite software, use the installation tools that are provided in the package to install Teracloud® Streams. For complete instructions, see the following information: Installing the Teracloud Streams product