IBM Streams 4.3.0

Creating an IBM Streams basic domain and instance

An IBM® Streams domain is a container for IBM Streams instances which provides a single point for configuring and managing common resources, security, and instances. A basic domain has a single IBM Streams resource and user. This type of domain is typically used for test or development environments.

Before you begin

Configure the IBM Streams environment variables by entering the source command, and add this command to your home-directory/.bashrc shell initialization file. For instructions, see Step 5 in the installation procedure.

Use this procedure to create an IBM Streams basic domain and instance by using the Domain Manager and Streams Console graphical user interfaces.

Restriction: The Domain Manager is not supported on IBM Power Systems™ that are running little endian. An alternative is to use the streamtool command-line interface to create and manage domains.

To use the Domain Manager and Streams Console, you must have an X Window System installed. An alternative option is to use the streamtool command-line interface.

To create a domain by using the streamtool command-line interface, see Creating an IBM Streams basic domain and instance.

Procedure

If you did not open the Domain Manager during the interactive GUI installation procedure, enter the following command:
```
  streamtool launch --domainmgr
```
Create a basic domain.
1. In the Create Domain window, select Basic Domain and then click Create.
2. In the Create Basic Domain window, enter a domain name and select Start domain.
3. Optional: To specify the Streams Console and JMX port numbers, click Advanced. If the port number fields are left blank, IBM Streams selects an available port when the domain is started.
4. Click OK to create and start the domain.
  - IBM Streams generates your public and private keys for user authentication. Generating public and private keys eliminates the need for you to enter a password when you perform IBM Streams tasks that require authentication. The key files are in the home-directory/.streams/key directory.
  - The domain is added to the Domains list, and the domain properties are displayed.
In the Domains window, click Open Streams Console to create an IBM Streams instance.
1. When prompted, enter your IBM Streams user name and password.
2. In the Streams Console, click Manage Instances.
3. In the Instances window, click the plus sign (+) to add an instance.
4. In the Add Instance: Instance Properties window, accept the default instance name or enter a different name, and then click Next.
5. In the Add Instance: Assign Hosts window, click Finish. A basic domain includes only one host.

What to do next

Install Streams Studio