Installing Teracloud® Streams by using the automated method
The automated installation method enables you to
build an installation package that you can use to install the Teracloud®
Streams product on a
large number of networked resources that share the same configuration.
Before you begin
Procedure
- Install the Teracloud®
Streams main
installation package on at least one resource.
The main installation package includes all of the product files.
-
For additional Teracloud®
Streams resources in the domain, create a domain host installation package file that includes a subset of
the product files.
To generate a package file that runs the installation in silent mode and uses the default installation location, enter the following command:
streamtool mkhostpkg -d domain-id --zkconnect host:port
Notes:- The
domain-idthat you specify does not need to exist when you enter the streamtool mkhostpkg command. If you do not specify a domain-id, Teracloud® Streams uses the default domain ID ofStreamsDomain. - The --zkconnect option specifies the name of one or more host and port pairs for the configured external ZooKeeper ensemble. If you specify multiple host and port pairs, separate each pair with a comma. This value is the external ZooKeeper connection string. To obtain this value, you can use the streamtool getzk command.
- The generated package is located in the current directory. To use a different directory, specify the --pkg-dir pathname option on the command.
- By default, 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. For more information, see Options for setting up the domain controller service.
- The mkhostpkg command generates an uncompressed tar file. The contents of the files in the installation tar file are compressed. The installation package file includes a response file (responsefile.properties) that is used to perform the installation. By default, the mkhostpkg command creates a domain host installation package, which includes a subset of the product files. For example, this package does not contain the toolkits.
- The
- Optional: Customize the responsefile.properties file
that was created by the mkhostpkg command.
- Extract the contents of the installation package.
- Use an editor of your choice to customize the response file.
- Use a configuration management tool, such as Puppet or
Chef, to install Teracloud®
Streams on
each resource.The configuration management tool performs the following operations on the resource:
- Copies and extracts the contents of the installation package file that you created in Step 2 by using the streamtool mkhostpkg command.
- Optionally runs the Teracloud® Streams dependency_checker.sh script. This script must run from the directory where the extracted files are located.
- As user root installs Teracloud® Streams on the resource by running the streamsdomainhostsetup.sh script. This script must run from the directory where the extracted files are located.
Notes:- If the installation is successful, Teracloud® Streams creates the product-installation-root-directory/7.2.0.0/.success file. The creation of this file can be used as a repeatable test in the configuration management tool to determine if the installation is successful.
- The response file contains a property to set the language, country, and character encoding. By default, the value of this property is the language, country, and character encoding of the system on which the installation package was created. This property must have the character encoding set to UTF-8. For example a valid value is en_US.UTF-8.