Creating a domain host installation package for a Teracloud® Streams enterprise domain

You can use this procedure to create a domain host installation package that you can use to add Teracloud® Streams resources to the domain.

Before you begin

  • Install the main installation package for Teracloud® Streams on at least one resource. The main installation package includes all of the product files. To reduce the product size requirement on resources, the domain host installation package contains a subset of the Teracloud® Streams product files. For example, this package does not contain the toolkits.
    Note: If you installed the main installation package on a shared file system that is accessible by all resources in the domain, you do not need to create a domain host installation package. To add resources to the domain, see Adding Teracloud Streams resources that already have the product installed.

  • Optionally, create an enterprise domain. If you create the domain after you set up the resources, you must use the domain name and ZooKeeper connection string that are specified in the domain host installation package.

About this task

The domain host installation package contains a streamsdomainhostsetup.sh script, a response file, and a readme file. The response file contains the installation information that you specify when you create the package and helps to simplify the installation process.

The script performs the following operations:
  • Installs Teracloud® Streams on the resource.
  • Registers the resource in the domain.
  • Sets up the domain controller service as a Linux™ system service or an unregistered service. For more information, see Options for setting up the domain controller service.
  • Starts the domain controller service on the resource.

Procedure

  1. Create the domain host installation package by using the Streams Console or the streamtool mkhostpkg command.

    • Streams Console

      If the domain exists, you can download the package from the Streams Console. You can specify the installation directory, installation owner, and installation group in the Streams Console Add Resources window before you download the package.

      Notes:
      • Download the package file from a resource that has the main installation package installed.
        Important: Ensure that the web management service is running on the resource, or an error message is displayed. You can use the streamtool getdomainstate command to verify that the service is running.

      • By default, the domain controller service option is selected. If selected, the controller is set up as a registered Linux™ system service when you install the domain host installation package. To run the controller as an unregistered service, clear the controller option check box in the Streams Console Add Resources window before you download the package.

    • streamtool mkhostpkg command

      You can create the domain host installation package by running this command even if the domain does not exist.

      By default, the streamtool mkhostpkg command uses the following options:
      • The domain ID is StreamsDomain. To use a different domain ID, specify the -d domain-id option on the command.

      • The generated package is located in the current directory. To use a different directory, specify the --pkg-dir pathname option on the command.

      • The domain controller service is set up as a registered Linux™ system service when you install the domain host installation package. To run the controller as an unregistered service, specify the --unregistered option on the command.
        Note: If a non-root user runs the command with the --unregistered option, the domain must exist and be started.

  2. Optional: Customize the response file.

    To change the options that you specified when you created the domain host installation package, extract the contents of the installation package and edit the response file. For example, you can use the same installation package to add the resource to another domain with a different ZooKeeper connection string value. Before you run the setup script on your resources, modify those properties in the response file.

Results

The domain host installation package is created. The package file is an uncompressed tar file. The contents of the files in the tar file are compressed.

What to do next

Copy the domain host installation package to all of the resources that you want to add to the domain.

After you copy the package to a resource, install and configure Teracloud® Streams on the resource.