Download TIBCO iProcess Server Objects (Java) Installation Guide

TIBCO iProcess™ Server Objects (Java)
Installation Guide
Software Release 11.3.0
October 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
64-Bit Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Microsoft 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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
64-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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Removing from Windows Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Removing from UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
TIBCO iProcess Server Objects (Java) Installation Guide
iv
| Contents
TIBCO iProcess Server Objects (Java) Installation Guide
|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
TIBCO iProcess Server Objects (Java) Installation Guide
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.
If you are installing on a 64-bit Windows machine, the default directory includes
"(x86)", as follows: C:\Program Files (x86)\TIBCO\...
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
viii
| How to Contact TIBCO Customer Support
TIBCO iProcess Server Objects (Java) Installation Guide
|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
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
4
| Chapter 1
Introduction
1. Microsoft has discontinued standard support for Windows XP. (Extended support is still available, but must be purchased from Microsoft.) TIBCO will continue to support iProcess Client on Windows XP. However, if a problem with
iProcess Client is reported to TIBCO Support, and the problem is traced to the
Windows XP operating system, TIBCO Support will be unable to assist further
with the resolution of that problem.
64-Bit Libraries
Both 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 Package
TIBCO 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-3e034391-8a4d-074b9f2bc1bf&displaylang=en
x64:
http://www.microsoft.com/downloads/details.aspx?familyid=bd2a6171-e2d6-4
230-b809-9a8d7548c1b6&displaylang=en
TIBCO iProcess Server Objects (Java) Installation Guide
|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
TIBCO iProcess Server Objects (Java) Installation Guide
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.
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.
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)
If you are installing on a 64-bit machine, the default directory includes "(x86)", as
follows: C:\Program Files (x86)\TIBCO\...
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
8
| Chapter 2
Installing/Upgrading on Windows Systems
Installed Files / Directories
The following files and directories are installed with TIBCO iProcess Server
Objects (Java):
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.jar
log4j.jar
xercesImpl.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).
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.
TIBCO iProcess Server Objects (Java) Installation Guide
|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
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
12
| Chapter 3
Installing/Upgrading on UNIX Systems
If at some point in the installation script you would like to abort the installation,
press <Ctrl>C to exit the script.
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
TIBCO iProcess Server Objects (Java) Installation Guide
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
If you installed all three interfaces, the CLASSPATH variable must include the
path/filename for all three JAR files.
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.
TIBCO iProcess Server Objects (Java) Installation Guide
14
| Chapter 3
Installing/Upgrading on UNIX Systems
Installed Files / Directories
The following files and directories are installed with TIBCO iProcess Server
Objects (Java):
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.jar
log4j.jar
xercesImpl.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).
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.
TIBCO iProcess Server Objects (Java) Installation Guide
Installed Files / Directories 15
|
64-Bit Libraries
The method of invoking the 64-bit JVM depends on the operating system you are
using, as follows:
Operating
System
AIX
Description
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
HP-UX
-Djava.library.path=/usr/sso/lib64 …
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.
TIBCO iProcess Server Objects (Java) Installation Guide
16
| Chapter 3
Installing/Upgrading on UNIX Systems
TIBCO iProcess Server Objects (Java) Installation Guide
| 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
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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.
TIBCO iProcess Server Objects (Java) Installation Guide
20
| Chapter 4
Removing the TIBCO iProcess Server Objects (Java)
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.
TIBCO iProcess Server Objects (Java) Installation Guide
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
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.
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.
TIBCO iProcess Server Objects (Java) Installation Guide
22
| Chapter 4
Removing the TIBCO iProcess Server Objects (Java)
Removing from UNIX Systems
To 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