TIBCO iProcess Workspace Plug-ins Installation

TIBCO iProcess Workspace Plug-ins Installation
TIBCO iProcess® Workspace
Plug-ins
Installation
Software Release 11.3
December 2011
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 THE LICENSE FILE) 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.
TIBCO, The Power of Now, TIBCO Runtime Agent, TIBCO Administrator, TIBCO Hawk, TIBCO Rendezvous,
TIBCO Adapter, TIBCO Enterprise Message Service, TIBCO SmartSockets, TIBCO Designer, TIBCO
BusinessWorks, and TIBCO iProcess Engine are either registered trademarks or trademarks of TIBCO Software
Inc. in the United States and/or 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. 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 © 2007-2011 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
| iii
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Changes From the Previous Issue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Release Notes and Readme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
TIBCO iProcess User Documentation Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xi
xi
xi
xi
Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Product Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Disk Space Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installation with More Than One iProcess Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Chapter 2 Pre-Installation Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Check For Any Late Breaking Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Plan the Order of Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 3 Installing the Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Running the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Chapter 4 Un-installing the TIBCO iProcess Workspace Plug-ins . . . . . . . . . . . . . . . . . . . . . . 21
Un-installing the TIBCO iProcess Workspace Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Un-installing a Single Instance of the TIBCO iProcess Workspace Plug-ins . . . . . . . . . . . . . . . . . . . . . . . . 22
Un-installing Multiple Instances of the TIBCO iProcess Workspace Plug-ins . . . . . . . . . . . . . . . . . . . . . . . 23
TIBCO iProcess Workspace Plug-ins Installation
iv
| Contents
TIBCO iProcess Workspace Plug-ins Installation
|v
Preface
Topics
•
Changes From the Previous Issue, page vi
•
Related Documentation, page vii
•
Documentation Conventions, page ix
•
Connecting with TIBCO Resources, page xi
TIBCO iProcess Workspace Plug-ins Installation
vi
| Changes From the Previous Issue
Changes From the Previous Issue
Major changes from the information presented in the previous issue of this
manual are as follows:
•
This release of TIBCO iProcess Workspace Plug-ins supports Windows 7
Professional. See Operating System on page 5.
•
Only Java 6 is supported in this release. Support for Java 5 has been
discontinued. See Java Runtime Environment and Java Virtual Machine on
page 6.
TIBCO iProcess Workspace Plug-ins Installation
Preface vii
|
Related Documentation
You can find more information about iProcess plug-ins from the following
sources:
Release Notes and Readme
Before you install the TIBCO iProcess Workspace Plug-ins you should read the
Release Notes and Readme supplied with the software. The Release Notes
contain the following version and platform-specific information:
•
any restrictions or known issues that apply.
•
any fixes that have been made.
•
any other information that was not available when this guide was published.
If you are installing from physical media, you can find the Release Notes and
Readme in the Docs folder.
If you are installing from a network server, you should ask your network
administrator where the Release Notes and Readme are stored.
TIBCO iProcess User Documentation Library
TIBCO iProcess Suite® user documentation is supplied as Adobe Acrobat files on
the TIBCO iProcess Suite User Documentation Library media. It provides the entire
documentation set for TIBCO iProcess products.
See the following guides for more information concerning your TIBCO iProcess
Workspace Plug-ins:
•
TIBCO iProcess® Java Plug-in User’s Guide, which explains how to define and
use EAI Java steps in your iProcess procedures. EAI Java steps can be
customized to perform the necessary business actions you require in your
procedure (such as calling methods in Enterprise Java Beans or simply
manipulating data via a Java object). The TIBCO iProcess Java Plug-in
software consists of a client plug-in (which is part of the iProcess Workspace
Plug-ins), a server plug-in (which is part of the iProcess Technology Plug-ins),
and an SDK.
•
TIBCO iProcess® BusinessWorks™ Connector User’s Guide, which explains how
to use the iProcess BusinessWorks Connector plug-ins, an efficient and easy to
use interface between TIBCO BusinessWorks™ and the iProcess Engine. The
iProcess BusinessWorks Connector consists of a client plug-in (which is part of
the iProcess Workspace Plug-ins), a server plug-in (which is part of the
TIBCO iProcess Workspace Plug-ins Installation
viii
| Related Documentation
iProcess Technology Plug-ins), and a BusinessWorks plug-in (which is also
part of the iProcess Technology Plug-ins).
•
TIBCO iProcess® Conductor User’s Guide, which provides instructions on using
the TIBCO iProcess Conductor user interface to orchestrate execution plans,
create process components, amend orders, and so on.
•
TIBCO iProcess® Modeler - Integration Techniques guide, which explains how to
use EAI steps in your procedures to control updates to external systems and
iProcess case data under transaction control.
TIBCO iProcess Workspace Plug-ins Installation
Preface ix
|
Documentation Conventions
The following typographical conventions are used in this manual.
Table 1 General Typographical Conventions
Convention
Use
ENV_NAME
TIBCO products are installed into an installation environment. A product
installed into an installation environment does not access components in other
installation environments. Incompatible products and multiple instances of the
same product must be installed into different installation environments.
TIBCO_HOME
An installation environment consists of the following properties:
•
Name Identifies the installation environment. This name is referenced in
documentation as ENV_NAME. On Microsoft Windows, the name is
appended to the name of Windows services created by the installer and is a
component of the path to the product shortcut in the Windows Start > All
Programs menu.
•
code font
Path The folder into which the product is installed. This folder is referenced
in documentation as TIBCO_HOME.
Code font identifies commands, code examples, filenames, pathnames, and
output displayed in a command window. For example:
Use MyCommand to start the foo process.
bold code
font
Bold code font is used in the following ways:
•
In procedures, to indicate what a user types. For example: Type admin.
•
In large code samples, to indicate the parts of the sample that are of
particular interest.
•
In command syntax, to indicate the default parameter for a command. For
example, if no parameter is specified, MyCommand is enabled:
MyCommand [enable | disable]
TIBCO iProcess Workspace Plug-ins Installation
x
| Documentation Conventions
Table 1 General Typographical Conventions (Cont’d)
Convention
Use
italic font
Italic font is used in the following ways:
Key
combinations
•
To indicate a document title. For example: See TIBCO ActiveMatrix
BusinessWorks Concepts.
•
To introduce new terms For example: A portal page may contain several
portlets. Portlets are mini-applications that run in a portal.
•
To indicate a variable in a command or code syntax that you must replace.
For example: MyCommand PathName
Key name separated by a plus sign indicate keys pressed simultaneously. For
example: Ctrl+C.
Key names separated by a comma and space indicate keys pressed one after the
other. For example: Esc, Ctrl+Q.
The note icon indicates information that is of special interest or importance, for
example, an additional action required only in certain circumstances.
The tip icon indicates an idea that could be useful, for example, a way to apply
the information provided in the current section to achieve a specific result.
The warning icon indicates the potential for a damaging situation, for example,
data loss or corruption if certain steps are taken or not taken.
TIBCO iProcess Workspace Plug-ins Installation
Preface xi
|
Connecting with TIBCO Resources
How to Join TIBCOmmunity
TIBCOmmunity is an online destination for TIBCO customers, partners, and
resident experts, a place to share and access the collective experience of the
TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety
of resources. To register, go to http://www.tibcommunity.com.
How to Access All TIBCO Documentation
After you join TIBCOmmunity, you can access the documentation for all
supported product versions here:
http://docs.tibco.com/TibcoDoc
How to Contact TIBCO 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 Support, visit this site:
http://www.tibco.com/services/support
•
If you already have a valid maintenance or support contract, visit this site:
https://support.tibco.com
Entry to this site requires a user name and password. If you do not have a user
name, you can request one.
TIBCO iProcess Workspace Plug-ins Installation
xii
| Connecting with TIBCO Resources
TIBCO iProcess Workspace Plug-ins Installation
|1
Chapter 1
Introduction
This chapter provides an overview of the installation program for the TIBCO
iProcess Workspace Plug-ins.
Topics
•
Product Overview, page 2
•
Installer Overview, page 3
•
System Requirements, page 5
•
Installation with More Than One iProcess Engine, page 8
TIBCO iProcess Workspace Plug-ins Installation
2
| Chapter 1
Introduction
Product Overview
The TIBCO iProcess Workspace Plug-ins include the following plug-ins:
•
TIBCO iProcess® Java Client Plug-in - This plug-in allows the process
designer to add EAI Java steps to an iProcess procedure using the iProcess
Modeler. This enables you to design an iProcess procedure that can make calls
to a custom Java object to perform some additional work.
•
TIBCO iProcess® BusinessWorks™ Client Plug-in - This plug-in provides a
set of steps that allow an iProcess procedure to invoke a TIBCO
BusinessWorks process definition.
•
TIBCO iProcess® Conductor Client Plug-ins - This consists of two plug-ins:
— TIBCO iProcess Conductor Orchestration Client plug-in - This plug-in is
needed when you are using the TIBCO iProcess Conductor. It enables you
to define Orchestration steps in your iProcess procedures.
— TIBCO iProcess Conductor Order Client plug-in - This plug-in is needed
when you are using the TIBCO iProcess Conductor. It enables you to define
Order steps in your iProcess procedures.
•
TIBCO iProcess® XML Transform Client Plug-in - This plug-in enables you
to define Transform steps in your iProcess procedures.
When installing these plug-ins, you must install them on the same machine as the
TIBCO iProcess Workspace (Windows).
TIBCO iProcess Workspace Plug-ins Installation
Installer Overview 3
|
Installer Overview
The TIBCO iProcess Workspace Plug-ins installer can be used to perform tasks
other than just to install new plug-ins on your system. When you invoke the
installer program, you are presented with the following choices for the
installation:
These choices are used to perform the following types of installation:
•
New Installation - This is used to install new TIBCO iProcess Workspace
Plug-ins on your system.
Note that you can install multiple instances of the TIBCO iProcess Workspace
Plug-ins. Each of the multiple plug-ins would be associated with a different
instance of the TIBCO iProcess Workspace (Windows). (One of the first steps
in the installation procedure is to specify the TIBCO iProcess Workspace
(Windows) the new plug-in is to be associated.)
•
Re-install/Repair/Upgrade Installation - This type of installation would be
used in two scenarios:
— To “re-install/repair” an existing installation. This returns all of the
configuration settings to their original values, i.e., the values that were
specified when the plug-ins were originally installed.
Note that a consequence of this selection is that if you had installed any
patches/hot fixes since the previous major version was installed, the
updates installed by the patches/hot fixes will be lost.
— To “upgrade” the existing installation. This is used if you had previously
installed, for instance, version 10.7.0, then want to upgrade to version 11.3.
This type of installation will present the same dialogs as a new installation,
TIBCO iProcess Workspace Plug-ins Installation
4
| Chapter 1
Introduction
although settings on the dialogs will show the settings that were specified
when the plug-ins were originally installed.
Depending on the version of the TIBCO iProcess Workspace Plug-ins that
are already installed on your system, you may be asked to first un-install
the existing plug-in, then re-run the installer to install the new version of
the plug-in. For information about un-installing the plug-ins, see
Un-installing the TIBCO iProcess Workspace Plug-ins on page 21.
•
Re-configure Existing Installation - This type of installation allows you to
change some of the configuration settings that were specified in an earlier
installation. It basically presents the same dialogs as a new installation,
allowing you to make changes.
All three of the installation types present the same dialogs that allow you to make
choices about product selection, product location, and configuration settings. For
details about the information to enter in these dialogs, see the step-by-step
procedure in Running the Installer on page 14.
Logging
If errors occur during the installation of the TIBCO iProcess Workspace Plug-ins,
you can find error information in the following log file:
—
installdir\log\TibcoiProcessPluginsInstaller.log
where:
•
installdir is the directory where the iProcess Workspace Plug-ins are installed.
After installation, each of the Workspace Plug-ins generates its own runtime log
file, as follows:
—
ClientInstall\eaijava\eaijava.guid.log
—
ClientInstall\eai_bw\eai_bw.guid.log
—
ClientInstall\logs\eai_transform.guid.log
—
ClientInstall\logs\eai_order.guid.log
—
ClientInstall\logs\eai_orch.guid.log
where:
•
ClientInstall
is the directory in which the iProcess Workspace (Windows)
is installed
•
guid is a number unique for each process
For example:
C:\TIBCOiProcessWorkspace\eaijava\eaijava.5132e81e17fdf00f00000135
01430b5c.log
TIBCO iProcess Workspace Plug-ins Installation
System Requirements 5
|
System Requirements
Disk Space Requirements
The following table provides the amount of disk space required for each plug-in.
Component
Minimum Disk Space
iProcess Java Client Plug-in
25 MB
iProcess BusinessWorks Client Plug-in
50 MB
iProcess Conductor Client Plug-ins
30 MB
iProcess XML Transform Client Plug-in
15 MB
Software Requirements
The following subsections provide information about software requirements for
the TIBCO iProcess Workspace Plug-ins.
Operating System
The TIBCO iProcess Workspace Plug-ins can be installed on machines running the
following operating systems:
•
Microsoft Windows XP:
— Professional 32-bit
— x64 Edition (64-bit)
•
Microsoft Windows Server 2003
•
Microsoft Windows Server 2003 x64
•
Microsoft Windows Server 2008
•
Microsoft Windows Server 2008 x64
•
Microsoft Windows Vista with SP1
•
Microsoft Windows 7 Professional
See the readme.txt file for this product for applicable Service Pack levels and for
any further supported operating systems.
TIBCO iProcess Workspace Plug-ins Installation
6
| Chapter 1
Introduction
TIBCO iProcess Workspace (Windows)
The TIBCO iProcess Workspace Plug-ins requires TIBCO iProcess Workspace
(Windows) Version 11.x (which includes TIBCO iProcess Modeler).
Java Runtime Environment and Java Virtual Machine
You must have a JRE/JVM installed on your system prior to installing the
iProcess Workspace Plug-ins. This release of iProcess Workspace Plug-ins
supports only Java 1.6. TIBCO have validated against the following version:
•
1.6.0_12
If you do not already have one of these versions of Java installed, it can be
downloaded from Sun.
If you need to use a different version of the JRE / JVM for any reason, TIBCO
strongly recommends that you contact TIBCO Support before doing so to
determine if the version of Java you want to use is fully compatible with the
TIBCO iProcess Workspace Plug-ins.
Character Encoding
Java provides two groups of character encoding sets:
•
Basic - supports European languages only
•
Extended - extends Basic to add support for non-European languages
For a complete list of all character encoding sets supported in each Java version,
see the following reference:
Java
Reference
1.6
http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding
.doc.html
Use this reference to determine the minimum Java version/encoding set
combination you need.
You must ensure that you use a Java version/encoding set combination that
supports all the character encoding sets you require.
•
If you have not yet installed a version of Java - before you install one of the
supported versions of Java, you should consider which character encoding
sets you require. This will have an impact on which version of Java you
choose and also on the type of Java installation you perform. For example, if
TIBCO iProcess Workspace Plug-ins Installation
System Requirements 7
|
you plan on using a character set that is in the Java 6.0 Extended set, you must
ensure that when you install Java, you install the complete international
version (with both the Basic and Extended character encoding sets). Windows
may or may not install the complete international version depending on the
language setting of the operating system. To ensure that you get the complete
set on Windows, you can perform a Custom installation and explicitly select
full support.
•
If you already have a version of Java - you should review your character encoding
set requirements using the documents on the Sun web site. Then, use the
information in this section to ensure that the version you have will provide
you with the character encoding set support you need.
TIBCO iProcess Workspace Plug-ins Installation
8
| Chapter 1
Introduction
Installation with More Than One iProcess Engine
The assumption is that the iProcess BusinessWorks Client Plug-in (delivered and
installed as part of the iProcess Workspace Plug-ins) will be used with one
instance of the iProcess Engine and iProcess BusinessWorks Server Plug-in.
This is because the introspection of the definition of a BusinessWorks step created
using the iProcess BusinessWorks Client Plug-in comes from the server, via JMX.
Therefore, the same server needs to be running for the JMX Server to be active in
order to support the client introspection requests.
The JMX Server is identified by the client_install/jmsdb.properties file, where
client_install is the location where you installed the iProcess Workspace Plug-ins.
Therefore if the client is required to connect to a different server, you must
manually amend jmsdb.properties to specify the new server, or else run the
installer selecting the Reconfigure An Existing Installation option (see page 4 for
details of this option).
TIBCO iProcess Workspace Plug-ins Installation
|9
Chapter 2
Pre-Installation Tasks
This chapter describes the tasks that you need to perform before you install the
TIBCO iProcess Workspace Plug-ins.
Topics
•
Check For Any Late Breaking Information, page 10
•
Plan the Order of Installation, page 11
TIBCO iProcess Workspace Plug-ins Installation
10
| Chapter 2
Pre-Installation Tasks
Check For Any Late Breaking Information
Status
Description
Procedure
If you are...
This task is...
Installing a new plug-in
Required
Upgrading an existing plug-in
Required
Re-installing or repairing an existing plug-in
Required
Re-configuring an existing plug-in
N/A
Before you install a plug-in you should check if there are any restrictions, known
issues or other late-breaking information that may affect your installation, but
that was not known about when this installation guide was published.
To check for late-breaking information:
1. Read the Release Notes and Readme documents that are supplied with the
plug-in software.
If you are installing from physical media, you can find these files in the docs
directory on the media.
If you are installing from a network server, you should ask your network
administrator where these files are stored.
2. Consult the “Late Breaking News” section of the TIBCO Support Web, at
(http://www.tibco.com/services/support/tibco-support-web/default.jsp).
TIBCO iProcess Workspace Plug-ins Installation
Plan the Order of Installation 11
|
Plan the Order of Installation
You may be installing other products on the same computer as iProcess
Workspace Plug-ins. If so, and if you are using Java 1.6 (see Java Runtime
Environment and Java Virtual Machine on page 6), then iProcess Workspace
Plug-ins may fail if another product has been installed after it.
If you are installing either or both of the following products:
•
TIBCO iProcess® Decisions Client Plug-in;
•
TIBCO iProcess® Web Services Client Plug-in;
ensure that iProcess Workspace Plug-ins is installed last.
TIBCO iProcess Workspace Plug-ins Installation
12
| Chapter 2
Pre-Installation Tasks
TIBCO iProcess Workspace Plug-ins Installation
| 13
Chapter 3
Installing the Plug-ins
This chapter provides the steps necessary to perform an installation of the TIBCO
iProcess Workspace Plug-ins. The only type of installation is a graphical
installation. Console and silent installation are not supported.
Topics
•
Running the Installer, page 14
TIBCO iProcess Workspace Plug-ins Installation
14
| Chapter 3
Installing the Plug-ins
Running the Installer
To install the TIBCO iProcess Workspace Plug-ins, perform the following steps:
1. Log in to the machine on which you want to install the TIBCO iProcess
Workspace Plug-ins.
2. Run the TIBCO iProcess Workspace Plug-ins setupClient.exe program.
The Welcome dialog is displayed.
3. Review the information on the Welcome dialog, then click Next to proceed.
The TIBCO Software Inc. End User License Agreement is displayed.
Note that you can cancel the installation at any point by clicking on the Cancel
button on any dialog.
4. Review the terms of the license agreement:
— if you agree to the terms, click I accept the terms of the license agreement
to continue with the installation, then click Next.
— If you do not agree to the terms of the license agreement, click I do not
accept the terms of the license agreement and exit from the installation
process by clicking on the Cancel button.
The Installation Mode dialog is displayed.
5. Choose the type of installation you are performing by clicking the appropriate
radio button, then click the Next button. The available types are:
— New installation
— Re-install, repair, or upgrade existing installation
— Reconfigure existing installation
For information about these types of installations, see Installer Overview on
page 3.
TIBCO iProcess Workspace Plug-ins Installation
Running the Installer 15
|
If you select the “Re-install, repair,...” type of installation, the following
dialog is displayed, warning you that configuration settings will be reset to
their original values in this type of installation.
Note that a consequence of performing a “Re-install, repair,...” type of
installation is that if you had installed any patches/hot fixes since the previous
major version was installed, the updates installed by the patches/hot fixes will be
lost. TIBCO recommends that you backup your system before performing this
type of installation.
6. If you are sure you want to re-install the original files, click OK to continue, or
No to return to the Installation Mode dialog.
The Destination dialog is displayed, which contains the iProcess Workspace
field:
Note that the TIBCO iProcess Workspace (Windows) must be installed prior to
installing the plug-ins — see Software Requirements on page 5) and enter it in
the iProcess Workspace field.
Note that the client-side iProcess software was renamed from the TIBCO iProcess
Client (Windows) to the TIBCO iProcess Workspace (Windows) effective
version 10.6.
7. Ensure that the iProcess Workspace field contains the path to the TIBCO
iProcess Workspace (Windows) to which you want to associate this
installation of the TIBCO iProcess Workspace Plug-ins, then click Next.
You can change this path if you want to associate the plug-ins you are
installing to another instance of the TIBCO iProcess Workspace (Windows).
TIBCO iProcess Workspace Plug-ins Installation
16
| Chapter 3
Installing the Plug-ins
The Features dialog is displayed:
The check boxes on the Features dialog allow you to select the TIBCO iProcess
Workspace Plug-ins that you want to install.
If you are performing a “New Installation”, but one or more of the plug-ins
had previously been installed for the TIBCO iProcess Workspace (Windows)
you specified in the iProcess Workspace field, the entry for the previously
installed plug-in(s) will be grayed out so that you cannot select that plug-in.
(In this case, you can re-install or reconfigure the installed plug-in — see
Installer Overview on page 3.)
Also note that the iProcess Conductor Client Plug-ins (Order and
Orchestration) and the iProcess XML Transform Client Plug-in are dependent
on the iProcess Java Client Plug-in. Therefore, if one of the aforementioned
plug-ins is selected, the TIBCO iProcess(R) Java Client Plug-in check box is
automatically selected, and cannot be unselected.
TIBCO iProcess Workspace Plug-ins Installation
Running the Installer 17
|
Note that there are no subsequent installation dialogs for the iProcess
Conductor Client Plug-ins (Order and Orchestration) or the iProcess XML
Transform Client Plug-in.
If you have selected the “Re-install, repair,...” type of installation (see
page 14), this dialog will display version numbers for those plug-ins which
are already installed on your system. Note that these will be the numbers of
the versions already installed - for example, 10.7.0.0 - not the version 11.3 that
you are now installing.
8. Check the appropriate check boxes for the plug-ins you want to install,
re-install, repair, upgrade, or re-configure, then click Next.
The Client Plug-in General Configuration dialog is displayed:
This dialog is used to collect information about the Java environment to be
used when initializing the client plug-ins, and the configuration of the HTTP
proxy (if you use one).
TIBCO iProcess Workspace Plug-ins Installation
18
| Chapter 3
Installing the Plug-ins
9. Enter information in the fields of the Client Plug-in General Configuration
dialog, then click Next when completed. The following table describes each
field:
Field
Description
Update System Path
Check the Update System Path box if you want your system PATH
environment variable to be updated to include a reference to the Java
Runtime Environment (JRE) location.
Note: If you do not have the path to the Java DLL (jvm.dll) in your
system PATH environment variable, you must select this box,
otherwise the TIBCO iProcess Workspace Plug-ins will not install
correctly.
Java Environment
Select the directory of the Java Runtime Environment you want to
use. The drop-down list will list the available JRE on your system. If
the JRE you want to use is not in the list, select Alternate location
from the drop-down list. This causes the Java Environment
(Alternate Location) field to become active (see below).
Note: The directory that is displayed must point to the library folder
underneath the JRE installation directory. For example, if the JRE is
installed in C:\Program Files\Java\j2re1.6.0_12, the Java
Environment field should contain C:\Program
Files\Java\j2re1.6.0_12\bin\client.
For more information about JREs, see Java Runtime Environment
and Java Virtual Machine on page 6.
Java Environment
(Alternate Location)
This field allows you to specify an alternate JRE path if the one you
want to use is not listed in the Java Environment field drop-down
list.
To activate this field, select Alternate location from the Java
Environment field drop-down list, then enter the desired path, or
click on the Browse button to browse to the desired path.
Use HTTP Proxy Server
Check this box if you use a proxy server to connect to the Internet for
HTTP requests. If you do not use a proxy server, leave this check box
unchecked. If you check this box, the Proxy Server and Port Number
fields become enabled (see below).
Proxy Server
Enter the path to the proxy server you are using for HTTP
connections (if applicable).
(You must check the Use HTTP Proxy Server check box to enable
this field — see above.)
TIBCO iProcess Workspace Plug-ins Installation
Running the Installer 19
|
Field
Description
Port Number
Enter the port number used by the proxy server you are using for
HTTP connections (if applicable).
(You must check the Use HTTP Proxy Server check box to enable
this field — see above.)
— If you are installing the TIBCO iProcess BusinessWorks Client Plug-in,
continue with this step, otherwise proceed to step 11.
The Server Plug-in Connection dialog is displayed:
:
This dialog is used to specify connection information to the iProcess
BusinessWorks Server Plug-in.
10. Enter information in the fields of the Server Plug-in Connection dialog, then
click Next when completed. The following table describes each field:
Field
Description
Server
Specify the name or the IP address of the machine where the
iProcess BusinessWorks Server Plug-in is installed. This is used for
remote JMX connections from within the iProcess BusinessWorks
Client Plug-in.
You can specify 127.0.0.1 if the iProcess BusinessWorks Server
Plug-in is installed on your local machine.
Port Number
Specify the port number that the iProcess BusinessWorks Server
Plug-in is using.
Note: No other process should be using this port.
The Pre-Installation Summary dialog is displayed.
TIBCO iProcess Workspace Plug-ins Installation
20
| Chapter 3
Installing the Plug-ins
11. Review the information on the Pre-Installation Summary dialog, then click
Install when satisfied.
The installer will install the appropriate files and inform you when it is
finished.
12. Click the Finish button to complete the installation of the TIBCO iProcess
Workspace Plug-ins.
TIBCO iProcess Workspace Plug-ins Installation
| 21
Chapter 4
Un-installing the TIBCO iProcess
Workspace Plug-ins
This section describes how to un-install the individual plug-ins of the iProcess
Workspace Plug-ins.
Topics
•
Un-installing a Single Instance of the TIBCO iProcess Workspace Plug-ins, page 22
•
Un-installing Multiple Instances of the TIBCO iProcess Workspace Plug-ins, page 23
TIBCO iProcess Workspace Plug-ins Installation
22
| Chapter 4
Un-installing the TIBCO iProcess Workspace Plug-ins
Un-installing the TIBCO iProcess Workspace Plug-ins
This section describes:
•
Un-installing a single instance of the TIBCO iProcess Workspace Plug-ins.
•
Un-installing multiple instances of the TIBCO iProcess Workspace Plug-ins.
Un-installing a Single Instance of the TIBCO iProcess Workspace Plug-ins
To un-install a single instance of the TIBCO iProcess Workspace Plug-ins from
your computer, following these steps:
1. Log in as either an administrator or as a user who has administrative
privileges.
2. From the Control Panel, select Add or Remove Programs.
3. In the Add or Remove Programs dialog, select:
— TIBCO iProcess(R) Workspace Plug-ins
Note that the entry in the Add or Remove Programs dialog is followed by the
iProcess Workspace installation directory name — the directory name might
be truncated if it is a long name.
If you have installed both iProcess Technology Plug-ins and iProcess Workspace
Plug-ins on the same Windows machine, or if you have installed more than one
instance of either Process Technology Plug-ins or iProcess Workspace Plug-ins,
there will be duplicate entries in the Add or Remove Programs dialog. Whichever
version was installed second will have an identifying number in brackets and will
also display the name of the directory in which it is installed; the first entry will
not display a directory name.
In addition, on Windows XP systems the directory name is truncated so the
complete path may not be visible.
If the information displayed leaves you uncertain as to which version you want to
delete, run the uninstall.exe program and exit if it is the wrong one.
4. Click Change/Remove.
The Welcome dialog is displayed.
5. Review the information on the Welcome dialog, then click Next to proceed.
A dialog is displayed that allows you to choose which of the TIBCO iProcess
Workspace Plug-ins you want to un-install.
TIBCO iProcess Workspace Plug-ins Installation
Un-installing the TIBCO iProcess Workspace Plug-ins 23
|
6. Select the appropriate plug-in(s) you want to un-install, then click Next.
The Summary dialog is displayed.
7. Review the information about the plug-in(s) that will be un-installed, then
click Uninstall.
The un-installer will inform you when it is finished.
8. Click Finish to complete the removal.
Un-installing Multiple Instances of the TIBCO iProcess Workspace Plug-ins
If you have more than one instance of one of the TIBCO iProcess Workspace
Plug-ins installed, the Add or Remove Programs dialog will list all versions
installed. However, you should not un-install them using Add or Remove
Programs. An anomaly in InstallShield can cause problems if multiple versions
are un-installed in this way. Instead, they should be un-installed using the
procedure shown below.
To safely remove the correct instance of the plug-in, complete the following steps:
1. Log in as either an administrator or as a user who has administrative
privileges.
2. Via Windows Explorer, navigate to the “uninstaller” folder that was created
when the TIBCO iProcess Workspace Plug-ins were installed. This folder was
added to the TIBCO iProcess Workspace (Windows) installation directory
when the plug-ins were installed:
— ClientInstall\_uninstCombinedInstaller
where ClientInstall is the installation directory for the iProcess Workspace
(Windows) to which the TIBCO iProcess Workspace Plug-ins you want to
un-install are associated.
3. Run the uninstall.exe program in the un-installer folder.
The Welcome dialog is displayed.
4. Review the information on the Welcome dialog, then click Next to proceed.
A dialog is displayed that allows you to choose which of the TIBCO iProcess
Workspace Plug-ins you want to un-install.
5. Select the appropriate plug-in(s) you want to un-install, then click Next.
The Summary dialog is displayed.
6. Review the information about the plug-in(s) that will be un-installed, then
click Uninstall.
TIBCO iProcess Workspace Plug-ins Installation
24
| Chapter 4
Un-installing the TIBCO iProcess Workspace Plug-ins
The un-installer will inform you when it is finished.
7. Click Finish to complete the removal.
TIBCO iProcess Workspace Plug-ins Installation
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement