Adding hosts to a domain

You can add multiple resources to Teracloud® Streams enterprise domains.

Before you begin

Before you can add a host as a resource in one or more domains, you must install Teracloud® Streams on the host.

You can use the following installation methods for a multiple-host installation:
  • Install Teracloud® Streams on each resource. For high availability, install the main installation package on at least two resources and the domain host installation package on all additional resources.
  • Use a shared file system, such as Network File System (NFS) or General Parallel File System (GPFS™), and install the Teracloud® Streams main installation package in a shared directory that is accessible from each resource.
Note: If you choose to install Teracloud® Streams on each host, but want to reduce the product size requirement on the host, install the domain host installation package. The domain host installation package contains a subset of the product files.

If you are running the Teracloud® Streams Console from a browser that is running on the host, you can download the domain host installation package from within Teracloud® Streams Console. If you are running the Teracloud® Streams Console on a remote system, you must copy the domain host installation package to the new host.

In addition, you should decide whether you want to run the host controller as a registered or unregistered service.

About this task

After Teracloud® Streams is installed, you can add the host to domain by using one of the following methods.

Procedure

Select the appropriate action based on your installation type and how you want to run the host controller:
Installation method To run the host controller as a registered service To run the host controller as an unregistered service
You installed Teracloud® Streams on the host or in a shared file system that is accessible from the host On the host that you want to add to the domain, run the streamtool registerdomainhost command as a user with root authority.

This command registers the resource with the domain, sets up the controller as a registered Linux™ system service, and starts the controller on the resource.

 On the host that you want to add to the domain, run the following command: 
streamtool startdomainhost -d  --zkconnect
      ZooKeeper_connection_string --unregistered
Restriction: If you run this command as a non-root user, the domain must be created and started. Additionally, you must authenticate to the domain when you run the streamtool startdomainhost command.

This command registers the resource with the domain, sets up the controller as an unregistered service, and starts the controller on the resource.
You installed the domain host installation package on the host No additional action is required. The host is registered when you run the streamsdomainhostsetup.sh script. The service will be started according to how the domain host package was created. No additional action is required. The host is registered when you run the streamsdomainhostsetup.sh script. The service will be started according to how the domain host package was created.