TIBCO iProcess™ (Oracle) for Windows

Quick Start (For TIBCO Internal Use Only)

Software Release 11.0
January 2009
 Contents ii
|

Contents

READ THIS FIRST! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1. Download the Required TIBCO Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2. Install iProcess Core Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1 Perform iProcess Engine Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2 Install the iProcess Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3 Start the iProcess Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Install iProcess Workspace (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.5 Install iProcess Workspace (Browser). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.6 Install the iProcess Documentation Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3. (Optional) Install BusinessWorks Integration Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.1 Install iProcess BusinessWorks Server Plug-in (in the iProcess Engine) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.2 Install BusinessWorks iProcess Plug-in (in BusinessWorks) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.3 Install iProcess BusinessWorks Client Plug-in (in iProcess Workspace) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 |1

READ THIS FIRST!

This Quick Start guide shows you how to quickly install a basic TIBCO iProcess configuration on a single computer,
suitable for "proof of concept" and demonstration purposes.

The guide uses a specific and restricted set of assumptions (see page 2) about the target computer where you will
be installing iProcess and the required iProcess configuration, in order to provide you with a rapid and linear
path through the different installation choices and scenarios.
This guide is NOT intended as a substitute for the released iProcess installation documentation and should not be
used as such for a customer installation, or for an installation that does not conform to the stated assumptions
and requirements.

This guide shows you how to install the core components of an iProcess system, and (optionally) integrate iProcess with
TIBCO BusinessWorks.
The following diagram illustrates these components and how they interact. All components will be installed on the same
computer.

The components shown in blue are optional. These components allow iProcess to communicate with BusinessWorks.

The TIBCO iProcess BusinessWorks Client Plug-in and TIBCO iProcess Java Client Plug-in are both provided as
part of the TIBCO iProcess Workspace Plug-ins distribution set.
The TIBCO iProcess BusinessWorks Server Plug-in, TIBCO iProcess Java Server Plug-in and TIBCO
BusinessWorks iProcess Plug-in are all provided as part of the TIBCO iProcess Technology Plug-ins distribution set.
The TIBCO iProcess BusinessWorks Client Plug-in, TIBCO iProcess BusinessWorks Server Plug-in and TIBCO
BusinessWorks iProcess Plug-in together make up the TIBCO iProcess BusinessWorks Connector.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
2
| READ THIS FIRST!

Assumptions
This guide makes the following assumptions about the target computer where you will be installing iProcess and about
the required iProcess configuration:
• You will install iProcess on your TIBCO laptop, which is installed in a TIBCO domain.
• You will install the iProcess Engine using your normal TIBCO Windows network login account - for example,
\\EMEA\FBloggs.

This account must be a member of the local Windows Administrators group. If it is not, you will not be able to run
the Setup installation program.

The Setup installation program will automatically set this login account (for example, \\EMEA\FBloggs) to be the
following iProcess Engine users. You will not be able to choose a different login account to use for these users when
you run Setup.

User Description
IPEADMIN The Windows account that is used to administer the iProcess Engine. IPEADMIN
permissions are required to perform tasks such as:
• starting, stopping and configuring the iProcess Engine.
• running various utilities such as SWDIR\bin\swutil or SWDIR\util\LDAPCONF.

IPESERVICE The Windows account that is used to run the iProcess Engine - specifically:
• the iProcess NodeName Process Sentinels service, which runs all the iProcess Engine
processes.
• the Staffware Events COM+ application, which provides the publish/subscribe event
mechanism used for inter-process communication by the iProcess Engine processes.

• The iProcess Engine nodename will be staffw_nodx, where x is the first available number depending on how many
other iProcess Engine installations you already have defined in the following system registry key:
\HKEY_LOCAL_MACHINE\Software\Staffware plc\Staffware Server\Nodes registry key
You will not be able to choose a different nodename when you run Setup. For example, if this is the first iProcess
Engine on the system, the nodename will be staffw_nod1.
• You will install the iProcess Engine using a single-node iProcess architecture.
• You will install the iProcess Engine using the Basic installation type. When you choose a Basic installation, Setup
uses default values for a number of configuration options (e.g. the iProcess Engine nodename, and the IPEADMIN
and IPESERVICE users). This makes installation easier and quicker, but means that you cannot change these values
as part of the installation process.
If you want more information about what these default configuration options and values are, see the section "Default
Configuration Options for a Basic Installation" in Chapter 3, "Running the Setup Installation Program" of the main
TIBCO iProcess Engine Installation guide.
• When you install the iProcess Workspace (Browser), you will use the embedded Tomcat web server that is
distributed as part of the iProcess Engine (in SWDIR\tomcat) to host the following iProcess Workspace (Browser)
elements - the Action Processor, iProcess Server Objects and iProcess Client. (See section 2.5 on page 11 for more
information.) If you want to use a different Tomcat installation, refer to the TIBCO iProcess Workspace (Browser)
Installation Guide for installation instructions instead.

For More Information

For more detailed information about the installation process for each iProcess component, refer to the Installation guide
supplied with each component. For more information about iProcess in general, refer to the TIBCO iProcess
Documentation Library - see page 12.

If you encounter problems or errors during installation, consult the "Troubleshooting" section of the relevant Installation
guide.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 READ THIS FIRST! 3
|

System Requirements

Make sure that you use the versions specified in the following sections. Failure to do so could result in problems during
or after installation.

Basic
Your TIBCO laptop must have:
• Either:
— Windows XP Professional with SP2, or
— Windows Server 2003 with SP1 and MS04-012: Cumulative Update for Microsoft RPC/DCOM (KB828741), or
— Windows Vista with Service Pack 1.
• at least 1 Gb of free space
• at least 1 Gb of RAM (2 Gb if you want to integrate iProcess with BusinessWorks)

Oracle

IMPORTANT! Installing Oracle is a non-trivial task and detailed instructions for doing so are beyond the scope
of this guide.
If you are not already familiar with Oracle and how to install it, we strongly recommend that you get somebody who is to
assist you with installing it. You should ensure that Oracle is installed and functioning correctly on your machine
BEFORE you attempt to install iProcess.
If you are not familiar with Oracle, attempting to install it as part of the iProcess installation could at best considerably
extend the time it takes to perform the installation, and at worst seriously jeopardize your chances of successfully
completing the iProcess installation.
Note that Oracle 9i is not supported under Windows Vista.

You must have one of the Oracle releases described in the following tables installed on your TIBCO laptop:
• If you want to use a direct connection to the Oracle database, you must use one of the following Oracle Database
releases (as the default database).

Oracle DB Additional Requirements

Release
9.2.0.8 Oracle Services for Microsoft Transaction Server (OraMTS) 9.2.0.1.0 with Oracle patch 2428356

10.2.0.2 Oracle Services for Microsoft Transaction Server (OraMTS)

• If you want to use a Transparent Network Substrate (TNS) connection to the Oracle database, you must use one
of the following combinations of Oracle Database and Oracle Client releases.

Oracle Oracle
Database Additional Requirements Client Additional Requirements
Release Release
9.2.0.x (where x Oracle Services for Microsoft with 9.2.0.8 Oracle Services for Microsoft
is 8 or higher) Transaction Server (OraMTS) Transaction Server (OraMTS)
9.2.0.1.0 with Oracle patch 9.2.0.1.0 with Oracle patch
2428356 2428356

10.2.0.x, where x Oracle Services for Microsoft with 10.2.0.2 Oracle Services for Microsoft
is 2 or higher Transaction Server (OraMTS) Transaction Server (OraMTS)

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
4
| READ THIS FIRST!

IMPORTANT! Note that:

• The iProcess Engine uses Oracle Call Interface (OCI) to access data in the Oracle database. For reasons of stability,
the iProcess Engine is statically linked with the Oracle client libraries that provide the required OCI routines. Oracle
state that they only support products that run against the same set of libraries they were built with. As a result, you
must use one of the Oracle release combinations listed in the tables above.
• You must have access to the following Oracle resources:
— Oracle Partner Network (OPN). You need to be an OPN member to obtain the necessary Oracle licenses for
the base Oracle version (9.2 or 10.2) required by the iProcess Engine. The licenses are available on a Free of
Charge basis for development, testing and demonstration purposes. OPN membership is region-based, so you
must ensure that your region either has its own individual membership (with an associated cost), or is an
associate member of TIBCO’s US-based worldwide membership (free). Regions who wish to associate
themselves with the worldwide agreement will need to quote the appropriate PIN as part of their application.
OPN access is available at http://oraclepartnernetwork.oracle.com.
— Oracle MetaLink support portal. You need MetaLink access to obtain the necessary patchsets to apply to the
base Oracle version (9.2 or 10.2) required by the iProcess Engine. Oracle MetaLink access requires an active
support contract. Like OPN, support is region-based, so you must ensure that your region has an active support
contract. MetaLink access is available at http://metalink.oracle.com.

If you do not already have access to OPN and MetaLink and need further assistance, please contact TIBCO’s BPM
Senior Product Manager, Justin Brunt (jbrunt@tibco.com).

• To install OraMTS, you must choose the Custom installation type when you install Oracle. You should install
OraMTS on the base Oracle version (9.2 or 10.2), before installing the required patch sets.
Additionally, you must make sure that:
• You know the password for the Oracle SYSTEM user account.
• If you intend to use a TNS connection, you know the TNS identifier (net service name) to connect to the Oracle
database.
• The Oracle OPEN_CURSORS parameter is set to a value of at least 200.
• An Oracle UNDO tablespace exists. (The iProcess Engine installer needs this when installing the iProcess Engine
database.)
• The Oracle NLS_LANG value uses an 8-bit character set component (charset). For example:
NLS_LANG=American_America.WE8ISO8859P1
NLS_LANG=JAPANESE_JAPAN.JA16SJIS

TIBCO Rendezvous
If you have a pre-8.1.1 version of Rendezvous already installed on your TIBCO laptop, you must either remove it or
upgrade it to Version 8.1.1 before installing the iProcess Engine.

TIBCO BusinessWorks and TIBCO Runtime Agent (Optional)

If you want to integrate iProcess with BusinessWorks, you must have one of the following software combinations
installed on your TIBCO laptop.

TIBCO BusinessWorks requires TIBCO Runtime Agent

Release... Release(s)...
5.4 5.5

5.3 5.3.2 on top of 5.3.0

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 Download the Required TIBCO Software 5
|

1. Download the Required TIBCO Software

IMPORTANT! Make sure that you obtain and use the specified versions of the required software. Failure to do so could
result in problems during or after installation.

To obtain the required TIBCO software:

1. Download the following distribution sets from the indicated locations on the TIBCO Software Inc. Product
Download Site (http://download.tibco.com).

Download Site Location

Product Version Notes
(Products Home >>)
For iProcess Core Components you will need:

TIBCO iProcess Engine 11.0.x TIBCO iProcess Engine-11.0.1 Includes TIBCO Hawk and TIBCO EMS
(Oracle)

TIBCO iProcess Workspace 11.0.x TIBCO iProcess Workspace Includes TIBCO iProcess Modeler
(Windows) (Windows)-11.0.1

TIBCO iProcess 11.0.x TIBCO iProcess Engine-11.0.1 You will need Adobe Acrobat Reader to access the iProcess
Documentation Library documentation. You can download this from:
http://www.adobe.com/products/acrobat/readstep2.html

TIBCO iProcess Workspace 11.0.x TIBCO iProcess Workspace Includes TIBCO iProcess Objects Server (Java)
(Browser) (Windows)-11.0.1 or
TIBCO iProcess
Developer-11.0.1

You will also need the following non-TIBCO component:

POSIX Threads (pthreads) for 2.7.0 TIBCO iProcess Engine-11.0.1 Select the "pthreads" entry from the list of files.
Win32
Install as described in Install POSIX Threads (pthreads)
for Win32 on page 7.

To integrate iProcess with BusinessWorks you will also need:

TIBCO iProcess Technology
Plug-ins
11.0.x TIBCO iProcess Engine-11.0.1 Provides the following plug-ins:
• iProcess BusinessWorks Server Plug-in
• iProcess Java Server Plug-in
• BusinessWorks iProcess Plug-in

TIBCO iProcess Workspace 11.0.x TIBCO iProcess Provides the following plug-ins:
Plug-ins Developer-11.0.1
• iProcess BusinessWorks Client Plug-in
• iProcess Java Client Plug-in

2. Log on to the TIBCO Support Web site (http://support.tibco.com) and check the Late Breaking News section
(Current News and Archived News) for any HotFix Release Announcements on the products/versions listed
above. If any relevant Service Packs or Hot Fixes exist, you should download and install them according to the
instructions given in the Late Breaking News section.

The instructions in this guide cover installation of a complete iProcess system. As such, they cannot explicitly state how
and when you may need to apply a particular Hot Fix or Service Pack to a particular product. You should follow the
specific instructions supplied with each Hot Fix or Service Pack, but if you are in any doubt about how or when to apply
a particular Hot Fix or Service Pack (in the context of the overall installation process), you should contact TIBCO
Support for advice before proceeding with the installation.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
6
| Install iProcess Core Components

2. Install iProcess Core Components

Perform the tasks in this section to install iProcess core components.

2.1 Perform iProcess Engine Pre-Installation Tasks

2.1.1 Turn off User Account Control on Windows Vista

If you are installing on Windows Vista you must turn user account control off, or else the iProcess Engine will not start.
To do this:
1. Go to Control Panel and then to User Accounts.
2. Click on Turn User Account Control on or off.
3. Uncheck the Use User Account Control (UAC) to help protect your computer checkbox.
4. Click OK..

It is possible to proceed with UAC turned on. However if you do this you will need to carry out certain actions manually
later in the installation process. This alternative procedure is not described in this Guide, which assumes for simplicity
that UAC is off. See the main TIBCO iProcess Engine Installation guide for details of the alternative procedure.

2.1.2 Install POSIX Threads (pthreads) for Win32

1. Download version 2.7.0 of the POSIX Threads (pthreads) for Win32 library as described in Download the Required
TIBCO Software on page 6.
2. Copy the pthread.dll file from the POSIX Threads (pthreads) for Win32 distribution set to the
%systemroot%\system32 folder on your computer.
3. Make sure that the computer’s PATH system environment variable includes the %systemroot%\system32 folder.

2.1.3 Add an Entry to the \etc\services File for the iProcess Objects Server Process
To do this:
1. Using a suitable text editor, open the Windows\system32\drivers\etc\services file.
2. Add an entry for the iProcess Objects Server (SPO) process, in the format:

staffw_nodx_spo Number/tcp

where:
— staffw_nodx is the nodename that will be assigned to this iProcess Engine when you run Setup (see page 2).
— Number is the port number you want to use. The port number must be a unique entry in this file (i.e. not used by
any other entry). There must be a blank line left at the bottom of the services file otherwise the last line is ignored.
For example:

staffw_nod1_spo 9545/tcp

3. Save the file.

2.1.4 Ensure that the Database is Running

Make sure that the Oracle database is running, so that Setup can connect to it when installing the iProcess Engine.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 Install iProcess Core Components 7
|

2.2 Install the iProcess Engine

You should accept all default values in all dialogs unless explicitly told to do otherwise.

To install the iProcess Engine:

1. Login to Windows using the account that you want to use to administer the iProcess Engine after you have installed
it (the IPEADMIN user). This account must be a member of the local Windows Administrators group.
2. Unzip the TIBCO iProcess Engine 11.0.x distribution set to a temporary directory.
3. Run Setup.
4. In the Setup Type dialog, choose Basic, then click Next.
5. In the Choose Destination Location dialog, specify the Destination Folder where you want to install the iProcess
Engine files, then click Next.

This folder is referred to as the iProcess system directory or SWDIR. The folder name must not contain any special
characters. Make sure that the SWDIR full pathname does not exceed 64 characters, otherwise the installation will
fail with an error.

6. In the Group & User Configuration dialog, the iPE administrator account field displays the name of the account
you are logged in as (the IPEADMIN user). Enter your password then click Next.

7. In the Database Details dialog:

a. In the Oracle database service (TNS) name field, if you are using a TNS connection (see page 4) enter the
TNS identifier needed to connect to the Oracle database. If you are using a direct connection, you can leave this
field blank.
b. In the Password field, enter the password for the Oracle SYSTEM user.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
8
| Install iProcess Core Components

c. Accept the default values for the iPE DB Owner and iPE DB User database users, unless you already have
existing iProcess Engine installations on your computer. In this case, click Change and enter new, unique user
names for these users for this installation (e.g. swpro1 and swuser1).

d. Click Next.
8. Accept the Default option in the Select TableSizes Profile dialog, then click Next.
9. Accept the default options shown in the TIBCO Software Installation and Configuration dialog, then click Next.

If EMS and/or Hawk are already installed on the system these check boxes are disabled and appropriate messages
are displayed.

10. In the Select components to configure dialog:

a. Select Install iProcess ’Web Server’ Service, Configure E-Mail Plugin and Enable IAP.

b. Click Next.
11. If you intend to use an SMTP Server, enter the appropriate values in the SMTP Server Parameters dialog. If you
do not know the values at this point accept the default options shown. You can configure the SMTP Server
parameters after installation. Click Next.
12. Accept the default options shown in the TIBCO iProcess Web Server Configuration dialog. Click Next.
13. Accept the default option (EMS) in the Default Java Message Service dialog, along with the two subsequent
dialogs. Click Next.
14. Review your installation options in the Start Copying Files dialog, then click Next.
Setup now installs the iProcess Engine using your specified options. It displays a number of further dialogs and
progress meters while it performs the necessary installation tasks.
15. The iProcess Objects Server Configuration Utility is displayed:
a. Click the TCP tab.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 Install iProcess Core Components 9
|

b. In the Settings field, enter the name of the entry you added to the Windows\system32\drivers\etc\services file
(see page 7.). For example, staffw_nod1_spo.

c. Click the Users tab, then select the Enabled - no access restriction radio buttons for both the DB Connection
Information Access and IAP Configuration Access fields.

d. Click OK to close the Server Configuration Utility.

e. Click Yes to the Set Defaults prompt that is displayed, then OK to the following dialog which notifies you that
values have been saved.
Setup performs a number of checks to validate that the installation has succeeded. (If it encounters an error it
displays a suitable error message.)
16. When the Finished dialog is displayed, click OK.
The Setup Complete dialog is displayed.

Depending on the tasks that Setup has had to perform, you may now be prompted to reboot your computer. You can
choose to reboot immediately or later, but you must reboot your computer before running the iProcess Engine for
the first time.

17. Click Finish. The iProcess Engine is now installed.

2.3 Start the iProcess Engine

To start the iProcess Engine:
1. If you were prompted to reboot your computer when Setup finished but you have not yet done so, you must reboot
now. The iProcess Engine process sentinels will start automatically when the computer starts up, then automatically
start all of the iProcess Engine processes.
2. Login as the iProcess Engine IPEADMIN user.
3. Wait for a minute or two to give the processes time to start up, then enter the following command to check that the
iProcess Engine has started successfully:

SWDIR\util\swsvrmgr status -v

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
10
| Install iProcess Core Components

The system status should be "RUNNING", and you should see the following "RUNNING" processes.

Machine ID Proc Name Proc Inst Status Comment

----------------------------------------------------------------------
1 BG 1 RUNNING BG process started
1 BG 2 RUNNING BG process started
1 BG 3 RUNNING BG process started
1 BG 4 RUNNING BG process started
1 BGPREDICT 1 RUNNING BG process started
1 DLMGR 1 RUNNING DLMGR process started
1 IAPJMS 1 RUNNING IAPJMS Process Started
1 RPCBG 1 RUNNING RPCBG process started
1 RPC_TCP_LI 1 RUNNING RPC listener process started
1 RPC_UDP_LI 1 RUNNING RPC listener process started
1 SPO 1 RUNNING SPO Server process started
1 WIS 1 RUNNING WIS process started
1 WIS 2 RUNNING WIS process started
1 WISMBD 1 RUNNING WISMBD process started
1 WISMBD 2 RUNNING WISMBD process started
1 WQS 1 RUNNING WQS process started

Current System Status : 'RUNNING'

2.4 Install iProcess Workspace (Windows)

To install iProcess Workspace (Windows):
1. Login as the iProcess Engine IPEADMIN user.
2. Unzip the TIBCO iProcess Workspace (Windows) 11.0.x distribution set to a temporary directory.
3. Run Setup:
— In the Setup Type dialog, choose Modeler.
— In the Select TIBCO iProcess Engine dialog, you will need to edit the default RPC program number (391875)
if this is not the only iProcess Engine installation on this computer. In this case, change this value to the RPC
program number being used by the iProcess Engine you have just installed. You can find this number on line 10
of the SWDIR\swdefs file, where SWDIR is the directory where you installed the iProcess Engine.
— In all other dialogs, accept the default values.
4. Once iProcess Workspace (Windows) is installed, check that you can connect to the iProcess Engine. To do this:
a. Click Start > Programs > TIBCO iProcess Workspace (Windows) > TIBCO iProcess Workspace
(Windows).
b. Make sure the correct iProcess Engine name is displayed in the Server field.
c. Enter the username and password for the IPEADMIN user, then click OK.
The Work Queue Manager should be displayed.

2.5 Install iProcess Workspace (Browser)

To install iProcess Workspace (Browser):
1. Unzip the TIBCO iProcess Workspace (Browser) 11.0.x distribution set to a temporary directory.
2. Make sure that the iProcess nodename Web Server service is not running, where nodename is the name of your
iProcess Engine e.g. staffw_nod1. (This service is the embedded Tomcat web server that is distributed as part of the
iProcess Engine. Use Control Panel > Administrative Tools > Services to stop this service.)
3. Run TIB_iprocessworkspacebrowser-simple_11.0.x _win_x86.exe.
4. Accept the default options in the Installation Home dialog.
5. In the Component Selection dialogs, clear the Components check box.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 |
Install iProcess Core Components 11

6. In the Action Processor Configuration dialog:

— select Java Action Processor.
— select Tomcat.
— edit the iProcess Action Processor Home directory to be SWDIR\tomcat\webapps\TIBCOActProc, where
SWDIR is the directory where you installed the iProcess Engine.
— select Yes, unpack to un-war the Action Processor War file.
7. If you are installing under Windows Vista, you must set full control permissions for the IIS_USRS group:
— Right-click on the TIBCOActProc directory and select Properties.
— On the Security tab, check to see if the IIS_USRS group account has modify permissions. If
necessary, add the “IIS_USRS” group account and give it modify permissions.
8. In the iProcess Server Objects (Java) dialog:
— edit the iProcess Server Objects directory to be SWDIR\tomcat\shared\lib, where SWDIR is the directory
where you installed the iProcess Engine.
— accept the default Interface type option, which is Standalone (JBase).
9. In the (first) iProcess Client Configuration dialog:
— select Java Action Processor as the connection target.
— select Tomcat as the web server.
— edit the iProcess Client Home directory to be SWDIR\tomcat\webapps\TIBCOiPClnt, where SWDIR is the
directory where you installed the iProcess Engine.
10. In the (second) iProcess Client Configuration dialog:
— change the TCP Port to the value that you defined in the \etc\services file for the iProcess Objects Server (SPO)
process (see page 7).
— change the IP Address or Host Name to the same value as the Computer Name - so that both are showing the
machine name of the computer where you are installing iProcess.
— change the iProcess Node Name and Display Node Name values to the nodename of your installed iProcess
Engine (e.g. staffw_nod1).
11. Review the information in the Installation Preview dialog, then click Next.
Once iProcess Workspace (Browser) is installed, test that it can successfully log in to the iProcess Engine. To do this:
1. Start the iProcess nodename Web Server service, where nodename is the name of your iProcess Engine e.g.
staffw_nod1. (Use Control Panel > Administrative Tools > Services to start this service.)
2. Open a new browser window and enter the following URL:
http://localhost:8080/TIBCOiPClnt/iProcessClient.html
The TIBCO iProcess Workspace (Browser) Login dialog should be displayed.
3. Select the iProcess Engine name from the drop-down list.
4. Enter the username and password for the IPEADMIN user, then click OK. The work queue list should be displayed.

2.6 Install the iProcess Documentation Library

Unzip the TIBCO iProcess Documentation Library 11.0.x distribution set to the directory where you want to store it.
To access the documentation library, open the doc_lib.pdf file. in Acrobat Reader.

For more information about:

• iProcess components and how they fit together., see the TIBCO iProcess™ Engine Architecture guide.
• what’s new in Version 11.0, see the TIBCO iProcess™ Suite New Features guide. (Just click what’s new on the
main page to open this guide.)

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
12
| Install iProcess Core Components

Not exactly sure what you’re looking for or where to find it? Use the Search button in Acrobat. The iProcess
Documentation Library has been indexed so Search will look for your search term in every document in the library.

The iProcess core components are now installed and working. You can now tailor the system to your particular
requirements by, for example, changing the system configuration, adding users, importing and/or developing procedures
and so on.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 |
(Optional) Install BusinessWorks Integration Components 13

3. (Optional) Install BusinessWorks Integration Components

You only need to perform this step if you want to integrate iProcess with BusinessWorks. Refer to the diagram on page 1
for a reminder of what will be installed where.

3.1 Install iProcess BusinessWorks Server Plug-in (in the iProcess Engine)
To install the iProcess BusinessWorks Server Plug-in in the iProcess Engine:
1. Login as the iProcess Engine IPEADMIN user.
2. Unzip the TIBCO iProcess Technology Plug-ins 11.0.x distribution set to a temporary directory.

The full path name of this directory must not contain any spaces, periods or other special characters. If it does the
installer will not run.

3. Run setupwindows32.exe.
4. Select New installation, then click Next.
5. In the Destination panel, make sure that the iProcess Engine name (e.g. staffw_nod1) is selected, then click Next.
6. In the Features panel, select the TIBCO iProcess BusinessWorks (TM) Server Plug-in check box. (This
automatically selects the TIBCO iProcess (TM) Java Server Plug-in as well.) Clear all the other check boxes.
Click Next.
7. In the General Configuration panel:
a. set the Java Environment field to Alternate Location.
b. Use the Browse button to set the Alternate Location field to SWDIR\java\bin\server, where SWDIR is the
directory where you installed the iProcess Engine.
c. Click Next.
8. In the Database Connection panel, accept the defaults and enter the password for the iProcess Engine database
owner login. This login is swpro and the password is staffpro1 unless you changed it earlier - see page 8.Click
Next.
9. In the BusinessWorks Server Plug-in Configuration panel, accept the defaults and click Next.
10. In the Pre-installation Summary panel, check the displayed settings then click Install.

3.2 Install BusinessWorks iProcess Plug-in (in BusinessWorks)

To install the BusinessWorks iProcess Plug-in in BusinessWorks:
1. Change directory to the temporary directory where you unzipped the TIBCO iProcess Technology Plug-ins 11.0.x
distribution set.
2. Run setupwindows32.exe.
3. Select New installation, then click Next.
4. In the Destination panel, clear the Specify SWDIR check box, then click Next.
5. In the Features panel, select the TIBCO BusinessWorks iProcess(TM) Plug-in check box, then click Next.
6. In the Pre-installation Summary panel, click Install.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
14
| (Optional) Install BusinessWorks Integration Components

3.3 Install iProcess BusinessWorks Client Plug-in (in iProcess Workspace)

To install the iProcess BusinessWorks Client Plug-in in iProcess Workspace (Windows):
1. Unzip the TIBCO iProcess Workspace Plug-ins 11.0.x distribution set to a temporary directory.

The full path name of this directory must not contain any spaces, periods or other special characters. If it does the
installer will not run.

2. Run setupClient.exe.
3. Select New installation, then click Next.
4. In the Destination panel, make sure that the directory where you installed iProcess Workspace (Windows) is
selected, then click Next.
5. In the Features panel, select the TIBCO iProcess BusinessWorks (TM) Client Plug-in check box. (This
automatically selects the TIBCO iProcess (TM) Java Client Plug-in as well.) Clear all the other check boxes.
Click Next.
6. In the General Configuration panel:
a. set the Java Environment field to Alternate Location.
b. Use the Browse button to set the Alternate Location field to SWDIR\java\bin\client, where SWDIR is the
directory where you installed the iProcess Engine.
c. Click Next.
7. In the Connection Configuration panel, accept the defaults and click Next.
8. In the Pre-installation Summary panel, check the displayed settings then click Install.

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!
 |
(Optional) Install BusinessWorks Integration Components 15

TIBCO iProcess (Oracle) for Windows Quick Start - INTERNAL USE ONLY!