Installing TIBCO SmartSockets

You need to read the README file and this installation guide to understand the installation process.

Step 2

Log on to a computer that has access to the directory in which SmartSockets is to be installed. If you are installing from CDROM, the architecture of the computer must be compatible with the architecture of the product CDROM. For example, an HP-UX Version 11.x CDROM can be installed on an HP-UX Version 11.x workstation but not on a Solaris Version 2.x workstation.

Step 3

Ensure the system on which you want to install SmartSockets meets all the hardware and software requirements described in Chapter 2, System Requirements.

Step 4

Download the TIBCO SmartSockets installation package, or access the release package from the CDROM. The file name is:

TIB_ss_num_platform.tar

where num is the SmartSockets software release number and platform is the platform and operating system. For example, filename might be:

TIB_ss_6.8.0_s4_sol57_CC.tar

Change to the directory in which SmartSockets is to be installed.

For example:

cd /usr/local

Untar the product distribution. For example:

tar xvf TIB_ss_6.8.0_s4_sol57_CC.tar

Run the /installSS script. For example:

$ ./installSS

This creates the SmartSockets directory ss68 and unpacks the SmartSockets subsets. The subsets are described in Structure of the Product Release.

The install script guides you through the rest of the installation process. You can stop the installation process at anytime by sending an INTERRUPT signal, usually a Ctrl-c. However, stop the installation script only when install is prompting you for information. If install is stopped while it is in the middle of accessing the drive or modifying the software, the software can be corrupted and you must reinstall the software from the beginning.

Read the TIBCO SmartSockets license agreement.

During the installation, you are prompted to read the TIBCO license agreement. You must agree to the TIBCO license agreement to install SmartSockets. Enter y to accept the license agreement. If you do not agree, enter n to exit the installation.

Select the debug or optimized installation for SmartSockets.

SmartSockets offers two types of installation. The optimized only installation installs just the optimized version of the SmartSockets binary files. The debug and optimized installation installs both the optimized and debug binary files. During the SmartSockets installation, you are prompted to select a installation type:

Would you like to install optimized only version? [y]:

Entering y installs the optimized only version of the SmartSockets binary files. Enter n if you want to install both the optimized and debug versions. If you enter n, the next prompt is:

Would you like to install both optimzed and debug version? [y]:

Enter y to install both the optimized and debug versions of SmartSockets binary files.

When the installation in complete, you have the option to view the SmartSockets README. Enter y to display the README, or n to continue.

Change to the ss68 directory:

cd ss68

Now use the rtmove script to set up the shell scripts.

install/rtmove

Step 5

On UNIX, root or super user privilege is not required to run an RTserver. RTserver is a normal user process.

To run SmartSockets, you must add a SmartSockets script to your command interpreter (also called a shell) startup script. This startup shell script is usually located in your home directory, $HOME. The process of adding the SmartSockets script is not automated because startup shell scripts vary.

C shell (csh)

Bourne shell (sh)

Korn shell (ksh)

enhanced C shell (tcsh)

GNU Bourne Again shell (bash)

Contact your system administrator if you are unsure of which shell a user account is using.

Add the rtinit script to the startup shell script.

C Shell and Enhanced C Shell

For C shell and enhanced C shell users, the script rtinit.csh should be used. The rtinit.csh script sets or modifies several environment variables.

Add this line to the C shell startup script $HOME/.cshrc:

source install_dir/ss68/bin/rtinit.csh

Add the line towards the end of a user’s $HOME/.cshrc file, so that the settings in rtinit.csh are applied last. For more information on rtinit.csh, see the information for rtinit.csh in the TIBCO SmartSockets Utilities reference.

Bourne Shell, Korn Shell, and Bourne Again Shell

For Bourne shell, Korn shell, and Bourne Again shell users, the script rtinit.sh should be used. The rtinit.sh script sets or modifies several environment variables. Add this line to the shell startup script $HOME/.profile:

. install_dir/ss68/bin/rtinit.sh

Add the line towards the end of your $HOME/.profile file, so that the settings in rtinit.sh are applied last. For more information on rtinit.sh, see the information for rtinit.sh in the TIBCO SmartSockets Utilities reference.

Verify that the SmartSockets environment is properly set up.

Many users have a conditional exit in their $HOME/.cshrc or $HOME/.profile files that prevent certain commands from being executed if the invocation is non-interactive (such as when RTmon is being invoked from a script). The standard C shell test for an interactive login is:

if (! $?prompt) then exit endif

The line that invokes either the rtinit.csh or rtinit.sh script should appear before this conditional exit, or the SmartSockets environment is not properly set up, and the shell responds with a statement similar to that which follows a non-interactive login:

rtmon: Command not found.

Before you run the examples you must set up an account.

To have the changes made to a .cshrc file take effect immediately, use this command:

$ source $HOME/.cshrc

When using Bourne shell and Korn shell, use this command:

$ . $HOME/.profile