Depending on which toolkit / operators you are using, additional RPMs and client libraries are required to be installed.
Some operators require certain environment variables to be set. This is a summary of the additional setup required by the specialized toolkits.


Toolkit:  com.ibm.streams.dataexplorer

Supported Data Explorer Required Data Explorer Libraries Environment Variables
Data Explorer v8.2-2 and v8.2-3 <Data Explorer Install>/AppBuilder/bigindex.zip
  • BIGSEARCH_JAR = <Location of bigindex.zip>
Data Explorer v9.0-0 <Data Explorer Install>/BigIndex/bigindex.zip
  • BIGSEARCH_JAR = <Location of bigindex.zip>

Toolkit:  com.ibm.streams.db

Required RPMs

OS Required RPMs
SLES 11 on x86_64 systems
  • perl-Encode-JIS2K

Supported DBs and Environment Variables

Limitations:  The vendors that provide these Databases have not provided native client versions for PowerLinux: Aster, HP Vertica, solidDB and Teradata.   PPC is not supported by Streams when running against these databases.

Supported Databases Required ODBC clients Environment Variables
Aster Database v6.0 UnixODBC v2.3 or later with an Aster driver
  • STREAMS_ADAPTERS_ODBC_UNIX_OTHER=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
HP Vertica v7.0.1 UnixODBC v2.3 or later with Vertical Driver
  • STREAMS_ADAPTERS_ODBC_UNIX_OTHER=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM InfoSphere BigInsights v3.0 (using BigSQL v1.0 APIs) BigSQL ODBC
  • STREAMS_ADAPTERS_ODBC_BIGSQL=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM InfoSphere BigInsights v3.0, v4.0 (using BigSQL v3.0 APIs) DB2 ODBC
  • STREAMS_ADAPTERS_ODBC_DB2=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM DB2 Data Server Driver Package v9.7 DB2 ODBC
  • STREAMS_ADAPTERS_ODBC_DB2=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM DB2 Data Server Driver Package 10.5 DB2 ODBC
  • STREAMS_ADAPTERS_ODBC_DB2=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM Informix Dynamic Server v11.50, 11.70, 12.10 Informix ODBC
  • STREAMS_ADAPTERS_ODBC_IDS=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM Netezza v7.0 UnixODBC v2.3.0 with Netezza Driver
  • STREAMS_ADAPTERS_ODBC_NETEZZA=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
IBM solidDB v7.0 UnixODBC v2.3.0 with solidDB client driver
  • STREAMS_ADAPTERS_ODBC_SOLID=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
Microsoft SQL Server v2008 or 2012 Unix ODBC v2.3 or later with Microsoft SQL Server ODBC driver 1.0 for Linux
  • STREAMS_ADAPTERS_ODBC_SQLSERVER=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
MySQL Databaase v5.6 UnixODBC v2.3.1 or later with MySQL driver OR
MySQL ODBC Connector Driver v5.3.2 or later
  • STREAMS_ADAPTERS_ODBC_MYSQL=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
Oracle Database 12c Release1 UnixODBC v2.3.1 or later with Oracle driver
  • STREAMS_ADAPTERS_ODBC_ORACLE=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>
Teradata Database v14.0 or 14.10 DataDirect ODBC driver for Teradata
  • STREAMS_ADAPTERS_ODBC_UNIX_OTHER=<any value>
  • STREAMS_ADAPTERS_ODBC_INCPATH¬†= <location of include path to ODBC driver>
  • STREAMS_ADAPTERS_ODBC_LIBPATH = <location of library directories to ODBC driver>

Toolkit:  com.ibm.streams.financial

Limitation:  The Financial Services Toolkit is not supported on RHEL 7 platforms.

OS Required RPMs
RHEL 6 and CenOS 6 on x86
  • gucharmap
  • perl-devel
  • perl-Config-Simple
  • libxml2
  • kernel-devel
