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.
Stopping and quiescing resources
You can stop or quiesce resources when you want to perform maintenance activities.

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.
  - 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.

Stopping and quiescing resources

You can stop or quiesce resources when you want to perform maintenance activities.

Before you begin

To stop a Teracloud® Streams resource, you must have root authority.

To quiesce a resource, you must have write authority for the hosts domain object. For more information, see User authorization for Teracloud® Streams.

About this task

Before you stop or quiesce resources, consider whether jobs or domain and instance services are running on the resources:

If there are jobs with processing elements that cannot be relocated to other resources, you cannot stop or quiesce the resources.
If management services are running on the resources, you must have standby services on other resources in the domain; otherwise, you cannot stop or quiesce those resources. For more information, see Configuring high availability in a Teracloud® Streams enterprise domain.

Note: You can force the quiesce or stop operation to complete, but doing so can cause one or more jobs to become unhealthy or the domain or instance to stop unexpectedly.

Procedure

To quiesce a Teracloud® Streams resource, use the Streams Console or the streamtool quiesceresource command.
To stop a Teracloud® Streams resource, use the streamtool stopdomainhost command.

Note: You can use this command only when the domain controller service is running as a system service. You must run this command on the host that you are stopping.

Results

When you stop a Teracloud® Streams resource, all of the Teracloud® Streams services on the specified resource stop. When you quiesce a Teracloud® Streams resource, however, the domain controller service does not stop.

If Teracloud® Streams resource was dynamically allocated to the instance, it tries to find another resource to satisfy the resource specifications.

What to do next

To resume a Teracloud® Streams resource, use the Streams Console or the streamtool resumeresource command.