TIBCO iProcess Server Objects (Java) Installation Guide · TIBCO iProcess Server Objects (Java) Installation Guide 4 |Chapter 1 Introduction 64-Bit Libraries Both 32-bit and 64-bit

TIBCO iProcess™ Server Objects (Java)

Installation GuideSoftware Release 11.3.0October 2010

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN LICENSE.PDF) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.TIB, TIBCO, Information Bus, The Power of Now, TIBCO Adapter, TIBCO iProcess, TIBCO BusinessWorks, TIBCO FormBuilder, and TIBCO General Interface are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.EJB, Java EE, J2EE, JMS and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. PLEASE SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.Copyright © 2002-2010 TIBCO Software Inc. ALL RIGHTS RESERVED.TIBCO Software Inc. Confidential Information

| iii

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

How to Contact TIBCO Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364-Bit Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Microsoft Visual C++ 2008 Redistributable Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2 Installing/Upgrading on Windows Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Installation/Upgrade Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Installed Files / Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Chapter 3 Installing/Upgrading on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Extracting the Installation Set from the Product DVD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Running the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Installed Files / Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1464-Bit Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 4 Removing the TIBCO iProcess Server Objects (Java) . . . . . . . . . . . . . . . . . . . . . . . 17

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Repairing/Removing Using the Setup Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Removing Using the Operating System Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Removing from Windows Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Removing from UNIX Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

TIBCO iProcess Server Objects (Java) Installation Guide

iv | Contents


| v

Preface

TIBCO iProcess™ Server Objects (Java) comprise a set of classes that are used to build applications that automate business processes. TIBCO iProcess Server Objects (Java) consist of an object model that provides access to the information and functionality needed in the client applications.

The objects in the TIBCO iProcess Server Objects (Java) object model can be used to start cases, present information on screens to users, manipulate work items, remind users when actions need to be taken, and monitor and control the flow through the business process.

This guide provides instructions on installing, upgrading, or removing TIBCO iProcess Server Objects (Java) from your system.

Topics

• Related Documentation, page vi

• How to Contact TIBCO Customer Support, page vii


vi | Related Documentation

Related Documentation

This section lists documentation resources you may find useful.

• TIBCO iProcess Server Objects (Java) Programmer’s Guide - This guide, which is provided on the distribution DVD, provides explanatory text about developing client applications using TIBCO iProcess Server Objects (Java). It includes subjects such as TIBCO iProcess Server Objects (Java) architecture, managing work items, managing cases, filtering work items and cases, etc.

• TIBCO iProcess Server Objects (Java) Release Notes - These notes, which are provided with each release of the TIBCO iProcess Server Objects (Java), describe enhancements and/or fixes that are implemented in each release, as well as any known issues that apply to that release of the software.

• TIBCO iProcess Server Objects (Java) On-Line Help - The on-line help system, which is installed as part of the software installation, provides object descriptions and syntax for the methods available to the client application programmer. The on-line help is available in the following location after the installation is complete:

Windows Systems:

InstallDir\Help\start.htm

UNIX Systems:

InstallDir/Help/start.htm

where InstallDir is the directory where you installed the TIBCO iProcess Server Objects (Java). The default directory is C:\Program Files\TIBCO\TIBCO iProcess Server Objects (Java) on Windows and /usr/sso on UNIX.

The start.htm file is used to start the HTML-based on-line help system using a browser (e.g., Internet Explorer or Firefox).

• TIBCO iProcess Server Objects (Java) Object Model Graphic - This provides a graphical representation of the object hierarchy for the TIBCO iProcess Server Objects (Java). This graphic is provided on the distribution DVD.

If you are installing on a 64-bit Windows machine, the default directory includes "(x86)", as follows: C:\Program Files (x86)\TIBCO\...


Preface | vii

How to Contact TIBCO Customer Support

For comments or problems with this manual or the software it addresses, please contact TIBCO Support as follows.

• For an overview of TIBCO Support, and information about getting started with TIBCO Product Support, visit this site:

http://www.tibco.com/services/support

• If you already have a valid maintenance or support contract, visit this site:

http://support.tibco.com

Entry to this site requires a username and password. If you do not have a username, you can request one.


http://www.tibco.com/services/support

http://support.tibco.com

