IBM Streams 4.3.0

Creating a domain host installation package for an IBM Streams enterprise domain

If you are using the default IBM® Streams resource manager to manage resources in your enterprise domain, you can use this procedure to create a domain host installation package that you can use to add IBM Streams resources to the domain.

If you are using an external resource manager, use the following procedures:

For IBM Spectrum Symphony® or a user-defined resource manager, see Creating and deploying a resource installation package for an IBM Streams enterprise domain.
For Apache Hadoop YARN, see Setting up Apache Hadoop YARN for IBM Streams.

Both IBM Streams resources and externally managed resources can be used together in a domain.

Before you begin

Install the main installation package for IBM 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 IBM Streams product files. For example, this package does not contain Streams Studio, Streams for Excel, and 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 IBM 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 IBM 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

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.
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 IBM Streams on the resource.