Adding Teracloud® Streams resources by installing the domain host installation package

Use this procedure to install and configure Teracloud® Streams on a resource that you are adding to a Teracloud® Streams domain. This Readme file describes how to install and configure Teracloud® Streams on a resource that you are adding to a Teracloud® Streams domain. To reduce the product size requirement on the resource, the domain host installation package contains a subset of the Teracloud® Streams files.

Before you begin

The following procedure installs Teracloud® Streams on the resource, registers the resource with the domain, sets up the Teracloud® Streams domain controller service, and starts this service on the resource.

Before you start the procedure, review the following information:

Copy the domain host installation package to this resource. For more information about how to create and customize this package, see Creating a domain host installation package.
Create the user ID and group that owns the installation if they do not exist on this system. This ID and group are the ID and group that are specified when the domain host installation package is created. The default ID and group are streamsadmin. Teracloud® Streams uses this ID and group to run commands when the domain controller service processes requests on this resource.
Disable the resource firewall. If firewall usage is required, review the firewall configuration guidelines for Teracloud® Streams.
Java™ SDK 17 or later is required to run the preinstallation scripts in the following procedure. Ensure that it is installed before continuing with the procedure.

Procedure

Extract the contents of the domain host installation package by entering the following command:
```
   tar -xvf domain-host-installation-package-name.tar
```
The tar command creates the StreamsDomainHost directory, which contains the streamsdomainhostsetup.sh script and other installation files.
Run the Teracloud® Streams dependency checker script.

The user who owns the installation files runs the dependency checker script by entering the following commands:
```
  cd domain-host-installation-package-directory/StreamsDomainHost
  ./dependency_checker.sh
```
Correct any problems identified by the dependency checker script.
If the dependency checker script indicates that RPMs are missing, install the RPMs by using the dnf install command that is included with Red Hat Enterprise Linux™ (RHEL).
Most of the required RPMs for Teracloud® Streams are in your operating system installation package.
Run the Teracloud® Streams domain host setup script by entering the following command from the domain-host-installation-package-directory/StreamsDomainHost directory.
```
  ./streamsdomainhostsetup.sh
```
Notes:
- A root user must run the script if the domain host installation package was created with the option to run the domain controller service as a registered Linux™ system service. A root or non-root user can run the script if the package was created with the option to run the controller as an unregistered service.
- This script reads the responsefile.properties file in the domain-host-installation-package-directory/StreamsDomainHost directory. You can optionally change properties in the response file, such as the installation directory, before entering the following command.
- The domain host setup script in the domain host installation package installs Teracloud® Streams on a host by running the StreamsDomainHostSetup.bin file. This binary file is not a self-extracting file. If you run the StreamsDomainHostSetup.bin file instead of using the domain host setup script, you must run the binary file from the domain host installation package installation directory.
- If you see the following message, review any previous warning messages. If you cannot determine the problem from the messages that are displayed, review the warnings in the summary installation logs.
```
  CDISI0019I The domain host setup completed with warnings.
```

Results

The domain host setup script performs the following operations:

Installs Teracloud® Streams on the resource by running the StreamsDomainHostSetup.bin file.
Registers the resource in the domain.
Sets up the domain controller service as a registered Linux™ system service or an unregistered service. The controller setup depends on how the domain host installation package was created.
Starts the domain controller service on the resource.

What to do next

Teracloud® Streams provides several commands that you can use to manage the domain controller service on a resource. Before using these commands, you must configure the Teracloud® Streams environment variables by running the following command:

  source domain-host-installation-directory/bin/streamsprofile.sh

where domain-host-installation-directory is the root product installation directory and the product version directory. For example, if you installed Teracloud® Streams in the default location for user root, enter the following command:

source /opt/teracloud/streams/7.2.0.0/bin/streamsprofile.sh

You can use the following commands to manage the domain controller service on a resource.

This table lists the streamtool commands that can be used to manage the domain controller service on a resource.
Command	Description
streamtool getdomainhoststatus	Displays the status of the domain controller service on the resource. You must have root authority to run this command.
streamtool startdomainhost	Starts the domain controller service on the resource. If you set up the domain controller service to run as a registered Linux™ system service by running the streamtool registerdomainhost command, you must have root authority to run this command. To start the domain controller service as an unregistered service, a root or non-root user can specify the --unregistered option on this command. If a non-root user runs the command with this option, the domain must exist and be started.
streamtool stopdomainhost	Stops the domain controller service on the resource. You must have root authority to run this command.
To use the following commands, the domain controller service must be running as a Linux™ system service. You must have root authority to run these commands.
streamtool getdomainhostconfig	Displays the configuration properties for the domain controller service.
streamtool chdomainhostconfig	Changes the specified domain controller service properties.
streamtool rmdomainhostconfig	Removes the specified domain controller service properties.

For more information about command syntax and options, enter the following command:

  streamtool man command-name

Note: If you use the sudo program, the PATH environment variable might not be preserved on some platforms. For example, if you run the following commands, you might see a message indicating that the streamtool command is not found:

       source /opt/teracloud/streams/7.2.0.0/bin/streamsprofile.sh
       sudo streamtool getdomainhoststatus -d mydomain

       sudo: streamtool: command not found

To work around this problem, enter the following commands:

       source domain-host-installation-directory/bin/streamsprofile.sh
       sudo -E $STREAMS_INSTALL/bin/streamtool getdomainhoststatus -d mydomain