IBM InfoSphere Streams Version 4.1.0
Installing IBM® InfoSphere Streams by using the automated method
The automated installation
method enables you to build an installation package that you can use
to install the InfoSphere® Streams product
on a large number of networked hosts that share the same configuration.
Before you begin
Procedure
- Install the InfoSphere Streams main installation package on a host. The main installation package includes all of the product files.
- Create the installation package file for the hosts in the
domain. 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-id that you specify does not need to exist when you enter the streamtool mkhostpkg command. If you do not specify a domain-id, InfoSphere Streams uses the default domain ID of StreamsDomain.
- The --zkconnect option specifies the name of one or more host and port pairs for the configured external ZooKeeper ensemble. This value is the external ZooKeeper connection string. To obtain this value, enter the streamtool getzk -d domain-id command.
- The default location of the generated package is the current directory. For a different directory, specify --pkg-dir pathname on the command.
- 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 Streams Studio, Streams for Excel, and the toolkits.
- Optional: Customize the responsefile.properties file
that was created by the mkhostpkg command.
- Extract the contents of the installation package.
- Use your favorite editor to customize the response file.
- Use a configuration management tool, such as Puppet or
Chef, to install InfoSphere Streams on
each host. The configuration management tool performs the
following tasks on the host:
- Copies and extracts the contents of the installation package file.
- Optionally runs the InfoSphere Streams dependency checker script.
- As user root installs InfoSphere Streams on the host.
Notes:- If the installation is successful, InfoSphere Streams creates the product-installation-root-directory/4.1.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 where 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.