IBM InfoSphere Streams Version 4.1.1

Assigning tags to resources in a domain

You can specify the tags for a resource at domain creation time, when a resource is added to a domain, or any time thereafter.

About this task

InfoSphere® Streams dynamically responds to tag changes. It makes automatic adjustments to the location of InfoSphere Streams services, which are based on changes to the tags.

For better control of the placement of domain management services, instead of using the management tag, tag your resources with the specific service tags. For example, use the audit, authentication, jmx, and sws tags. To control the placement of instance management services, use the view and management tags. To control the placement of the application services and processing elements, use the application tag.

If you created extra tags for use by your streams processing applications, assign them to resources that also have the application tag. The scheduler service considers these tags when it matches resources against the requirements that are specified in your applications.

Procedure

To add tags to an InfoSphere Streams resource when you create a domain, use the --hfile option on the streamtool mkdomain command. Specify host identifiers and tags for each resource in the host file.
To add tags to an InfoSphere Streams resource when it is added to a domain, use the --tags option on the streamtool registerdomainhost command.
To change the tags that are associated with InfoSphere Streams resources in a domain, use the Streams Console or the streamtool chhost command.
To assign tags to externally managed resources, update the following properties:
- domain.managementResourceAllocationTags property
  The default value of this domain property is authentication,audit,jmx,sws. This means that all of these services will be placed on the same resource. If you remove a tag from this list, the external resource manager will allocate an additional resource for the tag that is removed.
  
  Example: If this property is set to authentication,audit, a single resource will be allocated that runs the authentication and authorization service and logging service. Two additional resources will be allocated: one resource to run the management API service and another resource to run the web management service.
- instance.managementResourceAllocationTags property
  The default value of this instance property is management,view. This means that all of the instance management services and the view service will be placed on the same resource. If you remove a tag from this list, the external resource manager will allocate an additional resource for the tag that is removed.
  
  Example: If this property is set to management, a single resource will be allocated that runs the application manager service, application metrics service, and scheduler service. An additional resource will be allocated to run the view service.
Use the Streams Console or the streamtool setdomainproperty and streamtool setproperty commands to update these properties. For more information about these properties, run streamtool man domainproperties and streamtool man properties.