1.0 Installing

Edit me

Before you can use the Python Application API, you must complete the following tasks:

  1. Install IBM Streams Version 4.0.1 (or later) or IBM Streams Quick Start Edition Version 4.0.1 (or later):

  2. Ensure that you configure the IBM Streams product environment variable by entering the following command:

     source product-installation-root-directory/4.n.n.n/bin/streamsprofile.sh
    

    Tip: Add the source command to your home-directory/.bashrc shell initialization file. Otherwise, you must enter the command every time you start IBM Streams. For example, if the product is installed in the /home/streamsadmin/InfoSphere_Streams/4.2.0.0 directory, add the following line to your .bashrc file:

     source /home/streamsadmin/InfoSphere_Streams/4.2.0.0/bin/streamsprofile.sh
    
  3. Download the IBM Streams Topology toolkit, which includes the Python Application API. You can download the most recent version of the toolkit from the IBMStreams organization on GitHub from the streamsx.topology Releases page. If you are using IBM Streams 4.2 or later then this step is optional as the toolkit is included at $STREAMS_INSTALL/toolkits/com.ibm.streamsx.topology.

    After the toolkit downloads, extract it to your file system.

  4. Install a supported version of Python. The Python Application API has been tested with Python 3.5.1. You can choose from one of these options:

    • Recommended - Anaconda 4.0.0 or later, which includes Python 3.5.0 https://www.continuum.io/downloads.

    • CPython 3.5.0 or later https://www.python.org.

      If building Python from source, remember to pass --enable-shared as a parameter to configure. After installation, set LD_LIBRARY_PATH to Python_Install>/lib.

    To build IBM Streams application bundles with the Python Application API that can be submitted to your Bluemix Streaming Analytics service you must:

    • use Anaconda 4.1.1 (Python 3.5 version) or later
    • install Anaconda at /disk1/opt/Anaconda3 on the machine where you execute the Python code that builds the topology and submits it to the BUNDLE context
  5. Include the fully qualified path of the com.ibm.streamsx.topology/opt/python/packages directory in the PYTHONPATH environment variable. For example:

     export PYTHONPATH=/home/myuser/download/com.ibm.streamsx.topology/opt/python/packages:$PYTHONPATH