Copyright © Cloud Software Group, Inc. All Rights Reserved

Installing on UNIX Systems

Supported Platforms

See the TIBCO ActiveMatrix BusinessWorks readme file for a list of supported platforms.

See Installer Disk Space Requirements in Temporary Area for additional disk space requirements.

TIBCO Runtime Agent Installation before TIBCO ActiveMatrix BusinessWorks

Before you can install TIBCO ActiveMatrix BusinessWorks, you must install TIBCO Runtime Agent. If you choose the Typical option during installation, the installer places all libraries and other products required by TIBCO ActiveMatrix BusinessWorks into the TIBCO HOME directory.

Installer Account

You must have administrator privileges for the machine on which TIBCO ActiveMatrix BusinessWorks is installed. If you do not have administrator privileges, the installer exits. You must then log out of the system and log in as a user with the required privileges, or request your system administrator to assign the privileges to your account.

If you intend to install the product on a network drive, you must ensure that the account used for installation has permission to access the network drive.

Installer Log File

The installer log file tibco_universal_installer.timestamp.username_install.log, is written to the User_Home\.TIBCO\install_timestamp directory. For example, on Windows the installer log is written to the C:\Documents and Settings\user-name\.TIBCO\install_timestamp directory. The installer log file captures the following information:

•	Installation environment details such as user who invoked the installer, hostname, java home in the environment, Operating System details, and so on.

•	List of assemblies installed

Windows Environment

A windows environment such as CDE (that is, X Windows) is required to run the installer in GUI mode. It is not required for a console installation.

Installing TIBCO ActiveMatrix BusinessWorks on UNIX

After unpacking the software and accepting the license agreement, you can choose to perform a typical install or custom install.

•	A typical install has minimal prompts and installs standard components in default locations.

•	A custom install prompts you to choose which pieces of the product suite to install and installs only those components.

If you are installing for the first time, you must specify the installation directory where the products in this product suite is installed. The default installation directory depends on who performs the installation:

•	For root users, the default installation directory is /opt/tibco.

•	For non-root users, the default installation directory is /<myhome>/tibco, where <myhome> is the home directory of the user.

•	If installing TIBCO ActiveMatrix BusinessWorks on AIX, use a non-root user account.

Use one of the following modes to install the software. It is assumed you are installing TIBCO ActiveMatrix BusinessWorks on Solaris 5.10

Install Using GUI Mode

GUI Mode enables you to enter input values in the panels. Type the following in a terminal window:

 

TIBCOUniversalInstaller-sol.bin

Install Using Console Mode

Console mode allows you to install the software in a non-windows environment. The installer prompts you for values. Type the following in a terminal window:

 

TIBCOUniversalInstaller-sol.bin -is:javaconsole -console

When running in console mode, you can move through the installation process as described next:

 

Enter Key = Moves forward in the installer

2 = Goes back to previous screen

3 = Cancels the Wizard and exits the installation or uninstallation

4 = Redisplays the current screen

Install Using Silent Mode with Default Values

The following procedure explains how to install a TIBCO ActiveMatrix BusinessWorks product in silent mode. The TIBCOUniversalInstaller.silent file is packaged in the directory that contains the universal installer. You must edit the file with information for your environment before launching the silent installation. The file includes comments that describe the installation properties you can set.

While you can use the TIBCOUniversalInstaller.silent file, it is recommended to copy the file to a different name and edit that file for the silent install.

If errors occur during installation, they are listed in the installation log file (see the User_Home/.TIBCO directory).

To install TIBCO ActiveMatrix BusinessWorks in the Silent mode with Default values:

1.	Open the physical media or download the TIBCO ActiveMatrix BusinessWorks product package.

2.	Extract the TIBCO ActiveMatrix BusinessWorks product archive file to a temporary directory.

3.	Using a console window, navigate to the temporary directory that contains the universal installer.

4.	Copy the TIBCOUniversalInstaller-BW_<version>.silent file and rename the copy.

5.	Using a text editor, open the copied file and update the install location, and features to install.

6.	Run the installer using this command line:

TIBCOUniversalInstaller.bin -silent -V responseFile="myfilename.silent"

 

Postinstallation

All TIBCO ActiveMatrix BusinessWorks users must have read, write, and execute permissions for the following directories:

 

$TIBCO_HOME/bw/5.12/bin

$TIBCO_HOME/bw/5.12/bin/logs

$TIBCO_HOME/tra/5.9/logs

For example, if TIBCO ActiveMatrix BusinessWorks has been installed in /opt/tibco, the user who installed TIBCO ActiveMatrix BusinessWorks should execute the following commands:

 

% chmod 777 /opt/tibco/bw/5.12/bin/

% chmod 777 /opt/tibco/bw/5.12/bin/logs

% chmod 777 /opt/tibco/tra/5.9/logs

In addition, the palettes directory ($TIBCO_HOME/bw/5.12/lib/palettes) must be writable by all users who use TIBCO Designer. Users must have write permission for this directory to be able to use the Java activity's Compile button.

Alternatively, change the Java activity's compilation directory by changing the value of java.property.javaCode in the .tra file that is used to start TIBCO ActiveMatrix BusinessWorks (designer.tra for the TIBCO Designer GUI or the appropriate .tra file for the engine if running from a deployment).

Uninstalling TIBCO ActiveMatrix BusinessWorks

If another product is dependent on the product you want to uninstall, you are informed that you must uninstall the other product first.

To uninstall TIBCO ActiveMatrix BusinessWorks on Microsoft Windows:

1.	Run TIBCO Universal Installer to uninstall the product.

2.	In TIBCO_HOME/tools/universal_installer/, run the TIBCOUniversalInstaller.

3.	In the TIBCOInstallationManager, select Uninstall Products from a TIBCO Home Location and click Next.

4.	Click Next on the Welcome screen.

5.	Select an uninstall option and click Next:

•	Custom Uninstall: You can select the products to be removed.

•	Typical Uninstall: Removes all the products in the TIBCO_HOME folder.

6.	If you selected Custom Uninstall, select the check box next to the product to uninstall and click Uninstall.

7.	Review the product to be uninstalled and click Uninstall.

8.	When prompted about the clean up of the /tools directory, click Yes, clean it up.

9.	Click Finish in the Post Uninstall Summary screen to exit the uninstall wizard.

Copyright © Cloud Software Group, Inc. All Rights Reserved