This documentation supports the on-premises releases of StreamWeaver upto version 3.16. For the SaaS releases, see the BMC Helix Intelligent Integrations documentation.

Install Single Node "All In One"


Linux (Docker Install)

  1. Verify Hardware & Software requirements
  2. Obtain username/password for StreamWeaver docker repository
  3. Download the bits.
  4. Copy the zip to a directory on the machine (example: /tmp)
  5. Unzip the file and copy to /opt  creating a directory structure like:
    1. [root@centos streamweaver]# ls -lsa
      total 8
      0 drwxr-xr-x.  8 root root  120 Sep 20 14:17 .
      0 drwxr-xr-x.  5 root    root      54 Sep 20 14:58 ..
      0 drwxr-xr-x.  5 root root  259 Sep 20 14:17 bin
      0 drwxr-xr-x.  4 root root  240 Sep 20 14:17 conf
      0 drwxr-xr-x. 14 root root  199 Sep 20 14:17 content-packs
      0 drwxr-xr-x.  7 root root   78 Sep 20 14:17 data
      8 -rwxr--r--.  1 root root 5263 Sep 20 14:17 docker-compose.yaml
      0 drwxr-xr-x.  3 root root   21 Sep 20 14:17 systemloader
      0 drwxr-xr-x.  2 root root   20 Sep 20 14:17 tmp
  6. Validate that docker is installed and enabled for current user
docker run hello-world

    1. If docker engine is not installed, follow the instructions on the Docker site 
    2. Install docker-compose - follow instructions on Docker site
  1. Log into StreamWeaver docker repository

    docker login swpdevacr.azurecr.io
    Username: [provided by support@streamweaver.com]
    Password: [provided by support@streamweaver.com]
  2. Run docker-compose.  This will download images from the public and StreamWeaver docker repositories.

    docker-compose up -d;
  3. To stop 

    docker-compose down;

Windows


Step by step instruction on installing and configure StreamWeaver components as a service in Windows platform.

Instructions

Install and configure as a services

  1. Verify Hardware & Software requirements
  2. Set the JAVA_HOME "System environment" variable (for Cassandra to start up properly)

    Screen Shot 2020-05-06 at 4.41.47 PM.png

  3. Download the bits. ( download link will be provided)
  4. unzip the package in the desired directory
  5. Navigate to <path>/streamweaver/bin/ and execute “install-windows-services.bat"

    f4e3452f-a544-4328-885a-ab57fd7d9c53.png

  6. All 5 services will be running now, Screenshot from services.msc panel


b63e5d27-b6a3-48ee-9cfe-f587d5ffb3da.png

Note : To stop all Streamweaver services by executing:

<path>/streamweaver/bin/stop-all-services.bat

c1047fd7-99bb-4261-8200-34f105e06270.png

.. or to start all 

<path>/streamweaver/bin/start-all-services.bat



Linux (v3.0 and earlier)

  1. Verify Hardware & Software requirements
  2. Verify user account privilege is set to "root"
  3. Download the bits.
  4. Copy the zip to a directory on the machine (example: /tmp)
  5. Unzip contents to `/opt`, which will create a `streamweaver` directory

    unzip swp*.zip -d /opt

    Note: Install on custom path - unzip swp*.zip -d <custom path>

  6. Install & start service

    cp /opt/streamweaver/systemloader/systemv/etc/default/* /etc/default
    cp /opt/streamweaver/systemloader/systemv/etc/init.d/* /etc/init.d
    service streamweaver start
    sudo chkconfig --add streamweaver

    Note : If using custom application path in both scripts for the variable "Install_dir" and then perform the copy commands
    a. vi <custom path>/streamweaver/systemloader/systemv/etc/default/streamweaver , update the variable "Install_dir" to custom path

    INSTALL_DIR="/opt/alternate/streamweaver"     

    b. vi <custom path>/streamweaver/systemloader/systemv/etc/init.d/streamweaver , update the variable "Install_dir" to custom path

    INSTALL_DIR="/opt/alternate/streamweaver"

    c. use the custom desired path and copy over the scripts.

  7. Get status of processes
/opt/streamweaver/bin/swp status -w 3


Service                 State     Elapsed time   PID     Message
---------------------------------------------------------------------------------------
zookeeper               Running   3.231 d        98787   healthy
kafka                   Running   3.231 d        98803   healthy
kafka-schema-registry   Running   3.231 d        98832   healthy
cassandra               Running   3.231 d        98850   healthy
swpallinone             Running   3.231 d        90267   healthy


Use these commands to control the StreamWeaver Platform:

Action

Command

Options

Start StreamWeaver

service streamweaver start


Verify StreamWeaver running

service streamweaver status

open a web browser and navigate to: http://<opstream host>:7457

Stop StreamWeaver

service streamweaver stop


Restart StreamWeaver

service streamweaver restart


Kill StreamWeaver

ps -ef | grep streamweaverkill -2 <Process ID>

if the process is hung, run these command

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*