TIBCO ActiveMatrix® BPM Installation and Configuration Software Release 1.
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.
| iii Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii Changes from the Previous Release of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iv | Contents Chapter 3 Pre-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Setting up the Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 TIBCO ActiveMatrix BPM Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 TIBCO ActiveMatrix Administrator Database. . . . . . .
Contents v | Create TIBCO Host Instance Wizard Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Create TIBCO ActiveMatrix Administrator Server Wizard Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Create TIBCO ActiveMatrix BPM Server Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Configure TIBCO ActiveMatrix BPM Server Node Type Reference. . . . . . . .
vi | Contents Chapter 11 Recovering from a Failed Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Sanitizing After a Failed Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 Chapter 12 Uninstalling TIBCO ActiveMatrix BPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 Uninstalling TIBCO ActiveMatrix BPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
| vii Preface This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme file for the availability of this software version on a specific operating system platform. TIBCO ActiveMatrix BPM is TIBCO’s next-generation business process management platform. This guide provides the information needed to install and configure the product.
viii | Changes from the Previous Release of this Guide Changes from the Previous Release of this Guide This section itemizes the major changes from the previous release of this guide. Sizing Configuration for TIBCO ActiveMatrix BPM You can now set the initial system sizing values when configuring your TIBCO ActiveMatrix BPM Server in TIBCO Configuration Tool (TCT). See Chapter 5, Creating and Configuring Runtime Objects, on page 92 for details.
Preface ix | Typographical 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.
x | Typographical Conventions Table 1 General Typographical Conventions (Cont’d) Convention Use bold code Bold code font is used in the following ways: font • 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.
Preface xi | Table 2 Syntax Typographical Conventions Convention Use [ ] An optional item in a command or code syntax. For example: MyCommand [optional_parameter] required_parameter | A logical OR that separates multiple items of which only one may be chosen. For example, you can select only one of the following parameters: MyCommand para1 | param2 | param3 { } A logical group of items in a command. Other syntax notations may appear within each logical group.
xii | Connecting with TIBCO Resources Connecting with TIBCO Resources How to Join TIBCOmmunity TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is 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 TIBCO Documentation You can access TIBCO documentation here: http://docs.tibco.
|1 PART ONE INTRODUCTION TIBCO ActiveMatrix BPM Installation and Configuration
2 | Chapter 1 Introduction Chapter 1 Introduction This chapter explains installation modes, requirements, and other options you should be aware of before starting the installation.
Installation Overview 3 | Installation Overview The installation and configuration of the product involves the following steps: 1. Complete the pre-installation tasks which includes fulfilling the hardware and software requirements, and setting up and configuring all the required third party software. 2. Install TIBCO ActiveMatrix BPM. Depending on the architecture, the installation process may involve repeating the basic installation on different machines in one of the installation modes. 3.
4 | Chapter 1 Introduction Console Mode Console mode allows you to run the installer from the command prompt or terminal window. This is useful if your machine does not have a GUI environment. Silent Mode Silent mode installs the product using either default or custom settings that are saved in a response file and does not prompt for inputs. Installation Types Two installation types are available: Profile or Custom. • The Profile installation type installs all the software for a specific profile.
Installation Overview 5 | Feature Description TIBCO Host TIBCO Host is the runtime object that serves as the point of contact between TIBCO ActiveMatrix BPM nodes and Administrator server. TIBCO Host has a staging area that contains product and custom features available to the nodes it manages. It performs operations such as software distribution, node creation, node life cycling, and application deployment.
6 | Chapter 1 Introduction • 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 so on. • 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 folder install_timestamp.
Installation Requirements 7 | Installation Requirements This section describes the disk space requirements, system memory requirements, software requirements, and certified and compatible versions of operating systems and databases for this product. Disk Space Requirement Before installing this product, extract the contents of the installation archive to a temporary directory. The installer files consume up to 600 MB of disk space.
8 | Chapter 1 Introduction Hardware Requirements TIBCO recommends the following minimum server machine specification for all platforms: • Two 3GHz dual processors. • 8 GB of virtual memory available for user applications • 5 GB of free space on the local drive where you are installing TIBCO ActiveMatrix BPM. Supported Platforms Refer to the product readme file for the supported operating system platforms and versions and required patches.
Installation Requirements 9 | This document lists the operating systems and databases with standard support from the vendors. If you are using an operating system or a database with an extended support, contact TIBCO Support (How to Contact TIBCO Support) to know if the version is compatible with TIBCO ActiveMatrix BPM.
10 | Chapter 1 Introduction Compatible Versions Vendors follow different numbering conventions for releasing patches, and major or minor releases. See the vendor documentation for details about the release numbering conventions for their products. Compatibility with higher versions is indicated by appending a plus sign ’+’ to the minimum compatible version of the operating system or database.
Installation Requirements 11 | Microsoft SQL Server Platform 2008 (x64)+ 2008 R2 (x64)+ Enterprise Edition R2 11.2.0.2+2 Standard Edition R2 11.2.0.2+ RAC 11.2.0.2+ 9.7.3+3 9.7.4+ No No Yes Yes Yes Yes Yes 1 IBM Power Systems AIX v6.1 (64bit)+7 DB2 Workgroup Edition Oracle 11g 1. Microsoft releases service packs periodically, indicated by an alpha-numeric version number ’SPN’.
12 | Chapter 1 Introduction Table 4 Certified Browsers Internet Explorer 7 (only With Google Chrome Frame Plug-in) Firefox 7 Chrome 14 (Google Chrome Frame Plug-in v14) GWT Gadgets No Yes Yes GI Gadgets Yes Yes Yes Spotfire No No No Mobile GWT Gadgets No No No GWT Form Yes Yes Yes GI Form Yes Yes Yes No No Component Openspace Workspace1 TIBCO ActiveMatrix Administrator Administrator No 1. Workspace is certified with Google Chrome Frame plug-in version 14.
Installation Requirements 13 | Table 5 Compatible Browsers Google Chrome Internet Explorer Mozilla Firefox Safari 7+ GCF* 8 9+ 3.5 3.
14 | Chapter 1 Introduction messaging backbone for TIBCO ActiveMatrix BPM. TIBCO ActiveMatrix BPM is not necessarily installed on the machine on which TIBCO Enterprise Message Service is installed. This software is distributed and installed separately from TIBCO ActiveMatrix BPM software. TIBCO Enterprise Message Service can also used by the TIBCO ActiveMatrix SOAP and JMS binding types.
Installation Requirements 15 | If your installation machine is not connected to the Internet, you must download the assembly containing Hibernate and save it to the assemblies subdirectory of the temporary directory where your installer archive is extracted (the preferred option to streamline installation) or to another temporary directory accessible to the installation machine. On the TIBCO download site, click TIB_assembly_tibco_com_tibco_tpcl_org_hibernate_feature_3.2.4.
16 | Chapter 1 Introduction is one of linux24gl23_x86, linux24gl23_x86_64, sol10_x86, sol10_x86_64, linux26gl24_s390x, sol9_sparc_64, sol9_sparc. Java Virtual Machine Required. JDK 1.6.0_24 (64 bit) is packaged with TIBCO ActiveMatrix BPM as a convenience. DBMS Software Required. The database stores TIBCO ActiveMatrix Administration information. For development purposes, the following DBMS software is supported: • HSQLDB 1.8.1 HSQLDB 1.8.1.
Installation Requirements 17 | You must package the Microsoft SQL and Oracle JDBC drivers into TIBCO ActiveMatrix Administrator before creating an ActiveMatrix Administrator server. Web Browsers Required. A web browser is required to run TIBCO ActiveMatrix Administrator GUI and the TIBCO ActiveMatrix BPM clients - TIBCO Workspace and TIBCO Openspace.
18 | Chapter 1 Introduction • Apache Directory Server 1.5.
| 19 Chapter 2 Pre-install Considerations This chapter describes the factors to be considered before installing the product.
20 | Chapter 2 Pre-install Considerations Determine the Architecture for Your System The architecture of a system depends on various factors such as: • Number of users for the system (includes registered, concurrent, and active users). • Scalability • Performance expectations • Typical work volumes such as the number of work items, pageflows, business services, or enterprise processes that need to be processed per minute.
Determine the Architecture for Your System 21 | Basic System A basic system consists of a simple installation with all the components installed on a single machine that can be used for validation purposes. This type of setup is not suitable nor recommended for production purposes. However, you can use this for testing or demonstration purposes. Installing the Product describes how to install a basic system.
22 | Chapter 2 Pre-install Considerations Using Third Party Solution Figure below illustrates the use of third-party solutions to provide highly available, fault tolerant capabilities to your BPM runtime. The setup requires at least three machines, say M1, M2, and M3, where: • TIBCO ActiveMatrix BPM (or at least the data folder) is on the shared file system which is only available to the machine that has a fully operational TIBCO ActiveMatrix BPM node installed and running.
Determine the Architecture for Your System 23 | Using Active-Active Cluster TIBCO ActiveMatrix BPM can be deployed to provide a high-availability, fault-tolerant configuration, using active-active clustering. Figure below illustrates the logical architecture using an active-active clusters to provide a highly available, fault tolerant capability to the BPM runtime. See Using Active-Active Clustering on page 56 for details on implementing this scenario.
24 | Chapter 2 Pre-install Considerations Some example scenarios that a distributed system can cater to include: • an enterprise whose focus is on straight-through processing and enterprise integration may want to direct more resources to Process Manager nodes. • a call center-based enterprise may require more Work Manager nodes. A distributed configuration requires homogenous software configuration. Each member of the cluster must use the same TIBCO ActiveMatrix BPM logical node type.
Determine the Architecture for Your System 25 | The following diagram illustrates this scenario: Machine 1 Machine 2 Web Components Web Components Service virtualization Process Manager Work Manager Process Service virtualization Work Manager Manager TIBCO Active Matrix BPM Node A on Host instance 1 TIBCO Active Matrix BPM Node B on Host instance 2 Cluster 1 Machine 3 Work Manager BPM database TIBCO Active Matrix BPM Node C on Host instance 3 Cluster 2 TIBCO ActiveMatrix runtime TIBCO ActiveM
26 | Chapter 2 Pre-install Considerations In such a distributed environment: • The capacity of each part of the system - web tier, process management, or work management - can be scaled up or down as requirements change by adding or removing further logical nodes to the relevant cluster (subject to the underlying capabilities of the cluster itself). • Nodes can be hosted on individual clusters, single machines, or all parts of the system on non-clustered machines.
Disaster Recovery 27 | Disaster Recovery TIBCO recommends replicating the key parts of the BPM runtime to ensure that your system can be recovered in the event of a disaster. The data from following parts of a TIBCO ActiveMatrix BPM system must be replicated on a separate system such that all data sources are consistent. • TIBCO_HOME and CONFIG_HOME directories for the TIBCO ActiveMatrix BPM installation. If the BPM configuration files are in a different location, you must replicate them as well.
28 | Chapter 2 Pre-install Considerations Highly Available ActiveActive System Third-party software solution to replicate essential system data Replicated Backup System TIBCO ActiveMatrix BPM Installation and Configuration
Backup and Restore 29 | Backup and Restore A backup of your system ensures that a stable version of your system is available for use in case the running system runs into problems and gets corrupted. In such a case, you can restore your system using the backup to the last backed up stable state. Depending on the backup mechanism employed, there may be some amount of data loss. Back Up Your System Before taking a backup, ensure that the system is in a state where a back-up can be performed.
30 | Chapter 2 Pre-install Considerations 1. Shutdown TIBCO ActiveMatrix BPM. Refer to TIBCO ActiveMatrix BPM Administration Guide for information. 2. Shutdown the TIBCO Enterprise Message Service server. Refer to the documentation supplied with TIBCO Enterprise Message Service for information. 3. Copy the contents of TIBCO_HOME and CONFIG_HOME directories from the backup to their original location. 4. Recover the TIBCO ActiveMatrix BPM database and make sure the database is online.
Decide the Approach to Create the Databases 31 | Decide the Approach to Create the Databases The ActiveMatrix BPM database and Administrator database are required for the successful installation of the product. You can choose to use one of the following: • HSQLDB that is bundled with the software, or • An external database. If you decide to use the external databases, ensure that the databases are created and any required configurations are completed. See Setting up the Databases for details.
32 | Chapter 2 Pre-install Considerations TIBCO ActiveMatrix BPM Installation and Configuration
| 33 PART TWO INSTALLATION TIBCO ActiveMatrix BPM Installation and Configuration
34 | Chapter 3 Pre-Installation Tasks Chapter 3 Pre-Installation Tasks This chapter describes the tasks that need to be performed to configure the third party software before installing TIBCO ActiveMatrix BPM.
Setting up the Databases 35 | Setting up the Databases Depending on the approach chosen to setup the database, you may need to configure the database before installing the product. The pre-install configurations are not required if you choose to allow TIBCO Configuration Tool to create the TIBCO ActiveMatrix BPM database.
36 | Chapter 3 Pre-Installation Tasks 3. Connect to SQL Server 2008 Management Studio as an administrator of the SQL Server Instance. 4. From the location where you installed the Microsoft SQL Server JDBC Driver, run the sqljdbc_n.n\enu\xa\xa_install.sql script against the master database where n.n is the version number of the Microsoft SQL Server JDBC Driver you are using. The first time you run this you may see errors about failing to drop procedures.
Setting up the Databases 37 | Set OPEN CURSORS for the Database Login to the TIBCO ActiveMatrix BPM database as the DBA and set the maximum open cursors for the database to at least 400 using the following: ALTER SYSTEM SET OPEN_CURSORS=400 SID=db_name Using DB2 Create User To Grant Permissions on The Database Identify an operating system user, or create a new operating system user if needed who can be granted the ActiveMatrix BPM database user permissions.
38 | Chapter 3 Pre-Installation Tasks You can set the statement termination character from the DB2 Control Center as shown below: TIBCO ActiveMatrix Administrator Database When running the Create TIBCO ActiveMatrix BPM wizard, you must specify a database for the TIBCO ActiveMatrix Administrator server. The default database type is the database that you selected for your TIBCO ActiveMatrix BPM database.
Setting up the Databases 39 | described before running the Create TIBCO ActiveMatrix BPM wizard or Create TIBCO ActiveMatrix Administrator Server wizard: Oracle 11gR2 database: Ensure that the Oracle user specified when configuring the TIBCO ActiveMatrix Administrator server does not possess the "dba" privileges. However, the user must have connect and resource privileges, and be assigned to the default schema.
40 | Chapter 3 Pre-Installation Tasks Configuring Other Third Party Software This section describes the considerations and any additional configurations that need to be performed on the third party software before installing ActiveMatrix BPM. LDAP Server If you want to specify an external LDAP directory server then, before you install TIBCO ActiveMatrix BPM, you must: • specify an LDAP username and password for the tibco-admin user, see below. • ensure that the LDAP server is running.
Configuring Other Third Party Software 41 | • SQL Server 2008 with Service Pack 1 or later: a. Depending on the version of the Microsoft SQL Server JDBC Driver you want to use, download either: —Microsoft SQL Server JDBC Driver 3.0 from http://www.microsoft.com/download/en/details.aspx?id=21599 —Microsoft SQL Server JDBC Driver 2.0 from http://www.microsoft.com/download/en/details.aspx?id=2505 b. Follow the instructions to install the driver.
42 | Chapter 3 Pre-Installation Tasks 2. Run the following lines from a command shell: On Windows set JAVA_HOME=%TIBCO_HOME%\tibcojre\1.6.0 set CLASSPATH=%TIBCO_HOME%\tools\lib\antpackage.jar set RUN_ANT="%JAVA_HOME%/bin/java" -XX:MaxPermSize=1024m -cp "%CLASSPATH%" org.apache.tools.ant.Main set ANT_OPTS=-Xmx1024m -XX:MaxPermSize=1024m -Xms256 On UNIX/Linux JAVA_HOME=$TIBCO_HOME/tibcojre64/1.6.0 CLASSPATH=$TIBCO_HOME/tools/lib/antpackage.
Configuring Other Third Party Software 43 | The xulrunner folder might have a version attached to it. In that case make sure you specify the correct folder name.
44 | Chapter 3 Pre-Installation Tasks TIBCO ActiveMatrix BPM Installation and Configuration
| 45 Chapter 4 Installation This chapter describes how to install TIBCO ActiveMatrix BPM in one of the installation modes: GUI, console, or silent.
46 | Chapter 4 Installation Installing the Product Install the product using one of the modes described in the sections: • Installing in GUI mode on page 46 • Installing in Console mode on page 50 • Install in Silent mode on page 50 When installing the Administration or Runtime Host profiles in GUI mode, the installer allows you to invoke the TIBCO Configuration Tool, a utility to create an ActiveMatrix Administrator server, TIBCO Host instances, and a BPMNode node, and package third-party drivers.
Installing the Product 47 | 9. Click Next. The TIBCO Installation Home screen displays. Choose a new installation environment or an existing installation environment: — Create a New TIBCO_HOME Specify the properties: Directory The directory into which the product is installed. The directory cannot be the same as the directory of an existing installation environment. Accept the default location, type a directory, or click Browse to choose the directory.
48 | Chapter 4 Installation assembly. The assembly is automatically downloaded and stored into the assemblies subdirectory of the directory where you extracted TIBCO ActiveMatrix Service Grid software. — Select the Hibernate assembly previously downloaded from TIBCO Choose this option if you are not connected to the Internet. Click Browse to navigate to the directory where a Hibernate assembly that was previously downloaded is stored. Select the assembly and click Open. 12.
Installing the Product 49 | product_tibco_eclipse_lgpl_3.5.2.001 assembly that was previously downloaded is stored. Select the assembly and click Open. 15. Linux and Solaris Click Next. If you chose to download the assembly, a screen displays the assembly download process. 16. The TIBCO Configuration Directory screen displays. The configuration directory (CONFIG_HOME) stores BPM configuration information, for example, the properties for Workspace and Openspace.
50 | Chapter 4 Installation To change any of your choices, click Back to navigate back to the appropriate point. You can then restart the installation process from that point. 18. Click Install. While the installer performs the necessary installation tasks, the Installing Component n of NN screen displays, where NN is the total number of components to be installed. After all the components are installed, the Running Product ANT Tasks screen displays.
Installing the Product 51 | The TIBCOUniversalInstaller-amx-bpm_1.3.0.silent file is packaged in the directory that contains the universal installer. Edit the file with information for your environment before launching the silent installation. The .silent file includes comments that describes the installation properties that you can set. It is a good practice to make a copy of the original TIBCOUniversalInstaller-amx-bpm_1.3.0.silent file before making any changes to it.
52 | Chapter 4 Installation Parameter Value Description configDirRoot Default: Location of the configuration files for the given installation environment. C:\ProgramData\amx-b pm 6.
Installing the Product 53 | When you install the product in silent mode, it also creates the .silentinstall file that can be used to configure TIBCO ActiveMatrix BPM in the silent mode. The silentinstall script file is created under the TIBCO_HOME\bpm\1.3\scripts\silent directory as: • on Windows: silentinstall.bat • on UNIX/Linux: silentinstall You can run the silentinstall utility to run the scripts that set up the third party driver and configure and deploy TIBCO ActiveMatrix BPM.
54 | Chapter 4 Installation Setting up a Highly Available, Fault Tolerant System This section describes setting up a highly available, fault tolerant system using either a third party system or a clustered environment. Using A Third-Party Solution The following diagram illustrates the basic setup required for a highly available, fault tolerant system using a third-party solution. See section Using Third Party Solution on page 22 for a brief overview of this setup.
Setting up a Highly Available, Fault Tolerant System 55 | 1. Install TIBCO ActiveMatrix BPM using the Install BPM, Administrator & TIBCO Host profile. See Running the TIBCO Configuration Tool on page 97 for details. If you wish to enable secure sockets layer (SSL) for the communication channels on the HTTP connector used by TIBCO ActiveMatrix BPM, select Configure to Secure All Communication with SSL option when running the wizards in the TIBCO Configuration Tool before creating the second BPM node.
56 | Chapter 4 Installation server and use the details of the TIBCO ActiveMatrix Administrator server you created on machine 1. —From the Administrator Server Configuration: TIBCO Host Configuration dialog in the Enterprise Name: box, type the name and port number of the TIBCO Host on the machine where you created the TIBCO ActiveMatrix Administrator (in this scenario, machine 1).
Setting up a Highly Available, Fault Tolerant System 57 | LINAthos contains: — Corporate LDAP — Oracle database — Network File System (NFS) — Load Balancer — Enterprise Message Service (EMS) Load Balancer The following illustrates the configuration of the load balancer: Ports The following table lists the default ports used by each of the components: Component Default Port Work Presentation 8080 TIBCO ActiveMatrix BPM Installation and Configuration
58 | Chapter 4 Installation Component Default Port TIBCO ActiveMatrix Administrator (external HTTP) 8120 Internal ADS 10801 Host Instance JMX 6051 BPM Node 6031 System Node 6021 Internal HTTP 19767 HSQL 1234 Credential Server 6041 The ports configured for the Work Presentation Component, TIBCO ActiveMatrix Administrator (external HTTP port), and the Internal HTTP port, need to be configured for load balancing across Machines 1 and 2.
Setting up a Highly Available, Fault Tolerant System 59 | Disaster Recovery on the other hand is really a different topic entirely and is the ability to recover from a catastrophic disaster. While replication may play a part in a disaster recovery plan, it is not the only concept that must be leveraged; an enterprise must have a business continuity plan in place that defines key metrics (for example, recovery point objective, recovery time, etc).
60 | Chapter 4 Installation Pre-Installation The following subsections describe pre-installation tasks that must be performed or taken into consideration. Also note that this example assumes a UNIX-based installation. Time Synchronization All the servers in a highly available environment must have their time and date synchronized with each other. If the time is offset by even a few seconds, you may see one of following (or similar) messages in the BPM.log file.
Setting up a Highly Available, Fault Tolerant System 61 | • Internal LDAP Configuration (optional - held within the BPM directory) • Keystores for SSL and WSS authentication. See TIBCO ActiveMatrix BPM Administration guide for details about enabling SSL and configuring TIBCO ActiveMatrix BPM to use SSO for authentication.
62 | Chapter 4 Installation Installing the Product This procedure assumes that non-secure HTTP communications are used throughout. The procedure may fail if any of the components are configured to use the secure HTTPS communication. Task A Install The Base Software on Machine 1 and Machine 2 Each machine in the cluster will act as both a replicated TIBCO ActiveMatrix Administrator and a replicated BPM node.
Setting up a Highly Available, Fault Tolerant System 63 | Task A Configure the JDBC Driver 1. Using the TIBCO Configuration Tool (TCT), select Configure Third-Party Driver. 2. On the Third-Party Driver: Details dialog, select the following: 3. On the Third-Party Driver: JAR Folder dialog, select the directory containing the JDBC driver and then click on Finish. 4.
64 | Chapter 4 Installation 2. On the Administrator Server Configuration: Details dialog, enter the following: 3. On the Administrator Server Configuration: TIBCO Host Configuration dialog, enter the following.
Setting up a Highly Available, Fault Tolerant System 65 | 4. On the Administrator Server Configuration: Connection Settings dialog, enter the following: 5. On the Administrator Server Configuration: Internal HTTP Settings dialog: a. Enter the URL for the Internal HTTP Port that was configured on the load balancer.
66 | Chapter 4 Installation 6.
Setting up a Highly Available, Fault Tolerant System 67 | 7. On the Administrator Server Configuration: Credential Server Details dialog, enter the following (leave the network adapter at 0.0.0.0 so that it can bind to all network interfaces): Do not use the Default In-Process Database. This database and user need to be pre-created and empty. It will not create the user, nor drop tables made by previous installs.
68 | Chapter 4 Installation 8. On the Administrator Server Configuration: Database Authentication Realm Details dialog: a. select/enter the following information, b. click the Test Connection button to ensure you can successfully connect, c.
Setting up a Highly Available, Fault Tolerant System 69 | 9. On the Administrator Server Configuration: Summary dialog: a. uncheck Deploy Monitoring Service, b. uncheck Deploy Log Service, c. click Save to save the Ant scripts for this configuration: 10. Close the TIBCO Configuration Utility (do not have TCT do the configuration). Task C Edit Configuration Scripts Perform the following steps on Machine 1: 1. Change directories to CONFIG_HOME/tct/admin/date-time/scripts.
70 | Chapter 4 Installation 2. Edit the integration_create_admin_data.xml file: a. Set the sharedWorkFolder attribute of the AdminConfigFolders element to a folder in the shared file system. For example: b. Set the location attribute of the SCMDetails element to the same value as sharedWorkFolder attribute.
Setting up a Highly Available, Fault Tolerant System 71 | To: Task B Run Ant Scripts 1. Before executing the Ant scripts, increase the heap size for Ant: export ANT_OPTS=-Xmx1024m 2. From the scripts directory, launch Ant (there is a version included in the amx-bpm installation folder): /opt/tibco/amx-bpm/tibcojre64/1.6.
72 | Chapter 4 Installation 2. On the ActiveMatrix BPM: Database Administrator dialog, select/enter the following, then click the Test Connection button to ensure you can successfully connect: 3.
Setting up a Highly Available, Fault Tolerant System 73 | 4. On the ActiveMatrix BPM: Configuration dialog: a. enter the following information, b. check the Override BPM Configuration Folder box, c. in the Configuration Folder field, enter the BPM folder from the shared file system. d. Optionally, check the Enable SSL box to enable Secure Sockets Layer (SSL) communication channels between your BPM runtime clients (i.e.
74 | Chapter 4 Installation 5. On the ActiveMatrix BPM: Administrator Server Configuration dialog: a. check the Use Existing ActiveMatrix Administrator Server box, b. complete the remaining fields, c. click the Test Connection button to ensure you can successfully connect. 6.
Setting up a Highly Available, Fault Tolerant System 75 | 7. Click Finish, and then click ’Configure’ to create the ActiveMatrix BPM Server. Create a TIBCO ActiveMatrix Administrator Replica on Machine 2 Perform the following steps on Machine 2 to create a replica TIBCO ActiveMatrix Administrator. Task A Edit the instance-mgmt.xml File 1. Open the following file: TIBCO_HOME/administrator/3.1/scripts/instance-mgmt.xml 2. Locate the "deploy-admin" target, and remove "configure.tcs" and "start.
76 | Chapter 4 Installation 3. On the Third-Party Driver: JAR Folder dialog, select the directory containing the JDBC driver and then click on Finish. 4. On the Third-Party Driver: Summary dialog, enter or browse to the appropriate directory for the logs, and select the Configure Third-Party Driver box: Note that the Session Scripts and Log Folder field is prefilled with the default location; you can change this location, if desired. Click Configure to configure the third-party driver.
Setting up a Highly Available, Fault Tolerant System 77 | 1. Change directories to: CONFIG_HOME/tct/admin/date-time/scripts For example: [tibco@LINAramis scripts]$ pwd /home/tibco/amx-bpm/tibco/data/tct/admin/2011-06-23-17-46-41/sc ripts 2. Open the admin-envt-data.xml file and comment out the Environment element.
78 | Chapter 4 Installation 4. Ensure the tcs.host entry in build.properties is set to 0.0.0.0: # Administrator Server Configuration: Credential Server Details tcs.host=0.0.0.0 5. Open the cl_logservice_data.xml file and replace all instances of SystemNode with SystemNodeReplica. :%s/SystemNode/SystemNodeReplica/g 6. Open the cl_payloadservice_data.xml file and replace all instances of SystemNode with SystemNodeReplica. :%s/SystemNode/SystemNodeReplica/g 7. Open the governance_integration_data.
Setting up a Highly Available, Fault Tolerant System 79 | Create a TIBCO ActiveMatrix BPM Server Replica on Machine 2 Perform the following tasks on Machine 2 to create a replica TIBCO ActiveMatrix BPM Server (LINAramis in our example). # Task A Configure a TIBCO ActiveMatrix BPM Server Node Type 1. Using the TIBCO Configuration Tool (TCT) from Machine 1, select Configure TIBCO ActiveMatrix BPM Server Node Type - V1.3. 2.
80 | Chapter 4 Installation 3. On the ActiveMatrix BPM: Host and Node Configuration dialog: a. change the Node Name to BPMNodeReplica, b. change the Host to SystemHostReplica, c. check the Override the BPM Configuration Folder box, and d. in the Configuration Folder field, enter the same directory on the Shared File System that was used for the first BPM Server (see Create a TIBCO ActiveMatrix BPM Server on Machine 1 on page 71). 4.
Setting up a Highly Available, Fault Tolerant System 81 | TIBCO ActiveMatrix BPM Installation and Configuration
82 | Chapter 4 Installation Distribute ActiveMatrix BPM Applications Perform the following to distribute the ActiveMatrix BPM components: 1. Log into TIBCO ActiveMatrix Administrator (you can log in on either machine, or through the load balancer). 2. Distribute the following applications to BPMNode and BPMNodeReplica: — amx.bpm.app — amx.bpm.auth.system — amx.bpm.auth.easyAs — amx.bpm.auth.wss.asp — amx.bpm.apacheds a. In the Applications pane, click on the application, b.
Setting up a Highly Available, Fault Tolerant System 83 | 3. In the Applications panel, select both amx.bpm.app and amx.bpm.sysorgmodel and click Deploy. When they have been fully deployed to your BPMNodeReplica node (that is, they are shown as being "In Sync" and "Running", not "Partially Running"), deploy amx.bpm.auth.* and amx.bpm.apacheds. (Note that this can take quite some time, depending on the system load.
84 | Chapter 4 Installation Edit LDAP Shared Resources If you are using the internal Apache DS instance, you are also required to edit the LDAP shared resources to reflect the load balancer hostname, as opposed to a single machine. This is required to ensure that either instance of Apache DS is used in the event one machine fails.
Setting up a Distributed System 85 | Setting up a Distributed System To implement the distributed system illustrated in the figure below, perform the following steps.
86 | Chapter 4 Installation 2. On machine 1: Using TIBCO Configuration Tool: If you wish to enable secure sockets layer (SSL) for the communication channels on the http connector used by TIBCO ActiveMatrix BPM, select Configure to Secure All Communication with SSL option when running the wizards in TIBCO Configuration Tool before creating the second BPM node. The other BPM nodes then inherit the SSL configuration.
Setting up a Distributed System 87 | b. Run the Create TIBCO Host Instance wizard to create a TIBCO Host, see Create TIBCO Host Instance Wizard Reference on page 30. From the TIBCO Host Instance Configuration: Administrator Server dialog, select Bind this TIBCO Host instance with an existing Administrator server box and enter the details of TIBCO ActiveMatrix Administrator server that you created on machine 1.
88 | Chapter 4 Installation 5. On machine 1: You must run the Configure TIBCO ActiveMatrix BPM Server Node Type wizard twice to create: — a BPM Node Type — a Work Manager Node Type On the ActiveMatrix BPM: Administrator Server Configuration: dialog, the properties should be as follows: —Machine Name: Type the machine name of machine 1. —Port: Type the port number the TIBCO Administrator server is using on machine 1. —Username: Type the username of the TIBCO Administrator server superuser on machine 1.
Setting up a Distributed System 89 | 6. Using TIBCO Administrator on machine 1, redistribute the following TIBCO ActiveMatrix BPM applications to the new node. — amx.bpm.app — any TIBCO ActiveMatrix BPM LDAP Authenticator applications. For example, if you are using the internal LDAP server provided with TIBCO ActiveMatrix BPM, these would be: —amx.bpm.auth.system —amx.bpm.auth.easyas a. Select Applications. From the Environment drop-down list, select the Environment name that you specified on machine 1.
90 | Chapter 4 Installation TIBCO ActiveMatrix BPM Installation and Configuration
| 91 PART THREE CONFIGURATION TIBCO ActiveMatrix BPM Installation and Configuration
92 | Chapter 5 Creating and Configuring Runtime Objects Chapter 5 Creating and Configuring Runtime Objects This chapter describes how to create and configure ActiveMatrix BPM servers, ActiveMatrix BPM node types, ActiveMatrix Administrator servers, TIBCO Host instances, and install (configure) third party drivers using TIBCO Configuration Tool (TCT).
Configuration Modes 93 | Configuration Modes You configure ActiveMatrix BPM servers and node types, ActiveMatrix Administrator servers, and TIBCO Host instances, and install third-party drivers using one of the following modes: • GUI Run TIBCO Configuration Tool and configure objects using wizards. See Running the TIBCO Configuration Tool on page 97. • Script Edit and run TIBCO Configuration Tool scripts: a.
94 | Chapter 5 Creating and Configuring Runtime Objects TIBCO Configuration Tool Requirements TIBCO Enterprise Message Service Server Requirements and Prerequisites A TIBCO Enterprise Message Service server acts as a notification server for the ActiveMatrix Administrator servers and TIBCO Host instances within an enterprise.
TIBCO Configuration Tool Requirements 95 | Database and LDAP Servers Database and LDAP servers must be enabled with SSL before you run the Create TIBCO ActiveMatrix Administrator Server wizard. Default Ports Figure 1 on page 95 illustrates the default ports configured in TIBCO Configuration Tool. For information on how to change the ports after you have configured them, see Administration.
96 | Chapter 5 Creating and Configuring Runtime Objects Table 6 lists the default ports for the TIBCO ActiveMatrix runtime objects configured in TIBCO Configuration Tool.
Running the TIBCO Configuration Tool 97 | Running the TIBCO Configuration Tool This section describes running TCT to create the runtime objects required for an ActiveMatrix BPM setup. 1. Execute TIBCO_HOME/tct/1.1/TIBCOConfigurationTool. The TIBCO Configuration Folder dialog displays. A TIBCO configuration folder stores configuration data generated by TIBCO products. Configuration data can include sample scripts, session data, configured binaries, logs, and so on.
98 | Chapter 5 Creating and Configuring Runtime Objects Table 8 Configuration Wizards (Cont’d) Wizard Function Create TIBCO ActiveMatrix Administrator Server - V3.1 In this wizard you: • Specify the properties of an ActiveMatrix Administrator server and optionally create the server. The TIBCO Host instance named SystemHost and SystemNode node that runs ActiveMatrix Administrator server and the development node will be started.
Running the TIBCO Configuration Tool 99 | 7. On any screen, click Finish to accept default values (see Default Ports on page 95) for all the configuration properties and jump to the Summary screen. 8. In the Summary screen, the wizard reports the configuration tasks it will perform. — Click Save to save a configuration. See Saving a TIBCO Configuration Tool Configuration on page 155. — Click Cancel to return to the wizard selector screen. — Execute the configuration tasks: a.
100 | Chapter 5 Creating and Configuring Runtime Objects Recommended Order to Run Wizards for ActiveMatrix BPM The following table describes the recommended order to run the wizards for ActiveMatrix BPM which depends on the installation profile you chose during installation: Installation Profile Wizard Install BPM, Administrator & TIBCO Host • Configure Third-Party Driver to configure the JDBC Drivers for your database. • Create TIBCO ActiveMatrix BPM Server - V1.
TIBCO ActiveMatrix BPM Configuration Example 101 | TIBCO ActiveMatrix BPM Configuration Example This section describes the steps to configure the TIBCO ActiveMatrix BPM server following the recommended order of running the wizards. This example uses the following third-party software: • DBMS Software: Microsoft SQL Server 2008 • JDBC Driver: JDBC driver Version 2.0 • Internal LDAP Task A Configure the Third-Party Driver 1. Click Configure Third-Party Driver.
102 | Chapter 5 Creating and Configuring Runtime Objects between your BPM runtime clients (Openspace, Workspace), and the BPM runtime. Click Next. The ActiveMatrix BPM: Database Administrator dialog displays. 2. Complete the following fields: Field Description Create BPM Database Instance Select the checkbox for TIBCO Configuration Tool to create the TIBCO ActiveMatrix BPM database. Deselect this if you want to manually create the TIBCO ActiveMatrix BPM database.
TIBCO ActiveMatrix BPM Configuration Example 103 | 4. Complete the following items as required: Field Description URL The URL field is automatically completed with the JDBC connection string used to connect to the TIBCO ActiveMatrix BPM database. For example, jdbc:sqlserver://hostname:1433;DatabaseName=bpm;SelectMethod=cur sor Username Specify the username that you want TIBCO ActiveMatrix BPM to use to connect and log in to the TIBCO ActiveMatrix BPM database.
104 | Chapter 5 Creating and Configuring Runtime Objects 6. Complete the following items as required: Field Description HTTP Work Presentation Host The machine name that hosts Workspace. If the machine is different from the machine where you are running TIBCO ActiveMatrix BPM, then enter the fully qualified domain name or IP address in this field. The machine name specified here is also used in the default security certificate. Default: localhost HTTP Port The port number for Workspace.
TIBCO ActiveMatrix BPM Configuration Example 105 | 8. Complete the following items as required: Field Description Environment Choose the type of environment you are setting up. The drop-down list provides two options: Development and Production. The environment you choose in this field determines the default values provided for the remaining fields on this screen.
106 | Chapter 5 Creating and Configuring Runtime Objects For more details about these parameters, see Tuning ActiveMatrix BPM. 9. Click Next. The ActiveMatrix BPM: LDAP Configuration dialog displays. 10. Complete the following items as required: Field Description Use Internal LDAP Server Select this if you want to use the internal LDAP Directory Server provided with TIBCO ActiveMatrix BPM. If checked the Port field is displayed; see LDAP Server on page 40. Default: Checked.
TIBCO ActiveMatrix BPM Configuration Example 107 | 12. Once you have completed the Create TIBCO ActiveMatrix BPM Server wizard, the Summary dialog displays, then:. If you deselected the Create BPM Database Instance checkbox, the Summary dialog should say Create ActiveMatrix BPM [Not Creating Database Instance]. If... Do this... Your database administrator has manually run the TIBCO ActiveMatrix BPM database creation scripts to create the database Click Configure to configure TIBCO ActiveMatrix BPM.
108 | Chapter 5 Creating and Configuring Runtime Objects Manually Run the BPM Database Creation Scripts (This only applies to Oracle) If you need to manually amend any of the BPM database creation scripts, make sure that you do not include any blank lines. If there are any blank lines, you will receive an error similar to the ones below: SP2-0734: unknown command beginning "CONSTRAINT..." SP2-0042: unknown command ")" and the rest of the line is ignored.
TIBCO ActiveMatrix BPM Configuration Example 109 | Script Description Run As /BPM/database/ProcessManage These scripts create the schema objects required for the process manager component. BPM User These scripts create the schema objects required for the work manager component. When running this script manually to create schema objects in DB2, you must set the statement termination character to ’/’ (forward-slash) rather than a ’;’(semi-colon).
110 | Chapter 6 TIBCO Configuration Tool Wizard Reference Chapter 6 TIBCO Configuration Tool Wizard Reference Topics • Configure Third-Party Driver Wizard Reference, page 111 • Create TIBCO Host Instance Wizard Reference, page 112 • Create TIBCO ActiveMatrix Administrator Server Wizard Reference, page 117 • Create TIBCO ActiveMatrix BPM Server Reference, page 145 • Configure TIBCO ActiveMatrix BPM Server Node Type Reference, page 149 • Replicating a TIBCO ActiveMatrix Administrator Server, p
Configure Third-Party Driver Wizard Reference 111 | Configure Third-Party Driver Wizard Reference Table 9 Details Field Description Driver Type The type of driver being configured: JDBC or JMS. Default: JDBC. Driver The supported drivers: • JDBC — TIBCO enabled JDBC driver for Microsoft SQL Server 2.0 — TIBCO enabled JDBC driver for Microsoft SQL Server 3.0 — TIBCO enabled JDBC driver for Oracle 10.2.0 — TIBCO enabled JDBC driver for Oracle 11.1.0 — TIBCO enabled JDBC driver for IBM DB2 2.3.
112 | Chapter 6 TIBCO Configuration Tool Wizard Reference Create TIBCO Host Instance Wizard Reference Table 11 Welcome Field Description Configure to Secure All Communication with SSL Indicate that all communication channels will be secured with SSL. When checked, the Enable SSL checkbox on the TIBCO Enterprise Message Service Server and ActiveMatrix Administrator Server screens are checked. See SSL Prerequisites, page 94.
Create TIBCO Host Instance Wizard Reference 113 | Table 12 TIBCO Host Instance Details (Cont’d) Field Description Create Windows Shortcut Indicate whether to create a shortcut named instanceName, where instanceName is the name you specified in the Name field, that points to CONFIG_HOME\tibcohost\instanceName\host\bin\tibcohost.exe, to the Windows desktop. Default: Unchecked. Notification and Messaging Bus Server See TIBCO Enterprise Message Service Server Requirements and Prerequisites, page 94.
114 | Chapter 6 TIBCO Configuration Tool Wizard Reference Trust Keystore Table 14 SSL Keystore Configuration Field Description Create a Trust Store... Invokes a wizard to import certificates from a server and create the trust store. Keystore Location The location of the keystore. Keystore Type The type of the keystore: JKS or JCEKS. Default: JKS. Keystore Password The password that protects the keystore. Choose the source of the trust store keystore: • Create a. Click Create a Trust Store....
Create TIBCO Host Instance Wizard Reference 115 | ActiveMatrix Administrator Server Table 15 Administrator Server Field Description Bind to Administrator Server Indicate whether to bind the TIBCO Host instance to an Administrator server. When checked the Administrator server configuration fields are enabled. Default: Checked. Machine Name The name of the machine on which the Administrator server is running. The value of this property must either be a hostname resolvable through DNS or 0.0.0.
116 | Chapter 6 TIBCO Configuration Tool Wizard Reference Choose the source of the trust store keystore: • Create a. Click Create a Trust Store.... b. Specify a password to protect the keystore and click Next >. The SSL setup wizard displays certificates imported from trusted servers. c. In the Trust Selected Certifications area, check the checkboxes next to the certificates to trust and click Finish. The wizard fills in the Keystore Location, Keystore Type, and Keystore Password fields. • Upload a.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 117 | Create TIBCO ActiveMatrix Administrator Server Wizard Reference The Create TIBCO ActiveMatrix Administrator Server wizard takes 15 minutes or more to complete depending on the configuration options. Database Requirements When running the wizard you specify a database for ActiveMatrix Administrator server and several system services. If you are using an external database other than HSQLDB, before running the wizard: 1.
118 | Chapter 6 TIBCO Configuration Tool Wizard Reference The following table summarizes the components that are configured in the Create TIBCO ActiveMatrix Administrator Server wizard, their function, and the decisions you must make, the information you must gather, and actions you must perform before running the wizard.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 119 | Table 17 TIBCO ActiveMatrix Administrator Server Wizard Reference (Cont’d) Component Function Options and Actions ActiveMatrix Administrator Server Authentication Realm Stores user and group data. Choose a database or LDAP authentication realm. Provide configuration details for the authentication realm. A database authentication realm stores user and group authentication data in a database.
120 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 17 TIBCO ActiveMatrix Administrator Server Wizard Reference (Cont’d) Component Function Options and Actions Log Service Aggregates and stores log entry data. Choose the ActiveMatrix Administrator database or another database. If you are using a database different than the one the ActiveMatrix Administrator server uses, see Database Requirements on page 117. Payload Service Stores large payloads associated with log entries.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 121 | TIBCO Host Instance Table 20 TIBCO Host Instance Field Description Machine Name The name of the machine on which the TIBCO Host instance runs. The value of this property must either be a hostname resolvable through DNS or 0.0.0.0; it cannot be an IP address. Default: machineName, where machineName is the machine on which TIBCO Configuration Tool is being executed. Port The management port of the TIBCO Host instance. Default: 6051.
122 | Chapter 6 TIBCO Configuration Tool Wizard Reference ActiveMatrix Administrator Connection Settings Table 21 Connection Settings Field Description Network Adapter The address of the network adapter on the machine on which the ActiveMatrix Administrator server runs. The default is set to 0.0.0.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 123 | Table 21 Connection Settings (Cont’d) Field Description Keystore Type The type of the uploaded keystore: JKS or JCEKS. Default: JKS. Keystore Password The password that protects the keystore. Key Alias The key alias that identifies the ActiveMatrix Administrator server entry in the keystore. Key Password The password that protects the key alias.
124 | Chapter 6 TIBCO Configuration Tool Wizard Reference Notification and Messaging Bus Server See TIBCO Enterprise Message Service Server Requirements and Prerequisites, page 94. If you intend to enable SSL communications, see SSL Prerequisites, page 94. Table 23 TIBCO Enterprise Message Service Server Field Description Machine Name Port List A comma separated list of machinename:port addresses for a TIBCO Enterprise Message Service server.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 125 | Choose the source of the trust store keystore: • Create a. Click Create a Trust Store.... b. Specify a password to protect the keystore and click Next >. The SSL setup wizard displays certificates imported from trusted servers. c. In the Trust Selected Certifications area, check the checkboxes next to the certificates to trust and click Finish. The wizard fills in the Keystore Location, Keystore Type, and Keystore Password fields.
126 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 25 Database Details (Cont’d) Field Description Database Driver The driver for the external database. Database URL The URL of the external database. Default: org.hsqldb.jdbcDriver. Default: jdbc:hsqldb:hsql://localhost:1234/amx. Username The external database username. Default: sa. Password The external database password. Default: None. Max Connections The maximum number of database connections to allocate.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 127 | a. Click Create a Trust Store.... b. Specify a password to protect the keystore and click Next >. The SSL setup wizard displays certificates imported from trusted servers. c. In the Trust Selected Certifications area, check the checkboxes next to the certificates to trust and click Finish. The wizard fills in the Keystore Location, Keystore Type, and Keystore Password fields. • Upload a.
128 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 27 Authentication Realm Field Description Password The password of the superuser. Default: t. Database Authentication Realm Table 28 Database Authentication Realm Details Field Description Use ActiveMatrix Administrator Database Specify whether the database authentication realm should use the same database as the ActiveMatrix Administrator server. Default: Checked.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 129 | Table 29 Database Details (Cont’d) Field Description Max Connections The maximum number of database connections to allocate. Database Server is SSL Enabled Indicate that the database server is enabled for SSL. When checked, the SSL Keystore Configuration fields are enabled. Default: 5. LDAP Authentication Realm If you intend to enable SSL communications, see SSL Prerequisites, page 94.
130 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 30 LDAP Authentication Realm Details (Cont’d) Field Description Attribute Name to Get User's Name The name of the attribute in the user object that represents the user's name. Search Timeout (ms) The time to wait for a response from the LDAP directory server. Default: uid. Default: -1, which means to use the provider’s default.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 131 | Table 31 Group Settings (Cont’d) Field Description Group Indication Specifies how a user’s group memberships are found. Group information is used by the Administrator when a user, once authenticated, performs other activities in the system. Options: • Group Has User Members— A list of users that belong to the group. • User Has Group Memberships— A list of groups to which the user belongs. Default: Group Has User Members.
132 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 32 LDAP Server Settings (Cont’d) Field Description LDAP Authentication User DN Template The template by which the User DN, used to connect to the LDAP server, is generated. Because the full DN is always supplied, the template should always be 0 (zero). Default: uid={0},ou=people,ou=na,dc=org User Attributes Extra (optional) An optional list of user attributes to retrieve from the LDAP directory during authentication.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 133 | • Upload a. Click Browse and navigate to the location of the keystore. b. Click the keystore and click Open. The wizard fills in the Keystore Location field. c. In the Keystore Type drop-down list, select the keystore type. d. Type the keystore password. e. Click Test Connection. The following resource templates are added to the Administrator server: — Keystore Provider notify.transport.truststore.csp.
134 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 34 Credential Server Details Field Description Password The password for the client. Default: password1. Table 35 Credential Server Keystore Field Description Auto-generated Keystore Indicate that the TIBCO Credential Server keystore will be generated. When selected, the Common Name field displays. Common Name The TIBCO Credential Server’s issuer name. Default: amxadmin.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 135 | Monitoring Service Notification Server Table 36 Monitoring Notification Server Field Description Use ActiveMatrix Administrator Notification Server Indicate whether the monitoring service should use the same notification server as the ActiveMatrix Administrator server. Default: Checked. If unchecked, the notification server fields in Notification and Messaging Bus Server on page 135 display.
136 | Chapter 6 TIBCO Configuration Tool Wizard Reference Trust Keystore Table 38 SSL Keystore Configuration Field Description Create a Trust Store... Invokes a wizard to import certificates from a server and create the trust store. Keystore Location The location of the keystore. Keystore Type The type of the keystore: JKS or JCEKS. Default: JKS. Keystore Password The password that protects the keystore. Choose the source of the trust store keystore: • Create a. Click Create a Trust Store....
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 137 | Monitoring Service Database Table 39 Monitoring Service Database Field Description Use ActiveMatrix Administrator Database Indicate that the monitoring service should use the same database as the ActiveMatrix Administrator server. Default: Checked. If unchecked, the notification server fields in Database Details on page 137 display.
138 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 40 Database Details (Cont’d) Field Description Database Server is SSL Enabled Indicate that the database server is enabled for SSL. When checked, the SSL Keystore Configuration fields are enabled. Trust Keystore Table 41 SSL Keystore Configuration Field Description Create a Trust Store... Invokes a wizard to import certificates from a server and create the trust store. Keystore Location The location of the keystore.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 139 | The following resource templates are added to the Administrator server: — Keystore Provider notify.transport.truststore.csp.jndi — SSL Client Provider notify.transport.sslclient.jndi and instances of these resource templates are installed on every node managed by that server.
140 | Chapter 6 TIBCO Configuration Tool Wizard Reference you intend to enable SSL communications, see SSL Prerequisites, page 94. Table 44 Database Details Field Description Use Default In-Process Database Indicate that the ActiveMatrix Administrator server database is an embedded in-process database. If unchecked, the external database configuration fields display. Default: Checked. Database Driver The driver for the external database. Database URL The URL of the external database.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 141 | Table 45 SSL Keystore Configuration (Cont’d) Field Description Keystore Type The type of the keystore: JKS or JCEKS. Default: JKS. Keystore Password The password that protects the keystore. Choose the source of the trust store keystore: • Create a. Click Create a Trust Store.... b. Specify a password to protect the keystore and click Next >. The SSL setup wizard displays certificates imported from trusted servers. c.
142 | Chapter 6 TIBCO Configuration Tool Wizard Reference Payload Service Table 46 Payload Service Database Field Description Use ActiveMatrix Administrator Database Indicate that the payload service should use the same database as the ActiveMatrix Administrator server. Default: Checked. If unchecked, the database server fields in Database Details on page 142 display. Database Details If you are using an external database, see Database Requirements on page 117.
Create TIBCO ActiveMatrix Administrator Server Wizard Reference 143 | Table 47 Database Details (Cont’d) Field Description Database Server is SSL Enabled Indicate that the database server is enabled for SSL. When checked, the SSL Keystore Configuration fields are enabled. Trust Keystore Table 48 SSL Keystore Configuration Field Description Create a Trust Store... Invokes a wizard to import certificates from a server and create the trust store. Keystore Location The location of the keystore.
144 | Chapter 6 TIBCO Configuration Tool Wizard Reference The following resource templates are added to the Administrator server: — Keystore Provider notify.transport.truststore.csp.jndi — SSL Client Provider notify.transport.sslclient.jndi and instances of these resource templates are installed on every node managed by that server.
Create TIBCO ActiveMatrix BPM Server Reference 145 | Create TIBCO ActiveMatrix BPM Server Reference Table 49 Welcome Field Description Configure to Secure All Communication with SSL Check to indicate that all communication channels will be secured with SSL. When checked, the SSL enabled checkboxes on the Browser Port, Internal HTTP Port, TIBCO Enterprise Message Service, database, and LDAP screens are checked. See SSL Prerequisites, page 94.
146 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 51 ActiveMatrix BPM: Runtime Database Configuration Field Description URL The URL used to connect to the TIBCO ActiveMatrix BPM database, depends on the third party driver installed. Username The username that you want TIBCO ActiveMatrix BPM to use to connect to the TIBCO ActiveMatrix BPM database. TIBCO Configuration Tool automatically creates the username you specify. Default: bpmuser.
Create TIBCO ActiveMatrix BPM Server Reference 147 | Table 52 ActiveMatrix BPM: Client Configuration Field Description SMTP Port The port number used by the SMTP server. Default: 25. Override BPM Configuration Folder Check if you want to override the default BPM configuration folder. Configuration Folder The location of the BPM configuration folder. Table 53 ActiveMatrix BPM: SizingConfiguration Field Description Environment The type of environment being set up.
148 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 53 ActiveMatrix BPM: SizingConfiguration (Cont’d) Field Description Number of Message Threads Specifies the range for the message threads. Development default: Core: 5 Maximum: 10 Production default: Core: 10 Maximum: 20 Java Heap Size Specifies the range for the Java heap size.
Configure TIBCO ActiveMatrix BPM Server Node Type Reference 149 | Configure TIBCO ActiveMatrix BPM Server Node Type Reference Table 55 Welcome Field Description Configure to Secure All Communication with SSL Check to indicate that all communication channels will be secured with SSL. When checked, the SSL enabled checkboxes on the Browser Port, Internal HTTP Port, TIBCO Enterprise Message Service, database, and LDAP screens are checked. See SSL Prerequisites, page 94.
150 | Chapter 6 TIBCO Configuration Tool Wizard Reference Table 57 ActiveMatrix BPM: Host and Node Configuration Field Description Node Type The type of the node to create. One of: • BPM Node Type • Process Manager Node Type • Work Manager Node Type • Web Components Node Type Default: BPM Node Type Node Name The name of the TIBCO ActiveMatrix BPM node. Default: 8120. Node Port The port number used by the TIBCO ActiveMatrix BPM node. Default: 6031.
Configure TIBCO ActiveMatrix BPM Server Node Type Reference 151 | Table 58 Summary Field Description Session Scripts and Log Folder The location where the server scripts and log folders are stored. Create New ActiveMatrix BPM Server Node Type Che ck to create a New ActiveMatrix BPM Server Node Type.
152 | Chapter 7 TIBCO Configuration Tool Configurations Chapter 7 TIBCO Configuration Tool Configurations Topics • TIBCO Configuration Tool Configuration, page 153 • Replicating a TIBCO ActiveMatrix Administrator Server on page 162 TIBCO ActiveMatrix BPM Installation and Configuration
TIBCO Configuration Tool Configuration 153 | TIBCO Configuration Tool Configuration A TIBCO Configuration Tool configuration consists of Ant build and property files. The files are stored in CONFIG_HOME/tct/subfolder/date-time/scripts, where CONFIG_HOME is the folder you specified in step 2. on page 97, and subfolder and the files are listed in Table 59. The settings in the property files are listed in Table 60.
154 | Chapter 7 TIBCO Configuration Tool Configurations Table 59 Configuration Subfolders and Files Subfolder Files bpm • admin-envt-data.xml: ActiveMatrix development environment configuration • admin-instance.properties: ActiveMatrix Administrator server configuration • admin-tibcohost-instance.properties: TIBCO Host instance configuration that manages the node running the ActiveMatrix Administrator server • bpm-installer.properties: BPM installation configuration • build.
TIBCO Configuration Tool Configuration 155 | Table 60 Configuration Settings (Cont’d) Property Description admin.instance.name TIBCO Host instance name for ActiveMatrix Administrator th.jmx.host Name of the JMX host. amx.th.hpa.jmx.port TIBCO Host instance management port tibcohost.qin.server.url TIBCO Enterprise Message Service server URL for standalone TIBCO Host instance tibcohost.trinity.tcs.
156 | Chapter 7 TIBCO Configuration Tool Configurations • Configures an Oracle driver for use by an application deployed to an ActiveMatrix node.
TIBCO Configuration Tool Configuration 157 | Properties Description machine.model.location Machine model file. TIBCO_HOME ActiveMatrix installation location Table 61 Shell Names and Versions Driver Shell Name Shell Version Oracle Database 11g com.tibco.tpcl.gen.oracle.jdbc 11.1.0.112100 Oracle Database 10g com.tibco.tpcl.gen.oracle.jdbc 10.2.0.112100 Microsoft SQL Server 2.0.0 com.tibco.tpcl.gen.sqlserver.jdbc 2.0.0.210 JMS Sonic com.tibco.tpcl.gen.sonic.jms 6.1.0.
158 | Chapter 7 TIBCO Configuration Tool Configurations Create TIBCO Host Instance Properties Use the scripts in the folder tibcohost to create a TIBCO Host instance on a new machine or an additional TIBCO Host instance on the machine where an ActiveMatrix Administrator server is running. For creating an instance on a new ActiveMatrix machine, only needs to be updated. Otherwise, you must modify configuration properties in tibcohost-instance.properties.
TIBCO Configuration Tool Configuration 159 | Installation Location Update the following property when ActiveMatrix software is not installed onto the default location. File Name Property Description build.properties TIBCO_HOME ActiveMatrix installation location Configuration Folder Location Update following property when using a different configuration data folder location. File Name Property Description build.properties tibco.config.mgmt.
160 | Chapter 7 TIBCO Configuration Tool Configurations In addition to the changes listed in Additional TIBCO Host Instances on page 158, update the following properties to conform to target operating system path conventions. File Name Property Description build.properties TIBCO_HOME ActiveMatrix installation location tibco.config.mgmt.
TIBCO Configuration Tool Configuration 161 | Configuration Folder Location Update following property when using a different configuration data folder location. File Name Property Description build.properties tibco.config.mgmt.home ActiveMatrix runtime data configuration location Update the following properties in addition to the changes required for machine name to conform to target operating system path conventions. File Name Property Description build.
162 | Chapter 7 TIBCO Configuration Tool Configurations Replicating a TIBCO ActiveMatrix Administrator Server Administrator server requirements: • Use an external Oracle or Microsoft SQL server database. Machine requirements: • TIBCO_HOME is the same location. For example, if the location of TIBCO_HOME on the primary machine is C:\Program File\tibco\amx then the location of TIBCO_HOME on the replication machine should also be C:\Program File\tibco\amx.
Replicating a TIBCO ActiveMatrix Administrator Server 163 | 5. Edit integration_create_admin_data.xml as follows: a. Set the sharedWorkFolder attribute of the AdminConfigFolders element to a folder in the shared file system. b. Set the location attribute of the SCMDetails element to the same value as sharedWorkFolder attribute. c. Set value of the Svar element named ArtifactServerInternalSharedLocationSvar sharedWorkFolder to the same value as attribute. d. Save the file. 6.
164 | Chapter 7 TIBCO Configuration Tool Configurations Remove the target add.factory.aggregator.config from the setup target’s depends attribute. 12. Navigate to the CONFIG_HOME/tct/admin/date-time/scripts folder. 13. Edit the files: a. admin-envt-data.xml b. build.properties c. cl_logservice_data.xml, cl_payloadservice_data.xml, Comment out the Environment element. Update the th.jmx.host and th.jmx.url properties with the host name of the replicated instance. Ensure that the tcs.
Replicating a TIBCO ActiveMatrix Administrator Server 165 | Deleting a TIBCO ActiveMatrix Administrator server instance Follow these steps to delete a TIBCO ActiveMatrix Administrator server instance: 1. Make sure you have permission to force delete applications. See Administration for more information. 2. These steps should not be performed on the same machine that is running the replicated instance that you want to delete.
166 | Chapter 8 Configuring BPM in Silent Mode Chapter 8 Configuring BPM in Silent Mode Topics • Configuring BPM in Silent Mode, page 167 TIBCO ActiveMatrix BPM Installation and Configuration
Configuring BPM in Silent Mode 167 | Configuring BPM in Silent Mode To configure BPM in the silent mode, you must install the product in the silent mode. Configuring the product in silent mode requires two machines and involves the following: 1. Running TCT in the GUI mode on machine 1 and creating the required configuration. 2. Installing the product in silent mode on Machine 2 to generate the silentinstall utility.
168 | Chapter 8 Configuring BPM in Silent Mode a. Run the Configure Third-Party Driver wizard to register the JDBC drivers for your TIBCO ActiveMatrix BPM database. From the Summary dialog: —click Save to save the configuration information in the TIBCO Configuration folder. The configuration information is stored in \tct\tpclshells. See Running the TIBCO Configuration Tool on page 97 for information on how to run the wizard. —click Configure.
Configuring BPM in Silent Mode 169 | 2. Run the following commands in the order specified: a. tct_configuration_folder where is the path to the folder that stores the scripts created when you ran the Configure Third-Party Driver wizard in step 2, for example \tct\tpclshells\date-time\scripts silentinstall tpcl tct_configuration_folder b.
170 | Chapter 8 Configuring BPM in Silent Mode TIBCO ActiveMatrix BPM Installation and Configuration
| 171 PART FOUR UPGRADE TIBCO ActiveMatrix BPM Installation and Configuration
172 | Chapter 9 Upgrading Your System Chapter 9 Upgrading Your System This chapter describes how to upgrade TIBCO ActiveMatrix BPM using the upgrade utility.
Overview 173 | Overview Upgrading TIBCO ActiveMatrix BPM to 1.3.0 involves upgrading the runtime objects: TIBCO ActiveMatrix BPM application (amx.bpm.app), BPMNode, TIBCO Host instances, TIBCO ActiveMatrix Administrator servers, and TIBCO ActiveMatrix BPM Database. This chapter describes how to upgrade TIBCO ActiveMatrix BPM 1.2.0 runtime objects to release 1.3.0. If your current installation is not 1.2.0, you must first upgrade to release 1.2.0.
174 | Chapter 9 Upgrading Your System Runtime Object State Runtime object state consists of configuration data and binary executables. An upgrade process converts the format of runtime object to the current version (1.3.0/3.1.5).
Overview 175 | • ActiveMatrix Administrator Server While the ActiveMatrix Administrator server is being upgraded, deployed application will continue to run without service interruption. However, the Administrator server itself will be unavailable, which means you cannot perform functions such as deploying new applications and managing existing applications, and managing infrastructure.
176 | Chapter 9 Upgrading Your System Checks Before Performing an Upgrade Ensure that you check the following before upgrading TIBCO ActiveMatrix BPM: • Installer account - The installer account used to perform an upgrade must have the appropriate privileges required for that platform. Installer Account on page 5 describes the installer account you should use when upgrading TIBCO ActiveMatrix BPM. • Installer log file - The location of the upgrade log files.
Checks Before Performing an Upgrade 177 | documentation supplied with your database for information on to take a backup. — the TIBCO ActiveMatrix Administrator database. Refer to the documentation supplied with TIBCO ActiveMatrix Administrator for information on how to do this. — the TIBCO EMS server. Refer to the documentation supplied with TIBCO EMS for information on performing back-ups. Repeat the process for all the machines in the cluster that have TIBCO ActiveMatrix BPM installed on them.
178 | Chapter 9 Upgrading Your System Custom WCC Application on Your Development Machine When you upgrade the software, the installer installs the design-time WCC software on your development machine. Upgrading the design-time WCC software will not affect any custom WCC applications that were previously developed. However, to pick up the changes available in the upgraded software, you need to perform the following tasks: 1. Create a new WAR file for your custom application. 2.
The upgrade Utility 179 | The upgrade Utility The upgrade utility is called: • On Windows: upgrade.bat • On UNIX/Linux: upgrade and is located in \bpm\1.3\scripts\upgrade and is created when you install the new version of TIBCO ActiveMatrix BPM. You must install the new version of TIBCO ActiveMatrix BPM in the existing installation directory of the TIBCO ActiveMatrix BPM that you want to upgrade, using the Install BPM, Administrator & TIBCO Host profile.
180 | Chapter 9 Upgrading Your System The following table describes the commands that you can run using the upgrade utility: Command Runs the following... upgrade all upgrade tibcohost upgrade admin upgrade bpmnodes upgrade bpm-database upgrade bpm-app upgrade platform upgrade tibcohost upgrade admin upgrade bpmnode upgrade bpm upgrade bpm-database upgrade bpm-app TIBCO recommends that you use the upgrade all command and allow the upgrade utility to upgrade all the components at the same time.
Performing an Upgrade of TIBCO ActiveMatrix BPM 181 | Performing an Upgrade of TIBCO ActiveMatrix BPM This section describes performing an upgrade using the upgrade all command. However, you can run the upgrade scripts individually, see The upgrade Utility, page 179. Depending on the configuration and the number of applications deployed, upgrade can take varying amounts of time to complete. For example, upgrading a lightly-loaded, single node could take about an hour.
182 | Chapter 9 Upgrading Your System 5. The script prompts you to shutdown the TIBCO Host instances and all node processes [input] stop processes? (yes|no) : Enter yes to continue. Upgrade shuts down TIBCO Host, upgrades and restarts it. The script informs you when this has completed. [echo] TIBCO Host instance has been upgraded. 6. The script prompts you to confirm that your system is running before it continues.
Performing an Upgrade of TIBCO ActiveMatrix BPM 183 | 9. Press Return. Upgrade now needs to upgrade the TIBCO ActiveMatrix BPM database. Automatically upgrade database? (yes, no) To: — allow the script to automatically upgrade BPM database, type yes. Go to step 10. the TIBCO ActiveMatrix — manually upgrade the TIBCO ActiveMatrix BPM database, type no. If you type no, the upgrade utility generates the two required SQL upgrade scripts: —/bpm/database/WorkManagerUpgrade.
184 | Chapter 9 Upgrading Your System Troubleshooting When running the upgrade utility, if the script exits with an error on or before upgrading all the components, depending on the error, it may be possible to complete the upgrade process by running the individual commands rather than running an upgrade all again. Following example scenarios describe the scripts to be run when the upgrade scripts exits before completion.
| 185 PART FIVE POST INSTALLATION TIBCO ActiveMatrix BPM Installation and Configuration
186 | Chapter 10 Post-Installation Tasks Chapter 10 Post-Installation Tasks This chapter describes the post-installation tasks you must perform once you have finished installing TIBCO ActiveMatrix BPM.
Install the Mediation Product Application 187 | Install the Mediation Product Application The Mediation product application is not deployed by default on the BPMNode when you install ActiveMatrix BPM. It implements mediation for ActiveMatrix BPM. Once you have installed ActiveMatrix BPM, you must manually deploy the Mediation product application. Mediation involves virtualizing and managing service interactions between communicating participants.
188 | Chapter 10 Post-Installation Tasks Reconfigure Your JVM To reconfigure your JVM: 1. Increase the JVM permgen size: — Windows Add set ANT_OPTS=-Xmx1024m -XX:MaxPermSize=256m -XX:PermSize=128m — UNIX Add export to %USERPROFILE%\antrc_pre.bat ANT_OPTS="-Xmx1024m -XX:MaxPermSize=256m -XX:PermSize=128m to ~/.antrc 2. Confirm the value of ANT_OPTS before executing CLI scripts from the command prompt.
Using Transaction Recovery with Oracle 189 | Using Transaction Recovery with Oracle (This only applies to Oracle) If you want to use transaction recovery, you must grant the BPM user the correct privileges. To do this, ask your Oracle database administrator to execute the following commands as a user that has the SYSDBA permission: GRANT SELECT ON sys.dba_pending_transactions TO user GRANT EXECUTE ON sys.dbms_xa TO user GRANT SELECT ON sys.
190 | Chapter 10 Post-Installation Tasks Set Transaction Verification Property for Microsoft SQL Server Microsoft SQL Server currently cannot handle the scenario where commits return successfully (in XA mode) even when the transaction has not completed. Consequently, duplicate work items can occur when the BPM runtime is running against a Microsoft SQL Server. There is a case open with Microsoft for this issue (Case Reference 112010377500682).
Recovering from a Failed Installation 191 | Chapter 11 Recovering from a Failed Installation This chapter describes the steps to sanitize your machine and recover from a failed installation.
192 | Chapter 11 Recovering from a Failed Installation Sanitizing After a Failed Installation An installation process can fail at various stages and the installer may not be able to clean up the environment before exiting. It is recommended that you clean up the environment manually before trying to re-install the product. Consider a simple environment with a single node (BPMNode) on a single host.
| 193 Chapter 12 Uninstalling TIBCO ActiveMatrix BPM This chapter explains how to uninstall TIBCO ActiveMatrix BPM from your computer.
194 | Chapter 12 Uninstalling TIBCO ActiveMatrix BPM Uninstalling TIBCO ActiveMatrix BPM If you want to uninstall TIBCO ActiveMatrix BPM from your system, perform the following steps: 1. Stop the TIBCO Host instance, node processes, and TIBCO Business Studio. 2. Use one of the methods described below to uninstall TIBCO ActiveMatrix BPM: — UNIX/Linux: Use the uninstaller provided with TIBCO ActiveMatrix BPM.
Uninstalling TIBCO ActiveMatrix BPM 195 | On UN IX/Linux: — Navigate to the installation_environment/tools/universal_installer folder and run ./TIBCOUniversalInstaller-platform_id.extension You can choose to uninstall the product in either GUI or console mode. Uninstalling the product in the silent mode is not supported. 3. The TIBCO Installation Manager screen is displayed.
196 | Chapter 12 Uninstalling TIBCO ActiveMatrix BPM The TIBCO ActiveMatrix BPM entries in the Start menus may appear after the uninstallation. To correct this log out, then log in again.
Uninstalling TIBCO ActiveMatrix BPM 197 | Using Add/Remove Programs (Windows Only) To remove the installation using the Add/Remove Programs option on your PC: 1. Log in to Windows as a user with system administrator privileges. You must have system administrator privileges to uninstall this software. 2. In the Control Panel, double-click the Add or Remove Programs. 3.
198 | Chapter 12 Uninstalling TIBCO ActiveMatrix BPM TIBCO ActiveMatrix BPM Installation and Configuration
| 199 Appendix A Creating a Clustered Environment With SSL You can use the silent mode to create a clustered ActiveMatrix BPM environment configured with SSL, including a replicated ActiveMatrix Administrator. The following sections describe the tasks to be performed for the same: 1. Create the BPM server on Machine1, including the ActiveMatrix Administrator Server. 2. Create the replicated ActiveMatrix Administrator Server on Machine2. 3.
200 | Appendix A Creating a Clustered Environment With SSL Task B Create a Replicated ActiveMatrix Administrator Server on Machine2 1. Copy the contents of CONFIG_HOME/tct/bpm directory from Machine1 to Machine2. 2. On Machine2 edit the appropriate files as described in Replicating a TIBCO ActiveMatrix Administrator Server on page 162, starting from step 10. Amend the files to include Machine2 name, SystemHost replica and SystemNode replica. 3.
Creating a Clustered Environment With SSL 201 | Task D Distribute BPM Applications to Machine 2 Using TIBCO Administrator on machine 1, redistribute the following TIBCO ActiveMatrix BPM applications to the new node. • amx.bpm.app • any TIBCO ActiveMatrix BPM LDAP Authenticator applications. For example, if you are using the internal LDAP server provided with TIBCO ActiveMatrix BPM, these would be: —amx.bpm.auth.system —amx.bpm.auth.easyas 1. Select Applications.
202 | Appendix A Creating a Clustered Environment With SSL TIBCO ActiveMatrix BPM Installation and Configuration
| 203 Appendix B Securing Communication Channels The TIBCO ActiveMatrix BPM platform is partitioned across many components. These components communicate with each other and with third-party applications over various communication protocols. The components and communication channels are illustrated in Figure 2 on page 203. Figure 2 TIBCO ActiveMatrix Communication Channels By default, these communication channels are not secure.
204 | Appendix B Securing Communication Channels An SSL client and server negotiate a stateful connection by using a handshaking procedure. During this handshake, the client and server agree on various parameters to establish the connection's security. The handshake begins when a client connects to an SSL-enabled server requesting a secure connection. The server sends back its identification in the form of a digital certificate.
Securing Communication Channels 205 | Table 62 SSL Configuration Summary (Cont’d) Upgrade, Downgrade or Change Configuration Key Channel Initial Configuration 5 TIBCO ActiveMatrix Administrator server - external database and LDAP servers When creating ActiveMatrix Administrator server in TIBCO Configuration Tool.
206 | Appendix B Securing Communication Channels TIBCO ActiveMatrix BPM Installation and Configuration
| 207 Appendix C TIBCO Enterprise Message Service Server Configuration Required for Non-Admin Users This section describes the configuration changes that are required if your TIBCO ActiveMatrix BPM infrastructure connects to its TIBCO Enterprise Message Service servers with users that do not have administrator privileges. It presents the most restrictive permissions necessary. 1. Set permissions for the Administrator servers.
208 | Appendix C TIBCO Enterprise Message Service Server Configuration Required for Non-Admin Users delete topic > create user username "Description of the user" password=password create queue cl_logservice_queue.physical create queue cl_payload_queue.physical grant queue cl_logservice_queue.physical user=username send, receive grant queue cl_payload_queue.physical user=username send, receive create jndiname cl_logservice_queue queue cl_logservice_queue.
TIBCO Enterprise Message Service Server Configuration Required for Non-Admin Users 209 | 3. Create the Administrator server and TIBCO Host instance using TIBCO Configuration Tool, see Chapter 5, Creating and Configuring Runtime Objects.
210 | Appendix C TIBCO Enterprise Message Service Server Configuration Required for Non-Admin Users TIBCO ActiveMatrix BPM Installation and Configuration
| 211 Appendix D Troubleshooting When creating an instance of the ActiveMatrix Administrator server using TIBCO Configuration Tool and when using IBM DB2 as the external database server, the following errors are seen: ERROR - Error while creating Admin CLI Keystore. com.tibco.trinity.runtime.core.provider.identity.trust.TrustRuntim eException: javax.security.auth.login.LoginException: com.tibco.trinity.runtime.core.provider.credential.trinity.Trinity RuntimeException: com.tibco.trinity.server.
212 | Appendix D Troubleshooting TIBCO ActiveMatrix BPM Installation and Configuration
| 213 Index C changes from the previous release viii Console Mode 4 customer support xii G GUI Mode 3 I Installation Modes Console Mode 4 GUI Mode 3 Silent Mode 4 Installation Type Custom 4 Profile 4 S securing communication channels 203 Silent Mode 4 support, contacting xii T technical support xii TIBCO_HOME ix TIBCO ActiveMatrix BPM Installation and Configuration
