© 2015 IBM Corporation

Streamtool

IBM InfoSphere Streams Version 4.0

Denny Hatzenbihler

Streams Platform developer

For questions about this presentation contact: Denny Hatzenbihler

drhvm@us.ibm.com>

2 © 2015 IBM Corporation

Important Disclaimer

THE INFORMATION CONTAINED IN THIS PRESENTATION IS PROVIDED FOR INFORMATIONALPURPOSES ONLY.

WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THEINFORMATION CONTAINED IN THIS PRESENTATION, IT IS PROVIDED “AS IS”, WITHOUT WARRANTYOF ANY KIND, EXPRESS OR IMPLIED.

IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY,WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE.

IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OROTHERWISE RELATED TO, THIS PRESENTATION OR ANY OTHER DOCUMENTATION.

NOTHING CONTAINED IN THIS PRESENTATION IS INTENDED TO, OR SHALL HAVE THE EFFECT OF:

• CREATING ANY WARRANTY OR REPRESENTATION FROM IBM (OR ITS AFFILIATES OR ITS ORTHEIR SUPPLIERS AND/OR LICENSORS); OR

• ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENTGOVERNING THE USE OF IBM SOFTWARE.

IBM’s statements regarding its plans, directions, and intent are subject to change orwithdrawal without notice at IBM’s sole discretion. Information regarding potentialfuture products is intended to outline our general product direction and it should notbe relied on in making a purchasing decision. The information mentioned regardingpotential future products is not a commitment, promise, or legal obligation to deliverany material, code or functionality. Information about potential future products maynot be incorporated into any contract. The development, release, and timing of anyfuture features or functionality described for our products remains at our solediscretion.

THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE.

IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS PRESENTATION OR ANY OTHER DOCUMENTATION.

3 © 2015 IBM Corporation

Agenda

High-Level Overview

Streamtool General Operation

Streamtool Interactive Mode

Demo

Questions?

4 © 2015 IBM Corporation

High-Level Overview

Streamtool is a command line interface used to control InfoSphere Streams

features.

5 © 2015 IBM Corporation

Streamtool General Operation

Before using streamtool, source streamsprofile.sh in the Streams install bin

directory which will set the following environment variables:

– STREAMS_INSTALL=<InfoSphere_Streams install directory>

– Adds STREAMS_INSTALL directory to the PATH

– STREAMS_DOMAIN_ID = StreamsDomain (if not already set)

– STREAMS_INSTANCE_ID = STREAMS_INSTANCE_IID (if set)

– STREAMS_INSTANCE_ID = StreamsInstance (if not already set)

6 © 2015 IBM Corporation

Streamtool General Operation

When starting streamtool the following environment variables will be checked

and used if the appropriate –option is not provided:

– For the –zkconnect option: STREAMS_ZKCONNECT

– For the -d or --domain-id option: STREAMS_DOMAIN_ID

– For the -i or --instance-id option: STREAMS_INSTANCE_ID

– For the -U or –User option: STREAMS_USER_ID

7 © 2015 IBM Corporation

Streamtool General Operation

Changed streamtool commands are listed in the Overview > Welcome > Whats

Changed? Section of: IBM InfoSphere Streams Version 4.0 documentation

8 © 2015 IBM Corporation

Streamtool Interactive Mode

Streamtool interactive mode is a new shell environment for streamtool

– To enter interactive mode simply type “streamtool” with no command.

Streamtool interactive mode caches commonly used options:

– Authenticated user and passwords

– Active domain id

– Active instance id

– Previously entered session commands – available by hitting up and down

arrow keys.

Authenticated

userActive

domain

Active

instance

Streamtool interactive mode prompt

[streamtool <user@domain.instance>]

9 © 2015 IBM Corporation

Streamtool Interactive Mode

Additionally streamtool interactive mode provides helper functions which are

executed when the <tab> key is pressed. The following helper functions are

available:

– Streamtool command names (start typing streamtool command then hit <tab>)

lists commands starting with the letters typed if any.

– Domain ids (hit <tab> after -d option) lists domain ids starting with the letters

typed if any.

– File names (hit <tab> on file name options) lists files in current directory starting

with the letters typed if any.

– Man command (hit <tab> after typing man cmd) lists man topics starting with

the letters typed if any.

– Help command (hit <tab> after typing help cmd) lists help topics starting with

the letters typed if any.

– Properties commands (hit <tab> after any domain or instance property cmd or

option) lists domain or instance properties starting with the letters typed if any.

10 © 2015 IBM Corporation

Demo

Demo of streamtool interactive mode

11 © 2015 IBM Corporation

Demo on Streamsdev

There is a video available on StreamsDev website with these and other

helpful tips on streamtool use:

Streams 4.0 — Expert Advice on Environment Variables

12 © 2015 IBM Corporation

Questions?