viii | How to Contact TIBCO Customer Support


| 1

Chapter 1 Introduction

This chapter contains important information which you should read before you install or upgrade the TIBCO iProcess Server Objects (Java).

Topics

• Installation Overview, page 2

• System Requirements, page 3


2 | Chapter 1 Introduction

Installation Overview

This installation guide provides instructions on how to install, upgrade, or remove the TIBCO iProcess Server Objects (Java).

TIBCO iProcess Server Objects (Java) is available in three different programming interfaces:

• Standalone (also known as “JBase”) - This interface exposes functionality in the form of simple Java objects, i.e., it does not make use of remote objects. It is typically used when incorporating a broker application that is automatically processing work items arriving in a particular work queue.

• RMI - This interface uses Java’s Remote Method Invocation (RMI) technology. This allows the client to be located on a machine remote from the TIBCO iProcess Server Objects (Java).

• EJB - The Enterprise Java Beans (EJB) form of TIBCO iProcess Server Objects (Java) provides the ability to perform business logic functions through EJBs in the middle tier. This architecture, which makes use of a Java application server for scalability, conforms to the J2EE specification.

Note that new features have not been added to the EJB interface since version 10.3.0. This interface is not recommended for new applications.

On Windows systems, the installation program automatically installs all three of the available interfaces.

On UNIX systems, the installation script allows you to choose which of the interfaces you would like to install.


System Requirements | 3

System Requirements

The following lists system requirements for the TIBCO iProcess Server Objects (Java):

Description Requirement

Operating Systems TIBCO iProcess Server Objects (Java) can be installed on any of the following operating systems.

TIBCO supports native 32-bit and 64-bit on all listed operating systems.

• x86 and x64:— Microsoft Windows XP1

— Microsoft Windows Server 2003 — Microsoft Windows Vista Ultimate— Microsoft Windows Server 2008— Microsoft Windows 7 Professional— Red Hat Enterprise Linux, Version 4 and 5— SUSE Linux Enterprise Server 10 and 11— Solaris 10

• IBM RS/6000:— AIX 5.3— AIX 6.1

• HP PA-RISC:— HP-UX 11i Version 2 11.23

• HP Itanium:— HP-UX 11i Version 2 11.23— HP-UX 11i Version 3 11.31

• Sun SPARC: — Solaris 9-10

Java Runtime Environment (JRE)

Version 1.5 or 1.6 of the JRE is required for the TIBCO iProcess Server Objects (Java).

Application Server The RMI interface can run under any Application Server that is J2EE compliant.


4 | Chapter 1 Introduction

64-Bit LibrariesBoth 32-bit and 64-bit software is installed when you install the TIBCO iProcess Server Objects (Java). The 64-bit libraries are installed in a separate directory (\x64 on Windows and /lib64 on UNIX) below the directory in which you install the software. Link to the appropriate libraries for the JVM that you are using.

Microsoft Visual C++ 2008 Redistributable PackageTIBCO iProcess Server Objects (Java) was built with, and requires, the Microsoft Visual C++ 2008 Redistributable Package. Therefore, you must have the Microsoft Visual C++ 2008 Redistributable Package on Windows runtime machines that will be running applications developed with TIBCO iProcess Server Objects (Java) (i.e., the machine that contains the TIBCO iProcess Server Objects (Java) DLLs).

This redistributable package is required on your runtime machine regardless of the version of Microsoft Visual Studio used to develop your application.

The Microsoft Visual C++ 2008 Redistributable Package is not installed by default (although it is included when Microsoft Visual Studio 2008 is installed). You can determine if you have it installed on your machine by looking for "Microsoft Visual C++ 2008 Redistributable" in Add/Remove Programs.

If you do not have the redistributable package installed, download and install it using the following links:

x86:

http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en

x64:

http://www.microsoft.com/downloads/details.aspx?familyid=bd2a6171-e2d6-4230-b809-9a8d7548c1b6&displaylang=en

1. Microsoft has discontinued standard support for Windows XP. (Extended sup-port is still available, but must be purchased from Microsoft.) TIBCO will con-tinue to support iProcess Client on Windows XP. However, if a problem withiProcess Client is reported to TIBCO Support, and the problem is traced to theWindows XP operating system, TIBCO Support will be unable to assist furtherwith the resolution of that problem.