RHEL 6 on IBM¬ģ Power Systems‚ĄĘ
  • gucharmap
  • libxml2
  • perl-YAML-Syck
SLES 11 on x86_64 systems
  • gucharmap
  • libxml2
  • perl-YAML-Syck

Toolkit:  com.ibm.streams.mining

Limitation:  The Mining Toolkit is not supported on RHEL 7 platforms.

OS Required RPMs
RHEL 6 and CenOS 6 on x86 and ppc
  • compat-libstdc++-33
SLES 11 on x86_64 systems
  • libstdc++33

Toolkit:  com.ibm.streams.rproject

OS Required RPMs
All platforms
  • R-core
  • R-core-devel
  • R-java
  • R-java-devel

Toolkit:  com.ibm.streams.rules

Supported Rule Engines Required Libraries from Rule Engine Environment Variables
ODM 8.5, 8.5.1 and 8.6 <ODM Install>/ executionserver/lib ODM_HOME = <Location of ODM Install that contains the executionserver directory>

Toolkit:  com.ibm.streams.text

The following table summarises all supported BigInsight versions by the Text toolkit.¬† For each of the nodes, where the Text toolkit operators can run, the listed ‚ÄúRequired Libraries‚ÄĚ must be installed and the specified environment variables must be set.

Please note that the following is only needed if the text analytic modules (TAM) files are located in HDFS.

Supported BigInsight version Required Libraries from BigInsight Environment Variables
BigInsight v3.0.x
BigInsight v4.0.x
Hadoop client to access BigInsight remotely HADOOP_HOME=<install location of Hadoop client>

Toolkit:  com.ibm.streams.timeseries

The following RPMs are required to be installed on any nodes where Timeseries Toolkit operators can run.

OS Required RPMs
All platforms
  • boost
  • boost-devel
  • libxml2
  • libxml2-devel

Toolkit:  com.ibm.streamsx.hbase

The following table summarises all supported HBase versions by the HBase toolkit.  Prior to Streams 4.2, the HBase client wass packaged as part of the toolkit, therefore, no additional libraries required to be installed.

By default, the HBase operator looks for HBase configuration files from HBASE_HOME/conf/hbase-site.xml.  The specified environment variable is optional and does not need to be set if the user uses the hbaseSite parameter to tell the operators where to locate the hbase-site.xml file.

 

If your Streams version is older than 4.2:

Supported HBase versions Required Libraries from HBase Environment Variables
HBase 0.96 and up
BigInsight v3.0
BigInsight v4.0
Clients are packaged as part of the toolkit, so no additional libraries are needed in this case. If hbaseSite parameter is not set in the operator invocation:HBASE_HOME=<location of conf directory that contains hbase-site.xml>e.g. HBASE_HOME/conf/hbase-site.xml

 

Streams 4.2+

Note: if your HBase or BigInsights server is not on the same host where Streams is installed, you will need to copy the folder(s) listed under “Required Libraries” to a directory on the host¬† where Streams is running.¬† Then set the environment variables relative to the directory where the files were copied to.

Supported HBase versions Required Libraries from HBase Environment Variables
HBase 0.96 and up  /hbase-install-dir/lib

 

 

Set HBASE_HOME to <hbase_install>

HBASE_HOME must also be set at runtime.

 

BigInsights v3.0
  • /BigInsights_install/IHC
  • /BigInsights_install/hbase
HADOOP_HOME= <BigInsights_install>/IHC.

HBASE_HOME=<Biginsights_install>/hbase HBASE_HOME and HADOOP_HOME must also be set at runtime.
BigInsights v4.0+
  • /BigInsights_Install/hadoop
  • BigInsights_Install/hbase
  • BigInsights_Install/hadoop-hdfs
HBASE_HOME= <Biginsights_install>/hbase


 HADOOP_HOME= <Biginsights_install>/hadoop

Toolkit:  com.ibm.streamsx.hdfs

