streamtool mkresourcepkg
If you are using the default IBM® Streams resource manager, use the streamtool mkhostpkg command instead. It generates a domain host installation package that you can use to add IBM Streams resources to the domain.
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 and deploy a resource installation package.
Usage
mkresourcepkg >>-+-----------------------+--+-----------------+---------------> '- --exclude--+-sws---+-' '- --group--group-' +-,-----+ '-devel-' >--+-------------+--+--------------------------+----------------> '-+- -h-----+-' '- --install-dir--pathname-' '- --help-' >--+-----------------+--+----------------------+----------------> '- --owner--owner-' '- --pkg-dir--pathname-' >--+-----------------+--+-----------------+---------------------> '- --trace--level-' '- --unregistered-' >--+-----------------------+--+-----------------------------+-->< '-+- -v--------+--level-' | .-,---------. | '- --verbose-' | V | | '- --zkconnect----host:port-+-'
Authority
You do not need any authority to run this command.
Description
The resource installation package is generated in the current directory or the directory that you specify in the --pkg-dir parameter. If strong encryption policy files exist in the installation directory, they are included in the package. You must copy this package to all of the externally managed resources that you want to add.
The method for deploying the resource installation package depends on the external resource manager that you use. For example, if you use IBM Platform Symphony, you can use the Platform Symphony rsdeploy command to deploy and install the package. Otherwise, you can deploy and extract the contents of the package manually. For example, after you copy the package to an externally managed resource, enter tar -xvf resource-installation-package-name.tar.
- deployment.xml: This file is used by Platform Symphony only. It helps to simplify the installation process when you use the Platform Symphony rsdeploy command.
- Installation script files:
- streamsresourceinstall.sh: This script file is used to install the IBM Streams product on the externally managed resources with the same options that you specified on the streamtool mkresourcepkg command.
- streamsresourcesetup.sh: This script file is used to install the IBM Streams product on the externally managed resources if you want to change any options that you specified on the streamtool mkresourcepkg command.
- streamsresourceuninstall.sh: This script file is used to uninstall the IBM Streams product on the externally managed resources.
If you specify a path where the product is already installed and you are not installing a new version, fix pack, or interim fix, the installation script stops. It does not reinstall the product.
Options and arguments
- --exclude
Specifies to exclude components from the installation package. You can exclude sws, which enables optional components such as the Streams Console, and devel, which enables developer resources such as toolkits. Use a comma-delimited list to exclude both sws and devel: sws,devel
- --group group
Specifies the group identifier that owns the files that are installed by the IBM Streams product. If you do not specify this option, the command uses the installation owner's group.
- -h, --help
Specifies to show the command syntax.
- --install-dir pathname
Specifies the path where you want to install the product. The default location is /opt/ibm/InfoSphere_Streams. The path does not need to exist before you run the streamsdomainhostsetup.sh script.
- --owner owner
Specifies the user ID that owns the files that are installed by the IBM Streams product. If you do not specify this option, the command uses the installation owner's user ID.
- --pkg-dir pathname
Specifies the path where you want to store the installation package. The default location is the current directory.
- --trace level
Specifies the trace setting. The following valid levels are listed in order of increasing verbosity, which is to say that the first level in the list generates the least amount of information:
- off
- error
- warn
- info
- debug
- trace
- -v,--verbose level
Specifies to provide more detailed command output. The verbosity level can be 0-3, where 0 disables detailed reporting and each increment provides more detailed output.
- --zkconnect host:port
The name of one or more host and port pairs that specify the configured ZooKeeper servers. This option is not supported within the interactive streamtool interface.
If you are not using the interactive streamtool interface and you do not specify this option, IBM Streams tries to use:- The --embeddedzk option
- The value from the STREAMS_ZKCONNECT environment variable
- A ZooKeeper connection string that is derived from cached information about the current domain.
Examples
[streamtool <bsmith@StreamsDomain.StreamsInstance>] mkresourcepkg
CDISA0070I Creating the following installation package:
/home/bsmith/StreamsResourceInstall-4.1.0.0-x86_64-el7.tar.
CDISA0069I The following installation package was successfully created:
/home/bsmith/StreamsResourceInstall-4.1.0.0-x86_64-el7.tar.