http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en

http://www.microsoft.com/downloads/details.aspx?familyid=bd2a6171-e2d6-4230-b809-9a8d7548c1b6&displaylang=en

| 5

Chapter 2 Installing/Upgrading on Windows Systems

This chapter explains how to install or upgrade TIBCO iProcess Server Objects (Java) on Windows systems.

Topics

• Installation/Upgrade Procedure, page 6

• Installed Files / Directories, page 8


6 | Chapter 2 Installing/Upgrading on Windows Systems

Installation/Upgrade Procedure

To install/upgrade TIBCO iProcess Server Objects (Java) on Windows, follow these steps:

1. Run the setup program. If you are installing/upgrading from:

— DVD: Run setup.exe from the DVD.

— a network server: Ask your network administrator for the location of setup.exe and run it from there.

2. Review the information in the TIBCO iProcess Server Objects splash screen, then click Next. The TIBCO End User License Agreement is displayed.

3. Read the license agreement. To continue with the installation, click I Agree to accept the agreement, then click Next.

If you do not agree with the license agreement, you can cancel the installation by clicking Cancel.

The Select Installation Folder dialog is displayed.

4. Specify the destination folder where you want to install/upgrade the TIBCO iProcess Server Objects (Java) files.

The destination folder defaults to:

C:\Program Files\TIBCO\TIBCO iProcess Server Objects (Java)

To choose a directory different than the default, either type in the desired path or click Browse to select the directory.

You can also click the Disk Cost button to determine the required and available disk space.

Also note that if you have administrator privileges, the Everyone and Just me radio buttons are also displayed. These buttons specify who can see and access TIBCO iProcess Server Objects (Java) from Control Panel Add/Remove Programs. Select as desired.

If the setup program detects that you already have the version installed that you are attempting to install, it displays a Repair/Remove dialog. This dialog can be used to either repair corrupted files or remove the TIBCO iProcess Server Objects (Java) installation. For more information, see Repairing/Removing Using the Setup Program on page 19.

If you are installing on a 64-bit machine, the default directory includes "(x86)", as follows: C:\Program Files (x86)\TIBCO\...


Installation/Upgrade Procedure | 7

5. Click Next. The Confirm Installation window is displayed.

6. Confirm you want to continue with the installation by clicking the Next button.

The setup program then copies the JAR files for all three of the available interfaces to the installation directory:

— Standalone: ssoJBase.jar

— RMI: ssoRMI.jar

— EJB: ssoEJB.jar

When setup completes copying files, the Installation Complete dialog is displayed.

7. Click Close to complete the installation/upgrade.

8. Set up the CLASSPATH environment variable so that it points to all of the appropriate JAR files. The CLASSPATH must contain the complete path/filename of all of the JAR files that will be used. This includes all of the open-source JAR files, the XML serializer JAR file, as well as the iProcess Server Object JAR file (ssoJBase.jar, ssoRMI.jar, or ssoEJB.jar) that will be used (you only need to include the iProcess Server Object JAR file for the interface you will be using).

For a list of the JAR files installed, see Installed Files / Directories on page 8.


8 | Chapter 2 Installing/Upgrading on Windows Systems

Installed Files / Directories

The following files and directories are installed with TIBCO iProcess Server Objects (Java):

Note that the TIBCO iProcess Server Objects JAR files are cumulative, i.e., ssoRMI.jar contains the files that are in ssoJBase.jar, and ssoEJB.jar contains the files that are in ssoRMI.jar.

File / Directory Description

ssoJBase.jar Compressed files for the Standalone interface.

ssoRMI.jar Compressed files for the RMI and Standalone interfaces.

ssoEJB.jar Compressed files for the EJB, RMI, and Standalone interfaces.

ssoJNI.dll Dynamic link library for the TIBCO iProcess Server Objects (Java).

commons-logging.jarlog4j.jarxercesImpl.jar

Open-source JAR files upon which TIBCO iProcess Server Objects (Java) has dependencies.

icudt36.dll Data table used for Unicode support.

icuuc36.dll Unicode converter used to convert from Unicode to other character sets.

ssoXMLSerializer.jar Serializer for the XML Interface.

