iprocess oracle qs

TIBCO iProcess™ (Oracle) for Windows

Quick Start (For TIBCO Internal Use Only)Software Release 11.0January 2009

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

Contents | ii

Contents

READ THIS FIRST! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2System 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

| 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.

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 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.

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.


2 | READ THIS FIRST!

AssumptionsThis 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.

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.

• 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 InformationFor 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.

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.

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.

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


READ THIS FIRST! | 3

System Requirements

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

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).

• 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.

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

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.

Oracle DB Release Additional Requirements

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)

Oracle Database Release

Additional RequirementsOracle Client Release

Additional Requirements

9.2.0.x (where x is 8 or higher)

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

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

10.2.0.x, where x is 2 or higher

Oracle Services for Microsoft Transaction Server (OraMTS)

with 10.2.0.2 Oracle Services for Microsoft Transaction Server (OraMTS)


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.

• 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.WE8ISO8859P1NLS_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.

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 ([email protected]).

TIBCO BusinessWorks Release...

requires TIBCO Runtime Agent Release(s)...

5.4 5.5

5.3 5.3.2 on top of 5.3.0


http://oraclepartnernetwork.oracle.com

http://metalink.oracle.com

http://inside.tibco.com/tibco/Business+Process+Management

Download the Required TIBCO Software | 5

1. Download the Required TIBCO Software

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).

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.

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.

Product Version Download Site Location(Products Home >>) Notes

For iProcess Core Components you will need:

TIBCO iProcess Engine (Oracle)

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

TIBCO iProcess Workspace (Windows)

11.0.x TIBCO iProcess Workspace (Windows)-11.0.1

Includes TIBCO iProcess Modeler

TIBCO iProcess Documentation Library

11.0.x TIBCO iProcess Engine-11.0.1 You will need Adobe Acrobat Reader to access the iProcess documentation. You can download this from:

http://www.adobe.com/products/acrobat/readstep2.html

TIBCO iProcess Workspace (Browser)

11.0.x TIBCO iProcess Workspace (Windows)-11.0.1 or

TIBCO iProcess Developer-11.0.1

Includes TIBCO iProcess Objects Server (Java)

You will also need the following non-TIBCO component:

POSIX Threads (pthreads) for Win32

2.7.0 TIBCO iProcess Engine-11.0.1 Select the "pthreads" entry from the list of files.

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 Plug-ins

11.0.x TIBCO iProcess Developer-11.0.1

Provides the following plug-ins:

• iProcess BusinessWorks Client Plug-in

• iProcess Java Client Plug-in

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.


http://download.tibco.com

http://www.adobe.com/products/acrobat/readstep2.html

http://support.tibco.com

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..

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.

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.


Install iProcess Core Components | 7

2.2 Install the iProcess Engine

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.

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.

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

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.



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.

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.

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



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.

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

2.3 Start the iProcess EngineTo 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

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.



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 started1 BG 2 RUNNING BG process started1 BG 3 RUNNING BG process started1 BG 4 RUNNING BG process started1 BGPREDICT 1 RUNNING BG process started1 DLMGR 1 RUNNING DLMGR process started1 IAPJMS 1 RUNNING IAPJMS Process Started1 RPCBG 1 RUNNING RPCBG process started1 RPC_TCP_LI 1 RUNNING RPC listener process started1 RPC_UDP_LI 1 RUNNING RPC listener process started1 SPO 1 RUNNING SPO Server process started1 WIS 1 RUNNING WIS process started1 WIS 2 RUNNING WIS process started1 WISMBD 1 RUNNING WISMBD process started1 WISMBD 2 RUNNING WISMBD process started1 WQS 1 RUNNING WQS process started

Current System Status : 'RUNNING'

2.4 Install iProcess Workspace (Windows)To install iProcess Workspace (Windows):


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.



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 LibraryUnzip 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.)



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.

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.


(Optional) Install BusinessWorks Integration Components | 13

3. (Optional) Install BusinessWorks Integration Components

3.1 Install iProcess BusinessWorks Server Plug-in (in the iProcess Engine)To install the iProcess BusinessWorks Server Plug-in in the iProcess Engine:


2. Unzip the TIBCO iProcess Technology Plug-ins 11.0.x distribution set to a temporary directory.

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.


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.

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.

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.


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.

2. Run setupClient.exe.


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.

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.


(Optional) Install BusinessWorks Integration Components | 15


iprocess oracle qs

Documents