Installing StreamBase on Solaris

This topic explains how to install StreamBase on Sun® Solaris™ systems and perform the initial set of post-installation tasks.

Before You Install

Before you install StreamBase on Solaris, use this checklist:

  1. The target node's resources (CPU, RAM, disk capacity) must meet or exceed the minimum values described on the Supported Configurations page.

  2. If you plan to install the StreamBase kit into a directory that requires root access, such as /opt or /usr/local, you must have access to the root account on the target node. (You can install StreamBase into another area, such as a home directory, and will not need root access.)

  3. The target node must be running a supported Solaris operating system release, as listed on the Supported Configurations page.

  4. To run StreamBase applications, you must have a Sun JDK installed. StreamBase kits for all platforms include the runtime components of a JDK for private use by StreamBase Studio and StreamBase Server. To use an external JDK instead, follow the steps in Using an External JDK.

Important

If you installed a prior version of StreamBase, you must uninstall it before proceeding with this installation. See the section Uninstalling StreamBase on Solaris near the end of this topic, then return here.

Installation on a Single Machine

Note

You must use the Solaris /usr/bin/tar (not Gnu tar) to expand and install the StreamBase distribution files.

Follow these steps to install StreamBase on a single node in your Solaris development network:

  1. If you are going to install to an /opt or /usr/local subdirectory, or any other location that requires root access, log into the root account. This step is not necessary if you will install StreamBase into a non-privileged area, such as a home directory.

  2. Insert the StreamBase for Solaris CD. If automount is not enabled, mount the cdrom.

    If you downloaded an installation kit provided by StreamBase, note its location so that you can reference it when using the example commands shown in this section.

  3. The StreamBase kit on Solaris is provided in a single tar file: streambase-R.R.R.-DDD.solaris.sparc32.tar.gz

    In the filename, R.R.R refers to the release number, and DDD refers to the date and time the installation CD was built.

    On the product CD, the file is in the ./tarfiles directory.

    Note

    StreamBase is not available as a package kit for Solaris.

  4. Installing StreamBase:

    To install StreamBase in a privileged area such as /opt/streambase/, as root, enter commands such as the following. This example assumes that a downloaded StreamBase kit temporarily resides in the example /home/sbuser/kits directory. If you are using the product CD, instead specify the mounted CD's path plus the streambase-*.tar.gz filename. 

    cd /opt
gunzip -c /home/sbuser/kits/streambase-*.tar.gz | tar -xf -

    These commands install StreamBase into /opt/streambase.

    To install StreamBase into a non-privileged area, use commands such as the following. This example assumes that a downloaded StreamBase kit temporarily resides in a ~/kits directory. If you are using the product CD, instead specify the mounted CD's path plus the streambase-*.tar.gz filename. 

    mkdir /home/sbuser/streambase
cd /home/sbuser/streambase
gunzip -c /home/sbuser/kits/streambase-*.tar.gz | tar -xf -

Post-Installation: Licensing

After installing StreamBase, configure the StreamBase license as described in the Configuring a StreamBase License topic.

Initial Configuration on a Single Machine

The post-installation tasks include the following:

Setting Up the StreamBase Environment

After unpacking the tar file, run the following command to set up the environment: 

eval `streambase-install-dir/bin/sb-config --env`

This command sets the STREAMBASE_HOME environment variable and modifies the PATH, LD_LIBRARY_PATH, and MANPATH environment variables. Note the use of the backquote character ( ` ) in the preceding example. It is not a single quote character.

Setting Up SSH Daemon (if needed)

To support StreamBase Studio users on Windows or Linux client machines connecting to the remote Solaris machine where StreamBase Server is installed, your Solaris host must have an SSH daemon running with TCP port forwarding enabled, and password authentication enabled. To enable TCP port forwarding, ensure that your /etc/ssh/sshd_config file does not contain the following lines: 

AllowTcpForwarding No
PasswordAuthentication No

If you update the sshd_config, remember to restart your SSH daemon before StreamBase Studio users start their sessions.

Note

Remote users who connect from StreamBase Studio to your host must also have valid UNIX accounts on the machine where you install StreamBase Server. Remote users connecting StreamBase Studio from their Windows or Linux machine must provide valid username and password credentials to connect to your server.

Configuration Files

By default, StreamBase uses skeleton configuration files. To customize a configuration file for use with one of your applications, use the -s flag and pipe the output to a file. For example: 

sbd -s > /my/apps/sbd.sbconf

For details about the StreamBase configuration files, see StreamBase Server Configuration XML.

Uninstalling StreamBase on Solaris

If you installed a prior version of StreamBase, uninstall it before proceeding with the current version installation. To uninstall StreamBase on Solaris, follow these steps:

  1. Log into the root account, if you installed the product in an area that requires root access, such as /opt/streambase.

  2. Confirm that the StreamBase Server (sbd) is not running on this machine: 

    ps -A | grep sbd

    If StreamBase Server is running, confirm that the server can be shut down without disrupting StreamBase users or applications. At the appropriate time, enter the sbadmin shutdown command.

  3. If you installed StreamBase from a streambase-*.tar.gz kit, use the rm -rf command to remove the StreamBase installation directory.

Related Topics

Back to Top ^