\x64 This directory contains the 64-bit DLLs (ssoJNI.dll, as well as the ICU DLLs) that can be used if you are running 64-bit hardware and using a 64-bit JVM.

Note: The 64-bit JVM is a separate executable from the 32-bit JVM, so the command-line might look like the following, depending upon where you've installed the 64-bit JVM:C:\Tools\Java\jdk1.5.0_10\x64\bin\java" -Djava.library.path="C:\Program Files\TIBCO\TIBCO iProcess Server Objects (Java)\x64" …

\Help This directory contains the TIBCO iProcess Server Objects (Java) on-line help files (to start, execute start.htm with a browser).


| 9

Chapter 3 Installing/Upgrading on UNIX Systems

This chapter explains how to install or upgrade TIBCO iProcess Server Objects (Java) on UNIX systems.

Topics

• Extracting the Installation Set from the Product DVD, page 10

• Running the Installation Script, page 11

• Installed Files / Directories, page 14


10 | Chapter 3 Installing/Upgrading on UNIX Systems

Extracting the Installation Set from the Product DVD

1. Log in to your UNIX system. You can log in as any user — it does not have to be the root user.

2. cd to a directory that can be used to temporarily hold the installation set. The /tmp directory is commonly used:

cd /tmp

When the installation set is extracted, an install directory is automatically created in the chosen directory. So if you chose /tmp, the installation set is extracted into the /tmp/install directory.

3. Mount the product DVD.

4. Use the tar command to extract the installation set from the appropriate ssojava.tar file into the installation directory:

tar xvf <mount_point>/<platform>/ssojava.tar

where <mount_point> is the location at which your DVD is mounted, and <platform> is the platform-specific subdirectory on the DVD containing the ssojava.tar for the operating system on which you are installing, e.g., if installing on Solaris, extract the installation set from the ssojava.tar file in the /solaris directory.

All of the files that the installation script needs to install TIBCO iProcess Server Objects (Java) are extracted into the temporary installation directory (e.g., /tmp/install). After the installation is complete, you will be asked if you want all of these files deleted from this directory (the install directory will not be deleted — that must be done manually if you want it deleted).

5. Un-mount the product DVD.


Running the Installation Script | 11

Running the Installation Script

To install or upgrade TIBCO iProcess Server Objects:

1. Log in to your UNIX system. This can be any user who has permissions to create files in the directory in which you are installing the TIBCO iProcess Server Objects (Java).

2. cd to the directory into which the installation set was extracted (see Step 2 on page 10). For example:

cd /tmp/install

If you have just completed extracting the installation set, you are already at the directory into which the install directory was created. In this case, simply enter:

cd install

3. Run the ssojinstall installation script using the command:

./ssojinstall

The TIBCO End User License Agreement is displayed.

4. Read the license agreement. You can:

a. Press Enter to step through the license agreement one line at a time.

b. Press the space bar to step through the license agreement one page at a time.

After reading through the entire agreement, the following prompt is displayed:

Do you agree to the above license terms? [yes or no]

5. If you do not agree to the terms of the license agreement, type n, then press Enter. This causes the installation script to exit.

If you agree to the terms of the license agreement, type y, then press Enter. This causes the menu shown below to be displayed.



6. Make a selection from the menu that corresponds to the interface you want to install, then press Enter.

You will be told that TIBCO iProcess Server Objects (Java) will be installed in the /usr/sso directory by default. The following question is displayed:

7. Choose the installation directory as follows:

a. To choose the default /usr/sso directory, type Y, then press Enter.

b. To choose an alternative directory, type N, then press Enter. When prompted, enter the path and name of the directory in which you want TIBCO iProcess Server Objects (Java) installed. The new directory will be created and you will be asked to verify the directory. Type Y and press Enter to confirm.

The installation script checks the directory you chose to see if TIBCO iProcess Server Objects (Java) software is already installed in that directory:

— If there is TIBCO iProcess Server Objects (Java) software in the directory, but it’s the same version you are now installing, it will overwrite it without warning.

— If there is TIBCO iProcess Server Objects (Java) software in the directory, but it’s a different version than you are now installing, a prompt is displayed, asking you if the previous version should be overwritten. To not overwrite the previous version and choose another directory, type N, then press Enter. To overwrite the previous version, type Y, then press Enter.

