user manual

i
Chapter 1
Introduction to Borland Enterprise
Server 1
BES Product overview. . . . . . . . . . . . . . . 1
Web Edition . . . . . . . . . . . . . . . . . . 2
Web Edition features . . . . . . . . . . . . 2
VisiBroker Edition . . . . . . . . . . . . . . . 3
VisiBroker Edition features . . . . . . . . . 3
VisiBroker Standalone (installation option). . . 3
Team Edition . . . . . . . . . . . . . . . . . . 3
Team Edition features . . . . . . . . . . . . 4
Borland Enterprise Server “AppServer Edition” 4
Borland Enterprise Server “AppServer
Edition” features . . . . . . . . . . . . . . 4
Borland Enterprise Server (BES) Documentation . 4
Accessing the BES Standalone online Help
Topics . . . . . . . . . . . . . . . . . . . . . 5
Accessing online Help Topics from within BES 6
Documentation conventions . . . . . . . . . . . . 6
Platform conventions . . . . . . . . . . . . . . 6
Contacting Borland support . . . . . . . . . . . . 7
Online resources . . . . . . . . . . . . . . . . 7
World Wide Web . . . . . . . . . . . . . . . . 8
Borland newsgroups . . . . . . . . . . . . . . 8
Chapter 2
Borland Enterprise Server overview
and architecture 9
BES architecture overview . . . . . . . . . . . . 9
BES services overview . . . . . . . . . . . . . 10
Web Server. . . . . . . . . . . . . . . . . . 10
JMS . . . . . . . . . . . . . . . . . . . . . 11
Smart Agent . . . . . . . . . . . . . . . . . 11
2PC Transaction Service . . . . . . . . . . . 12
Management . . . . . . . . . . . . . . . . . 12
The Partition and its services . . . . . . . . . . 12
Connector Service . . . . . . . . . . . . . . 13
EJB Container . . . . . . . . . . . . . . . . 13
JDataStore Server . . . . . . . . . . . . . . 13
Lifecycle Interceptor Manager . . . . . . . . 13
Naming Service . . . . . . . . . . . . . . . 13
Session Storage Service . . . . . . . . . . . 14
Transaction Manager . . . . . . . . . . . . . 14
Web Container . . . . . . . . . . . . . . . . 14
Borland Enterprise Server and J2EE APIs . . . 14
JDBC . . . . . . . . . . . . . . . . . . . . 15
Java Mail. . . . . . . . . . . . . . . . . . . 15
JTA. . . . . . . . . . . . . . . . . . . . . . 15
JAXP. . . . . . . . . . . . . . . . . . . . . 16
JNDI . . . . . . . . . . . . . . . . . . . . . 16
RMI-IIOP. . . . . . . . . . . . . . . . . . . 16
Other Technologies . . . . . . . . . . . . . 16
OptimizeIt Profiler . . . . . . . . . . . . . . 16
Chapter 3
Partitions 17
Partitions Overview . . . . . . . . . . . . . . . 17
Creating Partitions . . . . . . . . . . . . . . . 18
Running Partitions . . . . . . . . . . . . . . . 19
Running unmanaged Partitions . . . . . . . 19
Running managed Partitions . . . . . . . . 21
Partition logging . . . . . . . . . . . . . . . 21
Configuring Partitions . . . . . . . . . . . . . . 22
Application archives . . . . . . . . . . . . . 22
Working with Partition services . . . . . . . 22
Partition handling of services. . . . . . . 23
Configuring individual services . . . . . . 23
Gathering Statistics . . . . . . . . . . . . . 23
Security management and policies . . . . . 24
Classloading policies . . . . . . . . . . . . 24
Partition Lifecycle Interceptors. . . . . . . . 24
Chapter 4
Web components 27
Apache web server implementation . . . . . . 27
Apache configuration . . . . . . . . . . . . 27
Apache configuration syntax. . . . . . . . . 28
Using the .htaccess files . . . . . . . . . . . 28
Apache directory structure . . . . . . . . 29
Borland web container implementation . . . . . 29
Servlets and JavaServer Pages . . . . . . . 30
Typical web application development process 30
Web application archive (WAR) file . . . . . 31
Borland-specific DTD . . . . . . . . . . . 31
Adding ENV variables for the web container .
36
Microsoft Internet Information Services (IIS) web
server . . . . . . . . . . . . . . . . . . . . . 36
IIS/IIOP redirector directory structure . . . . 37
Smart Agent implementation . . . . . . . . . . 37
Contents