Installing TIBCO BWPM Server 2.1.2
Installing TIBCO BWPM Server 2.1.2
ActiveMatrix
BusinessWorks
Process
Monitor
Server
Installation
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
| 1
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:
System
Requirements
In
order
to
deploy
and
run
TIBCO
BWPM
Server,
your
system
must
meet
the
following
requirements:
Hardware
Requirements
Component
Computer
and
processor
Memory
Disc
space
Minimum
Requirement
A
computer
with
Intel
x86,
Dual
or
Quad
Core,
32
Bit
or
64
Bit,
2
GHz
or
divergent
architecture
with
comparable
performance
characteristics
2
GB
RAM
100
MB
free
disc
space
|
2
Windows
Solaris
AIX
HP-UX
Others
Supported
version
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
Server
2003
Windows
Server
2008
/
R2
Windows
XP
Windows
Vista
Windows
7
Including
most
recent
Service
Pack
Either
32
bit
or
64
bit
Solaris
10
or
greater
for
x86
AIX
6.1
HP-UX
11i
v2
Please
contact
TIBCO
Support
for
other
supported
platforms
Database
Requirements
TIBCO
BWPM
Server
requires
one
of
the
following
Databases.
Database
Oracle
Database
10g
or
greater
Oracle
Database
10
XE
Remarks
No
limitations
Apache
Tomcat
Apache
Tomcat
6.0
or
greater
is
required
to
host
TIBCO
BWPM
Server
Software.
|
3
Supported
versions
9
4
or
greater,
excluding
version
12
1
2
http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html
http://msdn.microsoft.com/en-us/sqlserver/aa937724.aspx
| 4
| 5
Type:
Role
Role
System
privilege
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.
If
you
plan
using
JNDI
to
lookup
connection
factories,
the
following
information
is
required
in
addition:
Authentication
Requirements
The
following
administrative
permission
is
required
to
configure
TIBCO
EMS
during
BWPM
installation
process:
Permission:
CREATE-DESTINATION
Type:
Administrative
|
7
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:
>
>
>
>
>
>
Authentication
Requirements
If
you
plan
to
deploy
the
TIBCO
BWPM
Server
web
application
using
Tomcats
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.
|
8
| 9
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:
Webbrowser
HTTP
BWPM Instance
JDBC
Database
system
UI
Presentation Layer
BWPM Server
Web-Application Server
Data Provider
JMS
Log Message Bus
BWPM
Client
JMS
Client
for BW
Client
for BW
Client
for BW
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:
| 10
TEST
PROD
BWPM Instances
Webbrowser
HTTP
JDBC
Database
system
UI
Presentation Layer
BWPM Server
Web-Application Server
Data Provider
JMS
Log Message Bus
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
| 11
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.
Client
for BW
Client
for BW
Client
for BW
| 12
| 13
Upload
and
deploy
TIBCO
BWPM
Server:
Setup
a
new
BWPM
Instance
The
next
step
is
to
setup
a
new
BWPM
Instance.
| 14
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.
| 15
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.
| 16
Username
Password
Database
Schema
Use
Partitions
Connection
Pool
Size
Description
Name
of
the
JDBC
driver.
The
related
driver
class
is
shown
automatically
after
selection
of
the
JDBC
driver.
This
is
the
name
of
the
database
user
BWPM
will
use
to
interact
with.
This
is
the
password
according
to
the
username
above.
Name
of
the
database
schema
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.
This
is
the
connection
pool
size.
Options
available
only
for
Connection
Type
Simple
are:
Attribute
Database
Server
DB
Server
Port
SID
Description
Type
in
the
name
of
the
database
server
or
the
IP-Address.
Number
of
the
port,
for
Oracle
typically
1521.
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
Oracles3
and
Microsofts4
websites
for
additional
information
Examples:
Oracle:
jdbc:oracle:thin:@localhost:1521:orcl
MS
SQL
Server:
3
| 17
| 18
Admin
Password
Confirm
Password
Description
This
is
the
name
of
your
BWPM
Instance.
Choose
a
different
name
for
each
of
your
environments
(Dev,
Test
and
Prod)
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.
Password
of
the
administrator
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.
| 19
Specify
the
following
information:
Attributes
Name
Provider
URL
Use
JNDI
Connection
factory
Username
Password
Description
Name
of
the
JMS
Connection
This
is
the
URL
of
your
JMS
Server:
For
JNDI:
tibjmsnaming://<servername>:<port>
No
JNDI:
tcp://<servername>:<port>
Activate
this
option,
if
you
want
to
use
JNDI
For
JNDI
specify
the
connection
factory
according
to
your
JMS
Server
This
is
the
JMS
user
account
for
BWPM
Password
of
the
user
Click
on
Test
connection
to
verify
your
settings.
If
the
connection
could
be
established
successfully,
click
on
Save
settings.
| 20
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:
| 21
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.
| 22
| 23
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.
| 24
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.
| 26
tibjms.jar
TIBCO EMS
JMS Server
Where
to
get
Oracle
homepage
Microsoft
homepage
lib
directory
of
EMS
installation
lib
directory
of
EMS
installation
lib
directory
of
EMS
installation
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.
| 27
<CATALINA_BASE>/webapps/bwpm.war
| 28
Appendix
A:
Glossary
Term
Administrator
account
Data Provider
Instance
webUI
Definition
This
user
is
used
for
administration
of
the
BWPM
Instance:
User-
Management,
grant
permissions,
maintenance,
etc.
A
data
provider
consists
of
a
connection
to
a
message
server
and
a
destination
Represents
the
combination
of
various
components
that
are
interacting
together
within
one
environment.
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).
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.
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.
Specific
user
account
with
limited
access
to
setup
and
administer
the
BWPM
Instance.
This
user
is
used
to
initial
setup
a
new
BWPM
Instance.
Web
based
user
interface
of
BWPM.
This
is
the
main
interface
the
user
can
interact
with
BWPM.
| 29