Home
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Resources
After you add resources to domains and instances, you can administer them by using the Streams Console or the streamtool command-line interface.
Tags
Tags are a mechanism for differentiating and identifying resources that have different physical characteristics or logical uses.
Assigning tags to resources
You can specify the tags for a resource at domain creation time, when a resource is added to a domain, or any time thereafter.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
- Domains
  After you create a Teracloud® Streams domain, you can administer it by using the Streams Console graphical user interface and the streamtool command-line interface.
- Resources
  After you add resources to domains and instances, you can administer them by using the Streams Console or the streamtool command-line interface.
  - Resource allocation for application services
    A resource for application services can be static (added explicitly to an instance) or dynamic (added to or removed from an instance dynamically based upon the job or processing element requirements). A static resource is specified manually by name or automatically by a resource specification and remains allocated to the instance until it is explicitly removed. A dynamic resource is released from the instance when the instance is stopped or when the resource is no longer needed.
  - Resource allocation for management services
    Management services are placed on static resources if available. If the instance does not have any static resources and dynamic resource allocation is enabled, management resources are dynamically requested at the time the instance is started.
  - Resource identifiers
    A resource identifier uniquely identifies a resource in a domain or instance.
  - Tags
    Tags are a mechanism for differentiating and identifying resources that have different physical characteristics or logical uses.
    - Creating and removing tags in a domain
      You can create tags to identify resources that have different physical characteristics or logical uses.
    - Assigning tags to resources
      You can specify the tags for a resource at domain creation time, when a resource is added to a domain, or any time thereafter.
    - Using tags to restrict resources
      You can use tags to restrict resources for a specific application purpose by creating a tag restriction between the resource and a tag or between an instance and a tag. This tag restriction instructs the scheduler to place on the resource only the processing elements (PEs) that refer to a host pool that specifies that tag.
  - Monitoring resources
    Use the Streams Console to view the status of resources.
  - Stopping and quiescing resources
    You can stop or quiesce resources when you want to perform maintenance activities.
  - Removing resources
    You might choose to remove a resource if the host is no longer available or you want to replace it with a different resource.
- Instances
  To create and manage instances, you can use the Streams Console or the streamtool command-line interface.
- Domain and instance services
  Before you can perform Teracloud® Streams tasks, Teracloud Streams domain and instance services need to be running on resources in the domain. Domain services are started by starting the domain and instance services are started by starting the instance.
- Jobs
  You can start and administer jobs by using Streams Console or the streamtool command-line interface.
- Recovery
  You can back up your Teracloud® Streams system files and directories and then restore them later if necessary. In general, you can recover from application and runtime failures without restoring Teracloud Streams from a backup.
- Streams Console
  You can use the Streams Console to monitor and manage the Teracloud® Streams instances and applications in your domain from any computer that has HTTP connectivity to the server that is running the web management service.
- Logs and traces
  Teracloud® Streams provides options that enable administrators, instance owners, and application developers to manage log and trace data.
- Managing and monitoring Teracloud® Streams using management APIs
  Teracloud® Streams provides two API sets to manage and monitor Streams services and jobs.
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

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

Teracloud® Streams dynamically responds to tag changes. It makes automatic adjustments to the location of Teracloud® 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, rest, and sws tags. To control the placement of instance management services, use the data, 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 stream applications, assign them to resources that also have the application tag. The application manager service considers these tags when it matches resources against the requirements that are specified in your applications.

Procedure

To add tags to a Teracloud® 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 a Teracloud® 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 Teracloud® Streams resources in a domain, use the Streams Console or the streamtool chhost command.

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.