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 InfoSphere® Streams.
About this task
An InfoSphere Streams domain is a logical grouping of resources in a network for common management and administration. To use InfoSphere 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 Domain Manager or 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 Domain Manager or 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, InfoSphere 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 or the Domain Manager, 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 or the Domain Manager, 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.