Supported Hadoop Required Libraries Environment Variables
InfoSphere BigInsight v2.1.2, 3.0.0x, 4.0.x
  • <BigInsight Install>/IHC/*
  • <BigInsight Install>/hadoop-conf/*
  • HADOOP_HOME=<location of IHC directory from BI install>
  • JAVA_HOME=<location of Java install>
  • BIGINSIGHTS_HOME=<location of BI install>
InfoSphere BigInsight v2.1.2, 3.0.0x, 4.0.x running on GPFS
  • <BigInsight Install>/IHC/*
  • <BigInsight Install>/hadoop-conf/*
  • <BigInsight Install>/lib/biginsight-gpf.jar

 

  • HADOOP_HOME=<location of IHC directory from BI install>
  • JAVA_HOME=<location of Java install>
  • BIGINSIGHTS_HOME=<location of BI install>
Apache Hadoop v2.x
  • <Hadoop Install>/share/hadoop/hdfs/*
  • <Hadoop Install>/share/hadoop/hdfs/common/*
  • <Hadoop Install>/share/hadoop/hdfs/common/lib/*
  • <Hadoop Install>/lib/*
  • <Hadoop Install>/client/*
  • <Hadoop Install>/etc/hadoop/*

 

  • HADOOP_HOME=<location of Hadoop install>
  • JAVA_HOME=<location of Java install>
Cloudera v4 and v5
  • <Hadoop Install>/share/hadoop/hdfs/*
  • <Hadoop Install>/share/hadoop/hdfs/common/*
  • <Hadoop Install>/share/hadoop/hdfs/common/lib/*
  • <Hadoop Install>/lib/*
  • <Hadoop Install>/client/*
  • <Hadoop Install>/etc/hadoop/*
  • HADOOP_HOME=<location of Hadoop install>
  • JAVA_HOME=<location of Java install>
Hortonworks Data Platform (HDP) 2.2
  • <Hadoop Install>/share/hadoop/hdfs/*
  • <Hadoop Install>/share/hadoop/hdfs/common/*
  • <Hadoop Install>/share/hadoop/hdfs/common/lib/*
  • <Hadoop Install>/lib/*
  • <Hadoop Install>/client/*
  • <Hadoop Install>/etc/hadoop/*

 

  • HADOOP_HOME=<location of Hadoop install>
  • JAVA_HOME=<location of Java install>

Toolkit:  com.ibm.streamsx.inet

OS Required RPMs
All platforms
  • libcurl
  • libcurl-devel

Toolkit:  com.ibm.streamsx.messaging

The following table summarises all messaging servers supported by the JMSSource and JMSSink operators.¬† For all nodes, where the JMS operators can be run, the listed ‚Äúrequired libraries‚ÄĚ must be installed and the specified environment variables must be set.

Supported Messaging Server Required Libraries Environment Variables
Apache Active MQ v5.7 and up Active MQ client STREAMS_MESSAGING_AMQ_HOME=<location of Active MQ home>
IBM Websphere MQ v7.5 and v8.0 Websphere MQ client
http://www-01.ibm.com/software/integration/wmq/clients/
STREAMS_MESSAGING_WMQ_HOME=<location of Websphere MQ home>

 

The following table summarises all messaging servers supported by the XMSSource and XMSSink operators.¬† For all nodes, where the XMS operators can be run, the listed ‚Äúrequired libraries‚ÄĚ must be installed and the specified environment variables must be set.

Supported Messaging Servers Required Libraries to be installed Environment Variables Limitations
IBM Websphere MQ v7.5 and v8.0 Websphere MQ XMS Client
http://www-01.ibm.com/support/docview.wss?uid=swg24007092
XMS_HOME=<install location of XMS client> The XMS operators are not supported on the following platforms.

  • IBM Power Systems
  • Linux RHEL 7

 

For Kafka and MQTT, the toolkit is packaged with required clients, no additional install is necessary.

Join The Discussion