Creating a Teracloud® Streams basic domain and instance

You can create a basic domain and instance by using the Teracloud® Streams graphical user interfaces or the streamtool command-line interface.

A basic domain is typically used for test or development environments. Use an enterprise domain for a production environment.

Before you begin

Ensure that the value of the STREAMS_ZKCONNECT environment variable is unset. This environment variable is used to set the connection string for a external ZooKeeper server. If the value of this environment variable is not unset, Teracloud® Streams streamtool commands might not use embedded ZooKeeper, which can cause incorrect results.
If your home directory is on a shared file system, you can only use embedded ZooKeeper on one resource at a time. Teracloud® Streams starts embedded ZooKeeper when you start the domain. For example, if user1 starts the domain on resource A and the same user tries to start the same domain on resource B, an error occurs.
The streams.zookeeper.quorum bootstrap property indicates the host name of the embedded ZooKeeper server. Only a local host name is supported. When streamtool is first started, this property is populated with a local host name and persisted in the home directory of the user. If your home directory is on a shared file system and you want to start embedded ZooKeeper on a different resource, update the streams.zookeeper.quorum property with the new host name by using the streamtool setbootproperty command. Otherwise, an error message similar to the following example is issued: CDISA5252E Invalid value for bootstrap property 'streams.zookeeper.quorum'. For embedded ZooKeeper the value must specify the hostname for the local host. Found: host1. Use 'streamtool setbootproperty' to update the property value.

Procedure

Use this procedure to create a basic domain and instance by using the Teracloud® Streams streamtool command-line interface.

To configure your local shell environment for Teracloud® Streams, enter the following command:
```
  source product-installation-root-directory/7.2.0.0/bin/streamsprofile.sh
```
To complete this procedure in the interactive streamtool interface, enter the following command:
```
    streamtool  
```
Notes:
- When prompted, press Enter to use embedded ZooKeeper.
- Using the interactive streamtool interface saves you time. Teracloud® Streams caches some command options and information so that you do not have to reenter them. Also, you do not have to specify streamtool before each command. To exit the interactive streamtool interface, enter exit or quit.
To create a basic domain, enter the following command:
```
  mkdomain -d domain-id 
```
For example:
```
  mkdomain -d StreamsDomain
```
To create public and private keys for Teracloud® Streams, enter the following command:
```
  genkey
```
Generating public and private keys eliminates the need for you to enter a password when you perform Teracloud® Streams tasks that require authentication.
The streamtool genkey command generates the following files:
- Private key: user-id_priv.pem
- Public key: user-id.pem
Teracloud® Streams stores the private key in the user-home-directory/.streams/key/domain-id directory. The public key is stored in ZooKeeper.
To start the domain, enter the following command:
```
  startdomain
```
Tip: If the domain fails to start because a port is in use, you can change the port number by using the streamtool setdomainproperty command. For example, if the domain fails to start because one or more of the JMX management API service, web management service, and REST management API service ports are in use, you can enter the following command. If you specify a value of 0 for the port number, Teracloud® Streams selects an available port.
```
setdomainproperty jmx.port=0 sws.port=0 rest.port=0
```
Dynamic port allocation is not ideal, however, if you have applications that use the REST API or JMX API or use tools (such as Streams Console) that access those services.
Create one or more instances for running stream applications. To create an instance, enter the following command:
```
  mkinstance -i instance-id 
```
For example:
```
  mkinstance -i StreamsInstance
```
Start the instance by entering the following command:
```
  startinstance 
```
To manage and monitor the domain, you can use the Streams Console. The domain must be started to use the console.
To open the console:
1. Enter geturl to display the URL for the console. For example, if your resource is myhost.mydomain.com and the port number for the console is 8440, this command displays the following URL:
```
https://myhost.mydomain.com:8440/streams/domain/console
```
2. Paste this URL into your browser.
To exit the interactive streamtool interface, enter exit or quit.