The software is installed. The installation menu is displayed when it is complete.

8. From the installation menu, select 5, then press Enter, to exit the installation script.

A message is displayed telling you to make sure the CLASSPATH environment variable includes the appropriate JAR files. The CLASSPATH variable must contain the path/file name for the particular JAR file that was

If at some point in the installation script you would like to abort the installation, press <Ctrl>C to exit the script.


Running the Installation Script | 13

installed. The name of the JAR file will depend on the interface you installed, as follows:

— Standalone: ssoJBase.jar

— RMI: ssoRMI.jar

— EJB: ssoEJB.jar

CLASSPATH must also include the path to each of the open-source JAR files and the XML serializer JAR file (see the next section for a complete list of the JAR files installed).

The message also informs you that the appropriate environment variable for your operating system must contain the directory in which TIBCO iProcess Server Objects (Java) was installed (if you installed in the default directory, it is /usr/sso if you are using the 32-bit library, and /usr/sso/lib64 if you are using the 64-bit library). The appropriate environment variable for each UNIX operating system is as follows:

— AIX: LIBPATH

— HP-UX: SHLIB_PATH

— Linux: LD_LIBRARY_PATH

— Solaris: LD_LIBRARY_PATH

Following the messages about environment variables, you are asked if the installation script should remove the installation files.

9. Respond to the question about removing the installation script as follows:

a. To delete the installation script and its related files from the temporary installation directory (the temporary installation directory itself will not be deleted), type Y, then press Enter.

b. To retain the installation script and its related files, type N, then press Enter.

The installation is complete.

If you installed all three interfaces, the CLASSPATH variable must include the path/filename for all three JAR files.



Installed Files / Directories

The following files and directories are installed with TIBCO iProcess Server Objects (Java):

Note that the files in the JAR files are cumulative, i.e., ssoRMI.jar contains the files that are in ssoJBase.jar, and ssoEJB.jar contains the files that are in ssoRMI.jar.

File / Directory Description

ssoJBase.jar Compressed files for the Standalone interface.

ssoRMI.jar Compressed files for the RMI and Standalone interfaces.

ssoEJB.jar Compressed files for the EJB, RMI, and Standalone interfaces.

commons-logging.jarlog4j.jarxercesImpl.jar

Open-source JAR files upon which TIBCO iProcess Server Objects (Java) has dependencies.

ssoXMLSerializer.jar Serializer for the XML Interface.

libssoJNI.sl The shared library (HP PA-RISC only).

libssoJNI.so The shared library (AIX, Linux, HP Itanium, and Solaris only).

version.txt Contains the version of the TIBCO iProcess Server Objects (Java) software.

/lib64 This directory contains the 64-bit libraries that can be used if you are running a 64-bit JVM.

For information about invoking the 64-bit JVM, see 64-Bit Libraries on page 15.

/Help This directory contains the TIBCO iProcess Server Objects (Java) on-line help files (to start, execute start.htm with a browser).


Installed Files / Directories | 15

64-Bit LibrariesThe method of invoking the 64-bit JVM depends on the operating system you are using, as follows:

Operating System Description

AIX The 64-bit JVM is a separate executable from the 32-bit JVM, so the command-line might look like the following, depending upon where you've installed the 64-bit JVM:/usr/java14_64/bin/java -Djava.library.path=/usr/sso/lib64 …

HP-UX The 64-bit JVM is invoked by adding the "-d64" option to the command line. For example:java -d64 -Djava.library.path=/usr/sso/lib64 …

Linux On Redhat Linux, the 32-bit version will run on both RedHat Enterprise 3.0 and 4.0, but the 64-bit version will only run on RedHat Enterprise 4.0 (on AMD64 or Intel x64 hardware).

On both Redhat and SUSE Linux, the 64-bit JVM is a separate executable from the 32-bit JVM, so the command-line might look like the following, depending upon where you've installed the 64-bit JVM:/usr/java/jdk1.5.0_11-amd64/bin/java -Djava.library.path=/usr/sso/lib64 …

Solaris The 64-bit JVM is invoked by adding the "-d64" option to the command line. For example:java -d64 -Djava.library.path=/usr/sso/lib64 …

