Upload
taher-harrouchi
View
42
Download
2
Tags:
Embed Size (px)
DESCRIPTION
Installing TIBCO BWPM Server 2.1.2
Citation preview
TIBCO ActiveMatrix BusinessWorks™ Process Monitor Server Installation Software Release 2.1.2 Published: May 2013
Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO, The Power of Now, TIBCO ActiveMatrix BusinessWorks, TIBCO Rendezvous, TIBCO Administrator, TIBCO Enterprise Message Service, TIBCO InConcert, TIBCO Policy Manager, and TIBCO Hawk are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. EJB, Java EE, J2EE, and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright © 2001-2013 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information
Contents
Important Information .................................................................................................................. 2
Contents ........................................................................................................................................ 3
Installation of TIBCO BWPM Server .............................................................................................. 1
Introduction .............................................................................................................................. 1
How to use this document .................................................................................................... 1
Related Documentation ........................................................................................................ 2
Checklist: Planning Your Installation ..................................................................................... 2
System Requirements ........................................................................................................... 2
Preparing for Installation .......................................................................................................... 6
Preparing Oracle Database System ....................................................................................... 6
Preparing Microsoft MS-‐SQL Server ...................................................................................... 6
Preparing TIBCO Enterprise Messaging Service .................................................................... 7
Preparing Apache Tomcat ..................................................................................................... 8
Fundamentals ......................................................................................................................... 10
BWPM Instance ................................................................................................................... 10
TIBCO BWPM Server ........................................................................................................... 11
TIBCO BWPM Client ............................................................................................................ 12
Installing and Configuring a new BWPM Instance .................................................................. 13
Installing TIBCO BWPM Server ............................................................................................ 13
Add needed Third-‐Party-‐Libraries ....................................................................................... 14
Setup a new BWPM Instance .............................................................................................. 14
Updating and Configuring an existing BWPM instance ........................................................... 25
Stop Apache Tomcat Server ................................................................................................ 25
Remove existing application of TIBCO BWPM Server ......................................................... 25
Start Apache Tomcat Server again ...................................................................................... 25
Deploy and Start new version of TIBCO BWPM Server ....................................................... 26
Add needed Third-‐Party-‐Libraries ....................................................................................... 26
Clear the cache of the browser ........................................................................................... 26
Connect to your existing BWPM database again ................................................................ 26
Re-‐Start all data providers of TIBCO BWPM Server ............................................................ 26
Verify whether your update process was successful .......................................................... 26
Needed Third-‐Party-‐Libraries and How to Add ....................................................................... 27
Uninstalling TIBCO BWPM Server ........................................................................................... 27
Stop Apache Tomcat Server ................................................................................................ 27
Remove existing application of TIBCO BWPM Server ......................................................... 27
Start Apache Tomcat Server again ...................................................................................... 28
Optional: Drop JMS destinations of BWPM ........................................................................ 28
Optional: Drop BWPM database ......................................................................................... 28
Appendix A: Glossary .............................................................................................................. 29
Installing TIBCO BWPM Server
| 1
Installation of TIBCO BWPM Server
Introduction
This document describes the process for installing and configuring TIBCO BWPM Server.
It is recommended to read the entire document before starting installation. Before you begin the installation process, gather information on the needs of your enterprise, and discuss the scope of your deployment.
How to use this document
This document is divided into the following sections:
Introduction gives you an overview of the installation process and instructions to be executed during the installation process.
Preparing for Installation walks you through the preparation of all third party prerequisite software.
Fundamentals briefly explains the conceptual structure of TIBCO BWPM Server
Installing and Configuring a new BWPM Instance walks you through installing and configuring TIBCO BWPM Server. The section includes procedures for determining whether your installation was successful.
Updating an existing BWPM Instance explains how to update an existing BWPM Instance to a higher version of TIBCO BWPM Server.
Appendice(s):
Appendix A: Glossary: TIBCO BWPM related terms and definitions
Installing TIBCO BWPM Server
| 2
Related Documentation
More information about TIBCO BWPM Server is available from the following sources:
Release Notes:
Before you install TIBCO BWPM Server you should read the Release Notes.
The Release Notes contain additional information about:
§ any restrictions or known issues § any fixes that have been done § any other information that was not available when this document was created
Checklist: Planning Your Installation
Each of the prerequisite steps must be carried out before the installation and each step contains various parameters relevant to your enterprise. All of these requirements will be addressed in upcoming sections of this guide.
TIBCO BWPM Server basically requires the following systems installed and running:
• Oracle Database System 10g (or greater; XE is supported for non-‐production environments only)
• TIBCO Enterprise Messaging Service 5.0 (or greater) • Apache Tomcat Web Application Server 6.0 (or greater)
System Requirements
In order to deploy and run TIBCO BWPM Server, your system must meet the following requirements:
Hardware Requirements
Component Minimum Requirement
Computer and processor A computer with Intel x86, Dual or Quad Core, 32 Bit or 64 Bit, 2 GHz or divergent architecture with comparable performance characteristics
Memory 2 GB RAM Disc space 100 MB free disc space
Installing TIBCO BWPM Server
| 3
Operating System Requirements
Any operating system of the following list is supported:
OS Supported version
Linux Ubuntu Server 11.10 for x86 SUSE Linux Enterprise Server (SLES) 10 or 11 for x86 Red Hat Enterprise Linux 5.x, 6.x for x86
Windows Windows Server 2003 Windows Server 2008 / R2 Windows XP Windows Vista Windows 7 Including most recent Service Pack Either 32 bit or 64 bit
Solaris Solaris 10 or greater for x86
AIX AIX 6.1 HP-‐UX HP-‐UX 11i v2 Others Please contact TIBCO Support for other supported platforms
Database Requirements
TIBCO BWPM Server requires one of the following Databases.
Database Remarks
Oracle Database 10g or greater
No limitations
Oracle Database 10 XE
Potential performance and space limitations (for instance partitioning and compress features are not available, and XE instances are restricted in size) Read the Oracle Database documentation for more information.
TIBCO Enterprise Messaging Service
TIBCO EMS 5.0 or greater is required as messaging platform to be used by TIBCO BWPM Server.
Apache Tomcat
Apache Tomcat 6.0 or greater is required to host TIBCO BWPM Server Software.
Installing TIBCO BWPM Server
| 4
Web Browser Support
The following web browsers are supported:
Web browser Supported versions
Microsoft Internet Explorer
9
Mozilla Firefox
4 or greater, excluding version 12
Additional Software Requirements
The following Java libraries must be available in the Apache Tomcat’s classpath. Please check the corresponding Apache Tomcat manual for further information.
JDBC Driver for Oracle1
The JDBC Driver for Oracle is not part of the TIBCO BWPM Server Distribution Package. Please go to the Oracle website for downloading ojdbc6.jar. This driver should be made available in the classpath variable of the tomcat server before the BWPM database can be created.
JDBC Driver for MS-‐SQL
The JDBC Driver for Microsoft SQL Server is not part of the BWPM Server Distribution Package. Please go to the Microsoft website2 for downloading sqljdbc4.jar. This driver should be made available in the classpath variable of the tomcat server before the BWPM database can be created.
TIBCO EMS Client libraries
The following TIBCO EMS client libraries are required by the TIBCO BWPM Server to communicate with the TIBCO EMS server:
tibjmsadmin.jar, tibjms.jar, tibcrypt.jar
Check your TIBCO EMS installation for those files. Typically they can be found at:
<TIBCO_EMS_HOME>/<VERSION>/client
For example:
c:\tibco\ems\6.1\client
1 http://www.oracle.com/technetwork/database/enterprise-‐edition/jdbc-‐112010-‐090769.html 2 http://msdn.microsoft.com/en-‐us/sqlserver/aa937724.aspx
Installing TIBCO BWPM Server
| 5
Other
The Java Message Service API must be available on the system. It is located in the file jms.jar, which is a part of your J2EE installation.
Installing TIBCO BWPM Server
| 6
Preparing for Installation
In this section you will prepare your environment by installing and configuring all software prerequisites.
Preparing Oracle Database System
TIBCO BWPM Server requires an Oracle Database to be available within your environment.
Required database privileges
In order to create the BWPM database objects (tables, views, etc.) the following privileges are required by the database user for installing TIBCO BWPM Server:
Permission: Type:
CONNECT Role RESOURCE Role CREATE VIEW System privilege CREATE JOB System privilege
If your database account has not been provided with these required privileges, the BWPM database cannot be created during the automatic installation procedure. In that case you can let BWPM create an SQL script including all required commands for creating the BWPM database objects. This script can be executed by a DBA. After this has been run, you can continue with configuring the system using the BWPM web interface.
Preparing Microsoft MS-‐SQL Server
Prepare your MS SQL Server database by creating an BWPM database (e.g. bwpmDB) and a BWPM database user (e.g. bwpmUser) and set the bwpmUser as owner of bwpmDB. Also make sure, that the user’s default schema is set to the correct schema (e.g. bwpm).
BWPM requires READ_COMMITTED_SNAPSHOT to be turned on in MS SQL Server. Ask your DBA to execute the following lines:
use msdb;
ALTER DATABASE [BWPMDB] SET READ_COMMITTED_SNAPSHOT ON; CREATE USER [BWPMUser] FOR LOGIN [BWPMUser];
EXEC sp_addrolemember 'SQLAgentUserRole', [BWPMUser];
GRANT SELECT ON msdb.dbo.sysjobactivity TO [BWPMUser];
GRANT SELECT ON msdb.dbo.sysjobs TO [BWPMUser];
GRANT SELECT ON msdb.dbo.sysjobhistory TO [BWPMUser];
Installing TIBCO BWPM Server
| 7
GRANT SELECT ON msdb.dbo.sysjobschedules TO [BWPMUser];
GRANT SELECT ON msdb.dbo.sysschedules TO [BWPMUser];
Note: Currently BWPM supports only one database per MS-‐SQL Server.
Preparing TIBCO Enterprise Messaging Service
TIBCO BWPM Server requires TIBCO EMS up and running and being available on your network/subnet where you want to use TIBCO BWPM Server.
TIBCO BWPM Server will create specific destinations on your TIBCO EMS Server.
You need the following information about your TIBCO EMS Server:
§ IP-‐Address / Server name, Port Number § Account (Username, Password) § Permissions send / receive, or publish / subscribe on destinations that BWPM requires:
Destinations: Privilege required by TIBCO BWPM Server
Queues: Topics:
<prefix>.event receive Subscribe (, durable)
<prefix>.command send publish
<prefix>.error send publish
§ Administrative permissions required by BWPM Server are: • view-‐destination • view-‐durable • view-‐server
If you plan using JNDI to lookup connection factories, the following information is required in addition:
§ IP-‐Address / Server name, Port Number of JNDI server § JNDI Account (Username, Password) § Name of the Connection Factory (for example: QueueConnectionFactory)
Authentication Requirements
The following administrative permission is required to configure TIBCO EMS during BWPM installation process:
Permission: Type:
CREATE-‐DESTINATION Administrative
Installing TIBCO BWPM Server
| 8
If your TIBCO EMS account does not have the “CREATE-‐DESTINATION” privilege on the <prefix>.> destination, your TIBCO EMS administrator needs to create the aforementioned destinations for you in advance.
Example
The following commands will create an EMS User “bwpm” including permissions to create destinations and send/receive messages from BWMP specific queues. The parent BWPM queue “queue.bwpm.>” will be created including send/receive permissions to user bwpm. Alse, the required administrative privileges are granted:
>
>
>
create user bwpm “User to send and receive BWPM messages” password=bwpm
create queue queue.bwpm.>
grant queue queue.bwpm.> user=bwpm receive,view,send
>
>
>
grant admin user=bwpm view-destination
grant admin user=bwpm view-durable
grant admin user=bwpm view-server
Preparing Apache Tomcat
Apache Tomcat is required by TIBCO BWPM Server as a runtime environment. Before you deploy TIBCO BWPM Server ensure Apache Tomcat is running properly.
Memory Requirements of Apache Tomcat
TIBCO BWPM Server requires at least 64 MB RAM. Please make sure that the default memory setting in the Apache Tomcat’s configuration is set accordingly. It is recommended to extend the maximum heap size to at least 1024 MB. For high performance environments a maximum heap size of at least 4096 MB is recommended.
Add the following option to CATALINA_OPTS: “-‐Xmx1024m”. CATALINA_OPTS is defined in the tomcat start scripts catalina.sh (for Unix environments) or catalina.bat (for Windows) in the <TOMCAT_HOME>/bin directory.
Authentication Requirements
If you plan to deploy the TIBCO BWPM Server web application using Tomcat’s management interface, you need a user which is member of the following roles: tomcat, manager.
You can use the built in user account “tomcat” for deploying TIBCO BWPM Server, or ask you Apache Tomcat administrator to deploy the web application for you.
Installing TIBCO BWPM Server
| 9
Installing TIBCO BWPM Server
| 10
Fundamentals
TIBCO BWPM Server is a web application. Users interact with the application using a web browser.
The following picture illustrates the main components of BWPM and their interaction:
Database Access Layer
Presentation Layer
Data ProviderCor
eU
I
Dat
abas
e sy
stem
Log Message Bus
Webbrowser
HTTP
JDBC
JMS
Client for BW
JMS
BW
PM
Ser
ver
BW
PM
C
lient Client
for BWClient for BW
Web-Application Server
BWPM Instance
BWPM Instance
An instance of BWPM represents the combination of various components that are interacting together within one environment. Each BWPM Instance consists of one database system, one or more JMS Server(s), and at least one TIBCO BWPM Server. You can combine several TIBCO BWPM Servers within one BWPM Instance, if load balancing is required.
Typically you want to separate your production environment from your non-‐production environments. In order to do so, you can create for example two different BWPM instances as there are: BWPM TEST and BWPM PROD:
Installing TIBCO BWPM Server
| 11
PROD
BWPM Instances
TEST
TIBCO BWPM Server
The TIBCO BWPM Server represents the core components of a BWPM Instance:
Database Access Layer
Presentation Layer
Data ProviderCor
eU
I
Dat
abas
e sy
stem
Log Message Bus
Webbrowser
HTTP
JDBC
JMS
BW
PM
Ser
ver
Web-Application Server
The TIBCO BWPM Server runs inside Apache Tomcat and interacts in three directions:
§ Log Message Bus: BWPM Server collects log messages from BWPM Clients via JMS. The BWPM destinations on the JMS Server represent the Log Message Bus. BWPM needs to have a defined connection to your JMS Server and a configured BWPM data provider to communicate with the Log Message Bus
Installing TIBCO BWPM Server
| 12
§ Database system: A relational database system is used to store and retrieve BWPM log information. A defined database connection and a JDBC driver are used to connect to the database.
§ User: A user interacts with TIBCO BWPM Server by using the BWPM GUI via a standard web browser.
TIBCO BWPM Client
The TIBCO BWPM Client represents a system to be monitored. For example the TIBCO BWPM Client for BW is connected with TIBCO BusinessWorks and sends monitoring information on the Log Message Bus.
Log Message Bus
Client for BW
JMS
BW
PM
C
lient Client
for BWClient for BW
Installing TIBCO BWPM Server
| 13
Installing and Configuring a new BWPM Instance
The overall installation process of a new BWPM Instance consists of the following main steps:
1. Install TIBCO BWPM Server a. Deploy TIBCO BWPM Server, represented by a Web Archive File (WAR), on Apache
Tomcat. b. Start the application “bwpm”.
2. Setup a new BWPM Instance a. Log in into BWPM for the first time and create a BWPM Setup User. b. Define a connection to the database and create the BWPM database objects. c. Define a connection to the JMS Server. d. Configure a data provider to use the JMS connection from the previous step. e. Add the configured data provider to the runtime configuration. f. Start the data provider.
Installing TIBCO BWPM Server
Upload WAR File
Start your preferred web browser and open the administration page of Apache Tomcat:
This is the Apache Tomcat Homepage. Click on Tomcat Manager to open Tomcat Web Application Manager.
Installing TIBCO BWPM Server
| 14
The Tomcat web Application Manager lets you manage web applications individually:
This is the Tomcat Web Application Manager. You can see all deployed applications here. By default there is only the manager application available. Scroll down to upload a WAR file to deploy.
Upload and deploy TIBCO BWPM Server:
Select the TIBCO BWPM Server WAR file (bwpm.war) and click on deploy.
Start application “bwpm”
When you deployed TIBCO BWPM Server successfully, a new application “/bwpm” appears in the Application List:
Click on start, if the newly deployed application has not been started by Tomcat automatically.
Add needed Third-‐Party-‐Libraries
This is described in chapter “Needed Third-‐Party-‐Libraries and How to Add”.
Setup a new BWPM Instance
The next step is to setup a new BWPM Instance.
Installing TIBCO BWPM Server
| 15
Log in into BWPM for the first time
Click on application “bwpm” or type in your web browser the URL
http://<serveraddress>:<port>/bwpm
You are now asked to create an account for the TIBCO BWPM Server Setup User:
This is the screen of the first start of TIBCO BWPM Server. You are now asked to enter the credentials for creating a new TIBCO BWPM Server Setup User.
Create an account for the TIBCO BWPM Server Setup User by specifying a user name and a password. The Setup User has limited access and is only used for setup and configuration purpose. This user account is not permitted to view any log data, but only permitted to setup and administer TIBCO BWPM Server.
It is recommended to specify a unique name for the Setup User.
By clicking on the login icon the TIBCO BWPM Server Setup User is created and you are logged in.
Installing TIBCO BWPM Server
| 16
Create the BWPM database
This is the first time you are logged in into BWPM webUI. Since the Setup User is a restricted user to only setup and administer TIBCO BWPM Server, you only have access to the “Administration” category:
This start screen will appear the first time you log in into BWPM webUI.
You are directed right away to the configuration wizard where you are asked for configuring the connection parameters to the database and for creating the BWPM database objects.
JDBC settings
Specify the JDBC connection parameters:
This is the first step of the configuration wizard.
Installing TIBCO BWPM Server
| 17
Depending on what you choose as “Connection Type” you will get different parameters to set. You can choose “Simple” or “JDBC_URL” which has less options and where you specify most of the options in a text string.
The common options are:
Attribute Description
JDBC Driver Name of the JDBC driver.
JDBC Driver Class The related driver class is shown automatically after selection of the JDBC driver.
Username This is the name of the database user BWPM will use to interact with.
Password This is the password according to the username above.
Database Schema Name of the database schema Use Partitions True / False. If your Oracle database is enabled for using partitions, it is
recommended to set this option to true. Note: Oracle XE does not support partitions; in that case “Use Partitions” must be disabled. Note: Also in case of MS-‐SQL partitioning is not supported.
Connection Pool Size
This is the connection pool size.
Options available only for Connection Type “Simple” are:
Attribute Description
Database Server Type in the name of the database server or the IP-‐Address. DB Server Port Number of the port, for Oracle typically 1521.
SID This is your Oracle System ID (SID).
The following further options are available only for Connection Type “JDBC_URL”:
Attribute Description
JDBC_URL This is the JDBC connection string to database. There are different types of URLs; please refer to Oracle’s3 and Microsoft’s4 websites for additional information
Examples: Oracle: jdbc:oracle:thin:@localhost:1521:orcl MS SQL Server:
3 Oracle Database URLs and Database settings: http://docs.oracle.com/cd/B14117_01/java.101/b10979/urls.htm#BEIJFHHB 4 Building the Connection URL for MS SQL Server http://msdn.microsoft.com/en-‐us/library/ms378428%28v=sql.90%29.aspx
Installing TIBCO BWPM Server
| 18
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;
Click on “Test Connection Settings” to verify your parameters. If the test was successful, you can save your settings by clicking on “Save settings”.
Click on “Next” to proceed with the next step.
Database setup
At this stage you have to enter the configuration parameters of your BWPM database:
The second step is about creating the BWPM database.
Installing TIBCO BWPM Server
| 19
Attribute Description
BWPM Instance This is the name of your BWPM Instance. Choose a different name for each of your environments (Dev, Test and Prod)
BWPM Admin This is the name of the administrator of BWPM. The administrator has full access to BWPM and is able to setup BWPM, manage user accounts, and grant access to users/roles. In addition the administrator has full access to any log object / data by default.
Admin Password Password of the administrator Confirm Password Confirm the password
Create BWPM database
Caution:
If there is an existing BWPM installation using the specified schema, all existing data will be lost.
There are two ways to create the BWPM database objects after configuration. Either you create the database using the wizard, or you let the wizard create an SQL script that can be executed separately by a DBA.
§ If you want to create the BWPM database directly, click on “Create Database”. Provide a database account with sufficient privileges in the following dialog to create the database objects:
§ If you want your DBA to create the BWPM database, click on “Download file” an SQL script
will be generated including all commands to create all BWPM database objects. You can handover this script to your DBA for execution. At this stage you need to suspend your configuration work by logging out and resume it after the DBA has executed the SQL script.
Create a JMS Connection
After the BWPM Database objects have been created successfully, you can now create a connection to your JMS Server.
Installing TIBCO BWPM Server
| 20
In category “Administration” click on “Connections” / “JMS”. As you can see there are two pre-‐defined connection settings, one for topics and one for queues.
Select “Connections” / “JMS” from the “Administration” category to setup a JMS connection.
Specify the following information:
Attributes Description
Name Name of the JMS Connection
Provider URL This is the URL of your JMS Server: For JNDI: tibjmsnaming://<servername>:<port> No JNDI: tcp://<servername>:<port>
Use JNDI Activate this option, if you want to use JNDI
Connection factory For JNDI specify the connection factory according to your JMS Server
Username This is the JMS user account for BWPM
Password Password of the user
Click on “Test connection” to verify your settings. If the connection could be established successfully, click on “Save settings”.
Create BWPM data provider
Based on a JMS connection, a data provider defines the configuration of the Log Message Bus.
Installing TIBCO BWPM Server
| 21
Data Provider Settings
Create a data provider:
Specify the data provider settings by clicking on “Data Provider” in the "Administration” category.
Attributes Description
Name Name of the data provider
Destination Prefix of the destinations
Create destination if not exists Activate this option, if you want to create destinations in your JMS server for BWPM. If unchecked, ask a JMS Server administrator to create the required destinations for you.
Thread Pool Size This setting determines how many messages are executed in parallel.
Data provider class Specifies the class of your data provider.
Use durable subscriber If you selected topics as your preferred type of destinations, you can use an optional durable subscriber.
JMS Connection Pick one of the predefined connection types.
If you have selected “Create destination, if not exists” the following dialog prompts you for a JMS server account that has sufficient privileges to create the required destinations:
Installing TIBCO BWPM Server
| 22
Click the “Create JMS Destinations” button to proceed, or “Cancel” to return to the previous dialog.
Runtime Configuration
Go to “System Management” / “Run Config” and select the according data provider from the list of available data providers.
Click on “System Management” / “Run Config” to list all data providers.
There are both data providers available within the right list box “Available”. The left list box “Selected” is empty at this stage.
Select the data provider you have configured before and click on the button “<” to move this entry into the list of all selected data providers.
Afterwards you can start the selected data provider(s) by clicking on “(Re)start” button.
Installing TIBCO BWPM Server
| 23
Click on “Start” to (re-‐)start the data provider(s).
Installing TIBCO BWPM Server
| 24
Determining whether your installation was successful
Please follow the instructions below to ensure BWPM is running properly:
§ Verify BWPM Log File for any error or warning messages. In case of an error you have to investigate the cause of the failure and resolve the issue accordingly.
§ Check whether there is a receiver / subscriber registered on the JMS Server destination used by BWPM: <prefix>.event. At least 1 receiver / subscriber should be registered on that destination. In case there is no consumer registered, please check whether the data provider has been started successfully.
§ Try to log in into BWPM webUI by using the Administrator account. If log in fails, please check whether the Apache TOMCAT Server has been started successfully.
Installing TIBCO BWPM Server
| 25
Updating and Configuring an existing BWPM
instance
The overall update process of an existing BWPM Instance consists of the following main steps:
1. Stop Apache Tomcat Server 2. Remove existing application of TIBCO BWPM Server 3. Start Apache Tomcat Server again 4. Deploy TIBCO BWPM Server, represented by a Web Archive File (WAR) 5. Clear browser cache 6. Connect to your existing BWPM database again
Please note, that this chapter only describes the general process of updating TIBCO BWPM Server. You have to follow the steps specified in the release notes that are enclosed to each new version of TIBCO BWPM Server.
Stop Apache Tomcat Server
Shutdown Apache Tomcat Server according to the procedure depending on your operating system. Please refer to the Apache Tomcat User Guide.
Remove existing application of TIBCO BWPM Server
The following folders of BWPM have to be removed including all sub folders:
<CATALINA_BASE>/work/Catalina/localhost/bwpm
<CATALINA_BASE>/webapps/bwpm
In addition an existing WAR file has to be removed as well:
<CATALINA_BASE>/webapps/bwpm.war
Start Apache Tomcat Server again
Start Apache Tomcat Server according to the procedure depending on your operation system. Please follow the instructions of Apache Tomcat User Guide.
Installing TIBCO BWPM Server
| 26
Deploy and Start new version of TIBCO BWPM Server
Upload the new WAR file within Apache Tomcat Manager. Afterwards deploy and start the BWPM application.
Add needed Third-‐Party-‐Libraries
This is described in chapter “Needed Third-‐Party-‐Libraries and How to Add”.
Clear the cache of the browser
Before you log in into BWPM webUI again, you have to clear your browser cache.
Connect to your existing BWPM database again
Log in into BWPM webUI by using your BWPM Setup User. Click on Administration / Connections / JDBC and specify the parameters to connect to your existing BWPM database and save the settings.
Please note: Do not create a new BWPM database unless you want to drop all existing BWPM information!
Re-‐Start all data providers of TIBCO BWPM Server
Start all data providers again via Administration / System Management / Run Config.
If the data providers are stopped, click on the button “Start” to start them all.
Verify whether your update process was successful
On the lower left end of the BWPM webUI you can verify the new version number of TIBCO BWPM Server that should correspond to the version of the enclosed release notes.
Furthermore check the BWPM log file to ensure that BWPM was started successfully: Administration / System Management / Logfile
Installing TIBCO BWPM Server
| 27
Needed Third-‐Party-‐Libraries and How to Add
Following table summarizes third-‐party-‐libraries which are needed:
Name Needed for connectivity with Where to get ojdbc6.jar Oracle database Oracle homepage sqljdbc4.jar MS-‐SQL Server Microsoft homepage tibcrypt.jar TIBCO EMS lib directory of EMS
installation tibjms.jar TIBCO EMS lib directory of EMS
installation tibjmsadmin.jar TIBCO EMS lib directory of EMS
installation jms.jar JMS Server lib directory of EMS
installation
These jar files must be present in the classpath of Tomcat. The following steps are necessary:
1. Copy these jar files to <CATALINA_HOME>/lib 2. Restart Apache Tomcat.
Uninstalling TIBCO BWPM Server
If you want to uninstall BWPM from your machine please follow the next steps:
1. Stop Apache Tomcat Server 2. Remove existing application of TIBCO BWPM Server 3. Start Apache Tomcat Server again 4. Optional: delete JMS destinations of BWPM 5. Optional: Drop BWPM database
Stop Apache Tomcat Server
Shutdown Apache Tomcat Server according to the procedure depending on your operating system. Please refer to the Apache Tomcat User Guide.
Remove existing application of TIBCO BWPM Server
The following folders of BWPM have to be removed including all sub folders:
<CATALINA_BASE>/work/Catalina/localhost/bwpm
Installing TIBCO BWPM Server
| 28
<CATALINA_BASE>/webapps/bwpm
In addition the existing WAR file has to be removed as well:
<CATALINA_BASE>/webapps/bwpm.war
Start Apache Tomcat Server again
Start Apache Tomcat Server according to the procedure depending on your operation system. Please follow the instructions of Apache Tomcat User Guide.
Optional: Drop JMS destinations of BWPM
If you want to cleanup your TIBCO BWPM Server, you can delete the existing destinations only used by BWPM:
<prefix>.event
<prefix>.command
<prefix>.error
Optional: Drop BWPM database
Optionally you can drop the bwpm-‐schema owner as the final step.
Installing TIBCO BWPM Server
| 29
Appendix A: Glossary
Term
Definition
Administrator account This user is used for administration of the BWPM Instance: User-‐Management, grant permissions, maintenance, etc.
Data Provider A data provider consists of a connection to a message server and a destination
Instance Represents the combination of various components that are interacting together within one environment.
Log Message Bus The messaging layer between TIBCOP BWPM Client and TIBCO BWPM Server is called Log Message Bus. The recommended messaging system of BWPM is JMS (Java Message Service).
TIBCO BWPM Client The TIBCO BWPM Client is attached to the system of the customer that is be monitored. It gathers logging / monitoring information and sends the data via the BWPM Log Message Bus to TIBCO BWPM Server.
TIBCO BWPM Server This is the server component of BWPM. It receives incoming logging / monitoring information from TIBCO BWPM Clients via JMS and persists those messages in the database. It also contains services for the BWPM web based user interface.
Setup User account Specific user account with limited access to setup and administer the BWPM Instance. This user is used to initial setup a new BWPM Instance.
webUI Web based user interface of BWPM. This is the main interface the user can interact with BWPM.