Home
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.
Removing domains
When you remove a domain, all of the instances and jobs in that domain are removed too.

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.
  - Domain identifiers
    A domain name or identifier is the name that you specify when you create a domain.
  - Creating domains
    Before you use Teracloud® Streams, you must create at least one domain.
  - Adding hosts to a domain
  - Monitoring domains
    Use the streamtool getdomainstate command to view the status of a Teracloud® Streams domain, its resources, and services.
  - Updating domain properties
    After you create a Teracloud® Streams domain, you can configure it by updating its properties.
  - Removing domains
    When you remove a domain, all of the instances and jobs in that domain are removed too.
- Resources
  After you add resources to domains and instances, you can administer them by using the Streams Console or the streamtool command-line interface.
- 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.

Removing domains

When you remove a domain, all of the instances and jobs in that domain are removed too.

Before you begin

To remove a domain, you must have delete authority for the domain object. For more information, see User authorization for Teracloud® Streams.

About this task

A Teracloud® Streams domain is a logical grouping of resources in a network for common management and administration. To use Teracloud® Streams, you must create at least one domain.

Procedure

Optional: Stop all of the instances in the domain.
Use the Streams Console or the streamtool stopinstance command.
Stop the domain.
Use the streamtool stopdomain command. If you did not stop the instances individually, you can specify the --force option stop all the instances.
Remove the domain.
Use the streamtool rmdomain command.

Results

This task removes the domain and the instances in the domain. In basic domains, the embedded ZooKeeper is stopped when no users or domains are using it. If you are using the interactive streamtool interface, the embedded ZooKeeper is stopped when you exit the interface by entering exit or quit.

When you remove enterprise domains, Teracloud® Streams contacts the domain controller service that is running on each resource in the domain. If you do not specify the --keep-domain-hosts option in the streamtool rmdomain command, each domain controller service unregisters the resource from the domain and then stops. If the domain controller service was running as a system service, it is removed. If you specify the --keep-domain-hosts option in the streamtool rmdomain command, it does not unregister the resources and does not remove the domain controller service from each resource. If you later create a domain with the same name, you do not have to re-register each of these resources with the domain. The command also removes the domain configuration information from ZooKeeper.