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.
Creating and removing tags in a domain
You can create tags to identify resources that have different physical characteristics or logical uses.

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.

Creating and removing tags in a domain

Domains contain tags that you can use to specify which resources run the domain and instance services. You can create tags to identify resources that have different physical characteristics or logical uses.

Procedure

To define more tags in a domain, use the Streams Console, or the streamtool mktag command.
Note: Tags are case-sensitive strings with a letter optionally followed by alphanumeric or underscore characters.
To remove tags from a domain, use the streamtool rmtag command or the Streams Console.
Note: The tag is not removed in the following scenarios:
- The tag has a reserved name, such as management or application.
- The tag was used by the scheduler to place a processing element (PE) or job that is running.
If you remove a tag from the domain and that tag was used in a resource specification for an instance that is running, the resources are not removed from the instance until it restarts. To update or remove the resource specification that mentions the tag, use the Streams Console or the streamtool chresourcespec or streamtool rmresourcespec commands.

What to do next

After you create tags, assign them to resources in the domain. See Assigning tags to resources in a domain.