Note that there are older versions of the JVM that will run on 64-bit hardware, but that cannot run 64-bit processes. So if you want to use the 64-bit libraries, ensure that your version of the JVM supports 64-bit.




| 17

Chapter 4 Removing the TIBCO iProcess Server Objects (Java)

This chapter explains how to remove the TIBCO iProcess Server Objects (Java) from your system.

Topics

• Introduction, page 18

• Repairing/Removing Using the Setup Program, page 19

• Removing Using the Operating System Facilities, page 21


18 | Chapter 4 Removing the TIBCO iProcess Server Objects (Java)

Introduction

There are two methods of removing TIBCO iProcess Server Objects (Java):

• Using the setup program that was used to install TIBCO iProcess Server Objects (Java). This method also allows you to "repair" the product if it has become corrupted. This is available only on Windows systems.

For more information, see Repairing/Removing Using the Setup Program on page 19.

• Using the "removal" facility in the operating system.

— In Windows, this is "Add/Remove Programs" — see Removing from Windows Systems on page 21.

— In UNIX, this is the "rm" command — see Removing from UNIX Systems on page 22.


Repairing/Removing Using the Setup Program | 19

Repairing/Removing Using the Setup Program

This procedure is applicable only on Windows systems.

The TIBCO iProcess Server Objects (Java) setup program has the capability to either:

• repair an existing installation if the TIBCO iProcess Server Objects (Java) files have become corrupted in some way, or

• remove the existing installation.

To accomplish this, you must run the setup program for the same version of TIBCO iProcess Server Objects (Java) that you already have installed.

To repair/remove an existing version of TIBCO iProcess Server Objects (Java), perform these steps:

1. Run the setup program for the same version you already have installed. If you are installing from:

— DVD: Run setup.exe.

— a network server: Ask your network administrator for the location of setup.exe and run it from there.



The TIBCO iProcess Server Objects (Java) installation program detects that you already have that version installed and displays the following dialog.

2. Click the appropriate radio button, then click Finish.

— The “Repair” option causes corrupted files to be replaced.

— The "Remove" option causes the TIBCO iProcess Server Objects (Java) files to be removed from your system.

The Installation Complete window is displayed when the repair/remove operation is finished.

3. Click Close to complete the repair/remove operation.


Removing Using the Operating System Facilities | 21

Removing Using the Operating System Facilities

The following subsections describe removing TIBCO iProcess Server Objects (Java) using the operating system facilities.

Removing from Windows Systems

To remove TIBCO iProcess Server Objects (Java) from a Windows system, follow these steps:

1. From Control Panel, choose Add/Remove Programs.

2. From the list of currently installed programs, select TIBCO iProcess Server Objects (Java) - Version nnn, where ’nnn’ is the version of TIBCO iProcess Server Objects (Java) you are removing.

3. Click Remove.

4. Confirm that you want to remove the program.

All TIBCO iProcess Server Objects (Java) files and directories are removed from your system. However, if the remove program detects files in the TIBCO iProcess Server Objects (Java) installation directory that were not added by TIBCO iProcess Server Objects (Java), it will not remove those files nor the directory. It will only remove the TIBCO iProcess Server Objects (Java)-related files.

There is an anomaly in Windows that causes multiple entries for TIBCO iProcess Server Objects (Java) in the Control Panel Add/Remove Programs if you have installed a newer version of TIBCO iProcess Server Objects (Java) to the same directory. When installing a newer version to the same directory, the older version is overwritten by the newer version. However, entries for both versions remain in Add/Remove Programs. To remove TIBCO iProcess Server Objects (Java) in this situation, you must remove both versions using Add/Remove Programs.



Removing from UNIX SystemsTo remove TIBCO iProcess Server Objects (Java) from a UNIX system, follow these steps:

1. Log in as root.

2. Enter the following to remove the TIBCO iProcess Server Objects (Java) files and directories.

rm -r InstallDir

where InstallDir is the name of the directory where you installed TIBCO iProcess Server Objects (Java) (the default is /usr/sso).


TIBCO iProcess Server Objects (Java) Installation Guide · TIBCO iProcess Server Objects (Java) Installation Guide 4 |Chapter 1 Introduction 64-Bit Libraries Both 32-bit and 64-bit

Documents