TIBCO ActiveMatrix® BPM Installation: Developer Server ActiveMatrix BPM Spotfire Visualizations...

TIBCO ActiveMatrix® BPMInstallation: Developer Server Software Release 4.2August 2017

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCHEMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (ORPROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THEEMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANYOTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS ANDCONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTEDSOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THECLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOADOR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USERLICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THESOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, ANDYOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BEBOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright lawsand treaties. No part of this document may be reproduced in any form without the writtenauthorization of TIBCO Software Inc.

TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BPM, TIBCO Administrator, TIBCO BusinessStudio, TIBCO Enterprise Message Service, TIBCO General Interface, TIBCO Hawk, TIBCO iProcess,TIBCO JasperReports, TIBCO Spotfire, TIBCO Spotfire Server, and TIBCO Spotfire Web Player areeither registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or othercountries.

Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform EnterpriseEdition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks ofOracle Corporation in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of theirrespective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOTALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASEDAT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWAREVERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSOR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCOSOFTWARE 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 ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 2005-2017 TIBCO Software Inc. All rights reserved.

TIBCO Software Inc. Confidential Information

2

TIBCO ActiveMatrix® BPM Installation: Developer Server

Contents

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Installation Environment (TIBCO_HOME) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Configuration Directory (CONFIG_HOME) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Platform Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Third-Party Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

User Account Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Performing Required Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Setting Maximum Number of Open Files on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Checking Port Used by Existing Installations of PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Downloading TIBCO Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Downloading Required Third-Party Software Assemblies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installing ActiveMatrix BPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Creating an ActiveMatrix BPM Developer Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Access to Developer Server Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Restarting Developer Server After Restarting Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Installer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

TIBCO Configuration Tool Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Uninstalling ActiveMatrix BPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3


TIBCO Documentation and Support Services

Documentation for this and other TIBCO products is available on the TIBCO Documentation site. Thissite is updated more frequently than any documentation that might be included with the product. Toensure that you are accessing the latest available help topics, visit:

https://docs.tibco.com

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on theTIBCO Documentation site. To directly access documentation for this product, double-click thefollowing file:

TIBCO_HOME/release_notes/TIB_amx-bpm_version_docinfo.html

where TIBCO_HOME is the top-level directory in which TIBCO products are installed. On Windows,the default TIBCO_HOME is C:\tibco. On UNIX systems, the default TIBCO_HOME is /opt/tibco.

The following documents for this product can be found on the TIBCO Documentation site:

● TIBCO ActiveMatrix BPM SOA Concepts

● TIBCO ActiveMatrix BPM Concepts

● TIBCO ActiveMatrix BPM Developer's Guide

● TIBCO ActiveMatrix BPM Web Client Developer's Guide

● TIBCO ActiveMatrix BPM Tutorials

● TIBCO ActiveMatrix BPM Business Data Services Developer Guide

● TIBCO ActiveMatrix BPM Case Data User Guide

● TIBCO ActiveMatrix BPM Event Collector Schema Reference

● TIBCO ActiveMatrix BPM - Integration with Content Management Systems

● TIBCO ActiveMatrix BPM SOA Composite Development

● TIBCO ActiveMatrix BPM Java Component Development

● TIBCO ActiveMatrix BPM Mediation Component Development

● TIBCO ActiveMatrix BPM Mediation API Reference

● TIBCO ActiveMatrix BPM WebApp Component Development

● TIBCO ActiveMatrix BPM Administration

● TIBCO ActiveMatrix BPM Performance Tuning Guide

● TIBCO ActiveMatrix BPM SOA Administration

● TIBCO ActiveMatrix BPM SOA Administration Tutorials

● TIBCO ActiveMatrix BPM SOA Development Tutorials

● TIBCO ActiveMatrix BPM Client Application Management Guide

● TIBCO ActiveMatrix BPM Client Application Developer's Guide

● TIBCO Openspace User's Guide

● TIBCO Openspace Customization Guide

● TIBCO ActiveMatrix BPM Organization Browser User's Guide (Openspace)

● TIBCO ActiveMatrix BPM Organization Browser User's Guide (Workspace)

4


https://docs.tibco.com

● TIBCO ActiveMatrix BPM Spotfire Visualizations

● TIBCO Workspace User's Guide

● TIBCO Workspace Configuration and Customization

● TIBCO Workspace Components Developer Guide

● TIBCO ActiveMatrix BPM Troubleshooting Guide

● TIBCO ActiveMatrix BPM Deployment

● TIBCO ActiveMatrix BPM Hawk Plug-in User's Guide

● TIBCO ActiveMatrix BPM Installation: Developer Server

● TIBCO ActiveMatrix BPM Installation and Configuration

● TIBCO ActiveMatrix BPM Log Viewer

● TIBCO ActiveMatrix BPM Single Sign-On

● Using TIBCO JasperReports for ActiveMatrix BPM

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support:

● 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 canrequest one.

How to Join TIBCO Community

TIBCO Community is an online destination for TIBCO customers, partners, and resident experts. It is aplace to share and access the collective experience of the TIBCO community. TIBCO Community offersforums, blogs, and access to a variety of resources. To register, go to the following web address:

https://community.tibco.com

5


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

https://support.tibco.com

https://community.tibco.com

Introduction

A Developer Server configuration of ActiveMatrix BPM is intended for quickly performing developmentand testing on a developer's machine of a BPM application, which has been designed in TIBCOBusiness Studio.

The Developer Server configuration is intended only for rapid development and testing purposes. It isnot intended for use in a production environment and TIBCO recommends that you do not use it in aproduction environment.

If you need to install a hotfix, install the hotfix into the Developer Server TIBCO_HOME, and let TCTrecreate the instance for you using the process described in Creating an ActiveMatrix BPM DeveloperServer.

It is a simple configuration in which the following components are all installed on the same computer:

● ActiveMatrix BPM

● ActiveMatrix BPM database (using bundled PostgreSQL)

● ActiveMatrix Administrator

● TIBCO Enterprise Message Service

In addition, to enable you to model processes and deploy them, it is required that TIBCO BusinessStudio - BPM Edition is installed on the same computer.

The Developer Server configuration has been designed to be easy to install on a developer's desktop orlaptop machine, with minimal system requirements. As a result, the configuration has some limitations:

● All TIBCO software must be installed on the same machine because it cannot be accessed remotelyin this configuration.

● Only one instance of Developer Server can be installed on a machine.

● Developer Server cannot be reconfigured after it has been installed.

● Developer Server cannot be used to provide a high-availability, fault-tolerant system, nor to providespecialization and scalability.

● Developer Server uses only an internal Apache LDAP server, which is bundled with the installer. Touse a corporate LDAP server instead, you must add and configure new shared resources for the newLDAP connections, using ActiveMatrix Administrator.

● Case management features are currently not supported on a Developer Server.

● You cannot apply hotfixes to, nor upgrade, an existing Developer Server. To use a later version ofDeveloper Server, you must uninstall the installed version, and then install the later version.

6


Installation Environment (TIBCO_HOME)

You install ActiveMatrix BPM into a new installation environment. An installation environment isolatesproduct installations so that a product installed into one installation environment does not accesscomponents in another installation environment.

You should install each ActiveMatrix BPM Developer Server configuration into a new, emptyinstallation environment (separate from other ActiveMatrix BPM Developer Server configurations orother TIBCO products).

An installation environment consists of the following properties:

● Directory - The directory into which the product is installed. This directory is referred to asTIBCO_HOME. The value depends on the operating system. For example, on Windows, the defaultvalue is:

C:\Program Files\tibco\amx-bpm

● Name - The identifier of the installation environment. On Microsoft Windows, the name isappended to the name of the Windows services created by the installer and is a component of thepath to the product shortcut in the Windows Start menu.

You specify the installation environment when you run the installer.

7


Configuration Directory (CONFIG_HOME)

The directory that stores the ActiveMatrix BPM configuration information, such as scripts, session data,configured binaries, and property and log files, is referred to as CONFIG_HOME.

The value of CONFIG_HOME depends on the operating system. For example, on Windows, the defaultvalue is:

C:\ProgramData\amx-bpm\tibco\data

You specify the configuration directory when you run the installer.

8


System Requirements

There are basic system requirements that must be in place before you can install this version ofActiveMatrix BPM.

Hardware RequirementsTIBCO recommends a minimum specification for the computer on which you want to installActiveMatrix BPM.

System Memory

8 GB of virtual memory available for user applications.

Disk Space

The installer requires space in the temporary directory before installation, and additional space in thetemporary directory for running the installer. You must also make sure sufficient space is in thedirectory that you want to use as the installation environment directory (TIBCO_HOME).

While performing installation, avoid running other processes that consume disk space in TIBCO_HOME.If another process consumes disk space while the installer is copying the files, the installer might failand display a failure message.

Directory Disk Space Requirement

Temporary directoryused to hold the installer

Before you start the installation process, extract the contents of theinstallation archive to a temporary directory. The installer files consumeup to 900 MB of disk space.

Temporary directoryused during installation

The installer requires at least 900 MB of free space in the temporarydirectory used by the installer. On Microsoft Windows, this directory istypically:

%SystemDrive%:\Documents and Settings\user_name\Local

Settings\Temp

If your system does not have sufficient disk space in the defaulttemporary area, you can run the installer with a different temporarydirectory by using the following option when starting the installer:

-is:tempdir /new_temp

where /new_temp has sufficient free disk space.

Installation environmentdirectory (TIBCO_HOME)

The installer calculates the disk space required in the installationenvironment directory for the selected components. The calculation isdone before the actual installation (copying of files to the system)begins. The installer proceeds only if sufficient free disk space isavailable in the installation environment directory.

ActiveMatrix BPM can consume up to 5 GB of free space underTIBCO_HOME.

9


Platform RequirementsThe ActiveMatrix BPM Developer Server configuration supports various combinations of operatingsystem and processor architecture.

OperatingSystem (64 bit) Versions

ProcessorArchitecture

Windows Microsoft Windows 10 (with any subsequent service packs forthis version)

x86-64

Microsoft Windows 8.1 (with any subsequent service packs forthis version)

Linux Red Hat Enterprise Linux Server v6.3 or v7.1 (and anysubsequent v6.x or v7.x updates)

x86-64

CentOS Linux v6.3 or v7.1 (and any subsequent v6.x or v7.xupdates

Oracle Linux v6.3 or v7.1 (and any subsequent v6.x or v7.xupdates)

Third-Party Software Requirements

LDAP Server

ActiveMatrix BPM uses ApacheDS, with which it is bundled. If you want to use a corporate LDAPserver instead, after installing ActiveMatrix BPM, you must add and configure new shared resourcesfor the new LDAP connections, as explained in the TIBCO ActiveMatrix BPM Administration guide.

Web Browsers

ActiveMatrix BPM requires a web browser to run Openspace, Workspace, Application Management(and its example myWork application) and the ActiveMatrix Administrator GUI.

The following tables list the web browsers that are supported by the different ActiveMatrix BPMruntime user interfaces.

Openspace and Workspace

Browser Versions Notes

MicrosoftEdge

25 Includes support for EdgeHTML 13.

InternetExplorer

11 Enterprise Mode and Native Mode are supported. Compatibility Viewis not supported.

8, 9, 10 Compatibility View is not supported.

See also Support for Microsoft Internet Explorer Versions 8, 9and 10.

10



Firefox 53 The Openspace Spotfire gadget is not supported. Openspace(Accessible) is not supported.

Chrome 59 The Openspace Spotfire gadget is not supported. Openspace(Accessible) is not supported.

Openspace (Accessible)


InternetExplorer

11

8, 9 Compatibility View is not supported.


Application Development


MicrosoftEdge

25

InternetExplorer


Firefox 53

Chrome 59

Safari oniOS 10.3.2on iPad

10 Note: Apps hosted by Application Development (for example,Workapp and Case Management) are supported on Safari. ApplicationDevelopment itself is not supported on Safari.

The ActiveMatrix BPM 4.2.0 MyWork application and TIBCO Formshave been tested on an Apple iPad Air 2 running iOS 10.3. TIBCOanticipates that these components will work equally well on an iPadPro and iPad Mini although the display content will be smaller on thelatter.

iPhone and iPod Touch devices are not supported

Safari onOS X10.12.x

10 Note: Apps hosted by Application Development (for example,Workapp and Case Management) are supported on Safari. ApplicationDevelopment itself is not supported on Safari.

The ActiveMatrix BPM 4.2.0 MyWork application and TIBCO Formshave not been tested with Safari 10 on a Mac running OS X 10.12 orabove but it is expected that they will largely run satisfactorily.

11


Mobilespace

Device Notes

iOS Mobilespace uses WKWebView (1.1.4) to render the webcontent on iOS devices.

Mobilespace and the Mobile Case Management app have been tested on iPhone andiPad running iOS 10.3.2.

Android Mobilespace uses crosswalk-webview (2.3.0) to render the webcontent on Androiddevices

TIBCO ActiveMatrix Administrator (GUI)


InternetExplorer


9, 10 Compatibility View is not supported.


8 SP2 is required.


Firefox 26

The Supported Versions specified are the minimum versions of each browser that are supported byActiveMatrix BPM. Unless otherwise specified, you can use a more recent version of a browser as longas the vendor claims the recent version to be compatible with the specified version.

In the event of a problem with a more recent browser version, TIBCO will employ reasonable efforts toprovide support on that browser version. However, TIBCO may request that you reproduce theproblem on a supported version of the browser. This may mean that you potentially change to adifferent version that does not exhibit the issue; ideally only on a temporary basis.

Support for Microsoft Internet Explorer Versions 8, 9 and 10

In January 2016, Microsoft stopped support for all but the latest version of Internet Explorer oncurrently supported Microsoft operating systems. This means that version 11 is the only fullysupported version of Internet Explorer. TIBCO is aware that some customers may still be using InternetExplorer versions 8, 9 or 10.

TIBCO's support for these older versions of Internet Explorer in this version of ActiveMatrix BPM isbased on previous versions of TIBCO ActiveMatrix BPM (Openspace and Workspace) having beensupported and working. If customers using these older versions of Internet Explorer report problemswith their use with Openspace, Workspace or TIBCO ActiveMatrix Administrator (GUI) and aworkaround is not available, neither TIBCO nor Microsoft will be able to assist further and TIBCO willrecommend using a supported browser.

12


User Account RequirementsThe operating system user account that is used to install ActiveMatrix BPM must have the appropriateprivileges.

● Windows - You must have Administrator privileges for the computer on which ActiveMatrix BPMis installed. If you do not have Administrator privileges, the installer exits. You must then either logoff Windows and log on as a user with the required privileges, or request your system administratorto assign the privileges to your account.

To run TIBCO Configuration Tool separately (as opposed to the installer running it), you must right-click tct and select Run as administrator.

● Linux - Any type of user (regular (non-root) user or super-user (root)) can install ActiveMatrix BPM.

13


Performing Required Pre-Installation Tasks

You must perform various tasks before installing ActiveMatrix BPM.

Setting Maximum Number of Open Files on LinuxThe maximum number of open files/file descriptors that a user can open is controlled by the operatingsystem. However, the default threshold on Linux is typically too low and has to be increased.

● TIBCO recommends that you set the maximum number of open files/file descriptors to a value ofat least 10000.

Checking Port Used by Existing Installations of PostgreSQLIf you are using PostgreSQL, or a product that bundles PostgreSQL, on the computer on which youwant to install ActiveMatrix BPM, check that it does not use port 5434.

This port is used by the PostgreSQL database that is bundled with ActiveMatrix BPM Developer Server.

Downloading TIBCO SoftwareDownload ActiveMatrix BPM and, if necessary, TIBCO Enterprise Message Service™. Extract thecontents of the .zip file(s) to the computer on which you want to install ActiveMatrix BPM.

Procedure

1. Check if the computer on which you want to install ActiveMatrix BPM has a supported version ofEnterprise Message Service™ installed.ActiveMatrix BPM uses Enterprise Message Service for notification and messaging. To see whichversions of Enterprise Message Service are supported, see the ActiveMatrix BPM Readme.

2. If a non-supported version of Enterprise Message Service is installed, download a supportedversion from the TIBCO Software Product eDelivery Site (http://edelivery.tibco.com/) and upgrade,following the Enterprise Message Service installation guide.

3. If Enterprise Message Service is not installed, download it from the TIBCO Software ProducteDelivery Site (http://edelivery.tibco.com/).

4. Download the ActiveMatrix BPM package for your platform from the TIBCO Software ProducteDelivery Site (http://edelivery.tibco.com/).

5. If you have downloaded both Enterprise Message Service and ActiveMatrix BPM, check whichpackage contains the later version of the installer.To do this, in each .zip file, open the product_product-name_version_FeatureConfig.xml file,and check the values of universalinstallerversion and universalinstallerrelease.For example, universalinstallerversion="V7" universalinstallerrelease="3.2.5" meansthat the complete release number is 3.2.5.7.

6. Extract the contents of the .zip file(s) to a temporary, empty directory on the computer on whichyou want to install ActiveMatrix BPM. If you have downloaded both products, extract the contentsof the .zip file that contains the older installer first, then extract the contents of the other .zip fileto the same directory, merging subdirectories that have the same name and overwriting installerfiles that have the same name.

On Linux, open a terminal window and use the unzip command to unzip the package. Donot double-click the package to extract its contents: doing so may cause a problem if youtry to start TIBCO Configuration Tool after running the installer.

14


http://edelivery.tibco.com/



Downloading Required Third-Party Software AssembliesActiveMatrix requires some third-party LGPL software assemblies to be installed. If they are notalready installed on the computer on which you want to install ActiveMatrix BPM, and that computerdoes not have internet access, you must download the assemblies before you install ActiveMatrix BPM.They can then be installed automatically by the ActiveMatrix BPM installer.

The required assemblies are:

● Hibernate

● Eclipse SWT GTK module (only required if you are installing on Linux)

● Oracle Java 7 Elliptic Curve Cryptography (ECC) library

Procedure

1. From the TIBCO Software Product eDelivery Site (http://edelivery.tibco.com/), download Hibernate.

When downloading Hibernate, the number in the package name refers to the assemblynumber and not the version of Hibernate. This can be misleading as the assembly numberis not the same as the Hibernate version number. For example, the package name whendownloading Hibernate version 3.2.7 is:

assembly_tibco_com_tpcl_ord_hibernate_feature_3.2.400.001.zip

2. If you are installing on Linux, download the Eclipse SWT GTK module for your platform.

3. Download the Oracle ECC library for your platform.

4. Extract the contents of the downloaded .zip files to the assemblies subdirectory of the directory inwhich you extracted the contents of the ActiveMatrix BPM .zip file.

15



Installing ActiveMatrix BPM

To install ActiveMatrix BPM and, if necessary, Enterprise Message Service, run the TIBCO UniversalInstaller.

Prerequisites

An existing installation of the Developer Server cannot be upgraded. To use a later version ofDeveloper Server, you must uninstall the installed version, and then install the later version. (Hotfixesalso cannot be applied to an installed Developer Server.)

Procedure

1. Go to the directory in which you extracted the contents of the ActiveMatrix BPM package.

2. Run TIBCOUniversalInstaller.cmd.

On Linux, open a terminal window and run TIBCOUniversalInstaller.cmd from thecommand line. Do not double-click the file to run it: doing so may cause a problem if youtry to start TIBCO Configuration Tool after running the installer.

3. Ensure that you complete the following installer pages as shown:

Page Requirements

TIBCO Installation Home Ensure that Create a new TIBCO_HOME is selected and thatDirectory does not specify the directory of an existinginstallation environment. (See Installation Environment for moreinformation.)

Installation Profile Selection1. In the left pane, select Developer Server.

2. If you are installing Enterprise Message Service as well, pressCtrl and click Development in the left pane.

With earlier versions of Enterprise MessageService, the left pane does not contain aDevelopment option. Instead, select the EMS checkboxes in the right pane.

TIBCO EMS Server ServiceSettings

On Windows, if you are installing Enterprise Message Service aswell, click Automatic to enable the service to start automaticallyon Windows startup.

Post Install Summary Ensure that the Launch TIBCO Configuration Tool check box isselected.

Although the Developer Server profile is not listed on the Pre-Install Summary and thePost Install Summary pages, it is installed.

4. Click Finish.

When ActiveMatrix BPM has been installed, TIBCO Configuration Tool is started and the TIBCOConfiguration Folder dialog is displayed. Do not change the folder.

16


Creating an ActiveMatrix BPM Developer Server

To create an ActiveMatrix BPM Developer Server, run the Create TIBCO ActiveMatrix BPM Serverwizard from TIBCO Configuration Tool.

Procedure

1. In the TIBCO Configuration Folder dialog, click OK to accept the default. Do not change the folder.

If you need to restart TIBCO Configuration Tool, run this command:

TIBCO_HOME\bpm\n.n\bin\tct

On Windows, you must right-click tct and select Run as administrator.

2. In the Create new configurations dialog, click Create TIBCO ActiveMatrix BPM Server.

The Create TIBCO ActiveMatrix BPM Server wizard is started.

3. Ensure that the Enterprise Message Service server is running, on port 7222. To start the server:

● On Windows, start the TIBCO EMS Server service from the Services window of Control Panel.

● On Linux, run this command:

EMS_HOME/bin/tibemsd.sh

where EMS_HOME is the directory in which Enterprise Message Service is installed. If youinstalled it when you installed ActiveMatrix BPM, the path of the command is:

TIBCO_HOME/ems/n.n/bin/tibemsd.sh

4. On the Welcome page of the wizard, click Next.

5. If the wizard detects that there is already a Developer Server instance on this computer, theActiveMatrix BPM: Clean Existing Developer Server page is displayed. If you are happy to deletethe instance, select the Remove existing Developer Server check box and click Next.

The entire Developer Server instance, including ActiveMatrix BPM, ActiveMatrixAdministrator, their associated databases, and all data, will be deleted.

6. On the ActiveMatrix BPM Configuration: Summary page, click Configure.

TIBCO Configuration Tool creates a Developer Server instance on this computer, which takesseveral minutes.

7. When TIBCO Configuration Tool has created a Developer Server instance on this computer, clickClose to exit the wizard, and click Close to exit TIBCO Configuration Tool.

If you need to install a hotfix, install the hotfix into the Developer Server TIBCO_HOME,and let TCT recreate the instance for you using the process described in this topic.

Result

You have finished installing ActiveMatrix BPM Developer Server. You can use the software only on thiscomputer because it cannot be accessed remotely in this configuration.

17


Access to Developer Server Components

To access the ActiveMatrix BPM Developer Server components, use the following addresses andcredentials. The credentials cannot be specified during installation: they are assigned default values.

ActiveMatrix Administrator

● Address: http://127.0.0.1:8120/amxadministrator/loginform.jsp

● Username: root

● Password: t

ActiveMatrix BPM

● Username: tibco-admin

● Password: secret

ActiveMatrix BPM Database

● Username: bpmuser

● Password: bpmuser

Openspace

● Address: http://127.0.0.1:8181/openspace/openspace.html

● Username: tibco-admin

● Password: secret

18


Restarting Developer Server After Restarting Computer

If you restart the computer on which you have installed the Developer Server, the TIBCO processesmay need to be restarted.

● On Windows, the TIBCO ActiveMatrix, PostgreSQL for AMX-BPM, and TIBCO EMS Serverservices should be restarted automatically.

To check this, open the Services window of Control Panel.

● On Linux:a) Restart the Enterprise Message Server daemon by running this command:

EMS_HOME/bin/tibemsd.sh

where EMS_HOME is the directory in which Enterprise Message Service is installed. If youinstalled it when you installed ActiveMatrix BPM, this path is equivalent to:

TIBCO_HOME/ems/n.n/bin/tibemsd.sh

where n.n is the version of ActiveMatrix BPM.b) Restart the TIBCO ActiveMatrix and PostgreSQL for AMX-BPM processes by running this

command:

TIBCO_HOME/bpm/n.n/bin/dev_ctl start

where n.n is the version of ActiveMatrix BPM.

19


Troubleshooting

If you have problems installing ActiveMatrix BPM or creating a Developer Server, there are a fewthings that you should do to try to resolve them.

● Make sure that your computer meets all prerequisites.

See System Requirements.● Check the installer log file for potential problems.

See Installer Log File.● Check the TIBCO Configuration Tool log file for potential problems.

See TIBCO Configuration Tool Log File.● Re-create the Developer Server.

Repeat the procedure described in Creating an ActiveMatrix BPM Developer Server. If the CreateTIBCO ActiveMatrix BPM Server wizard detects that there is already a Developer Server instanceon this computer, the ActiveMatrix BPM: Clean Existing Developer Server page is displayed. Youcan then confirm that you are happy to delete the instance completely, so that a fresh instance canbe created.

● Uninstall then reinstall ActiveMatrix BPM.

See Uninstalling ActiveMatrix BPM and Installing ActiveMatrix BPM.

On Windows, sometimes the TIBCO ActiveMatrix service is left with a "Disabled" statusinstead of being removed by the uninstaller. Before reinstalling ActiveMatrix BPM, youmust restart the computer to remove the service. If you do not restart, the service cannotbe re-created during re-creation of the Developer Server.

Installer Log FileThe installer log file contains information about the installation that was performed. Separate log filescontain information about scripts that the installer ran.

The installer log file, tibco_universal_installer.username_install.log, is written to the .TIBCO/install_timestamp directory of the user’s home directory. To change the location of the installer logfile, specify the option -V logFile="myLogFile" when you run the installer.

The installer log file captures the following information:

● Installation environment details such as user that invoked the installer, operating system details,installer mode, host name, JAVA_HOME and the Java version available in that environment, and soon.

● List of assemblies installed.

Information related to the Ant scripts that are executed by the installer is logged in separate log files:

antTask_log_scriptname_timestamp

under the directory:

install_timestamp

TIBCO Configuration Tool Log FileWhen you run the Create TIBCO ActiveMatrix BPM Server wizard from TIBCO Configuration Tool, alog file is created. Examining this file may help you if you have a problem when running the wizard.

The log file is stored under the directory specified in the Session Scripts and Log Folder field of thewizard’s Summary page. By default, this directory is:

20


CONFIG_HOME\tct\bpm\timestamp

The logs subdirectory contains a separate log file for each configuration action executed by TIBCOConfiguration Tool. Log files are created when you click Save or Configure from a wizard.

21


Uninstalling ActiveMatrix BPM

To uninstall ActiveMatrix BPM, stop the TIBCO processes, run the TIBCO Universal Uninstaller, anddelete ActiveMatrix BPM directories.

Procedure

1. Stop the TIBCO processes.

● On Windows, stop the TIBCO ActiveMatrix and PostgreSQL for AMX-BPM services.

● On Linux, run this command:

TIBCO_HOME/bpm/n.n/bin/dev_ctl stop

where n.n is the version of ActiveMatrix BPM.

2. Ensure that you are logged on to the computer with the correct privileges:

● On Windows, you must have Administrator privileges.

● On Linux, you must be logged on as the same user who installed ActiveMatrix BPM. If morethan one product installation has been made to the same environment and you want touninstall them all, you should uninstall as the root user.

3. Run the TIBCO Universal Installer:

● On Windows, click the following:

Start > All Programs > TIBCO > ENV_NAME > Uninstall● On Linux, change to:

TIBCO_HOME/tools/universal_installer

Run ./TIBCOUniversalInstaller-platform_id.extension.

4. On the TIBCO Installation Manager page of the installer, click Uninstall Products from a TIBCOHome Location and then select the location of TIBCO Home from the list. Click Next.

5. When the TIBCO Universal Uninstaller is started, complete the uninstaller pages as required. Onthe Pre-Uninstall Summary page, click Uninstall.

The uninstaller removes ActiveMatrix BPM.

6. The Running ANT Tasks page is displayed while the selected components are uninstalled. Whenyou are asked about the cleanup of the /tools directory, click Yes, clean it up.

7. On the Post Uninstall Summary page, click Finish.

The uninstaller exits and cleans up any temporary files.

On Windows, the TIBCO ActiveMatrix BPM entries in the Start menu may remain afterthe uninstallation. To correct this, log off, then log on again.

On Linux, if an error message similar to the following is displayed after uninstallation, logout and log in again for the uninstaller changes to take effect:

The wizard requires that you logout and log back in

8. Manually delete the TIBCO ActiveMatrix BPM directories under TIBCO_HOME.

9. Manually delete the TIBCO ActiveMatrix BPM directories under CONFIG_HOME.

22


Date post:	29-Jun-2018
Category:	Documents
Upload:	phungcong
View:	227 times
Download:	1 times