web server - Borland Technical Publications
web server - Borland Technical Publications web server - Borland Technical Publications
Borland Software Corporation 100 Enterprise Way Scotts Valley, California 95066-3249 www.borland.com Borland Software Corporation may have patents and/or pending patent applications covering subject matter in this document. Please refer to the product CD or the About dialog box for the list of applicable patents. The furnishing of this document does not give you any license to these patents. COPYRIGHT © 1992-2004 Borland Software Corporation. All rights reserved. All Borland brand and product names are trademarks or registered trademarks of Borland Software Corporation in the United States and other countries. All other marks are the property of their respective owners. This product includes software developed by the Apache Software Foundation (http://www.apache.org/). This product includes software developed by Steve Viens and contributors. All rights reserved (http://juddi.org/). This product includes software developed by the MX4J project. All rights reserved (http://mx4j.sourceforge.net/). BES0065WW21002 0102030405-987654321 PDF
Contents Chapter 1 Introduction to Borland Enterprise Server (BES) 1 BES Products and Editions overview . . . . . . . . . 1 AppServer Edition . . . . . . . . . . . . . . . . . 1 AppServer Edition features . . . . . . . . . . 2 VisiBroker Edition . . . . . . . . . . . . . . . . . 2 VisiBroker Edition features . . . . . . . . . . . 2 Borland Enterprise Server Documentation . . . . . . 3 Accessing BES online help topics in the standalone Help Viewer . . . . . . . . . . . . . 4 Accessing BES online help topics from within a BES GUI tool . . . . . . . . . . . . . . 4 Documentation conventions . . . . . . . . . . . . . 4 Platform conventions . . . . . . . . . . . . . . . 5 Contacting Borland support. . . . . . . . . . . . . . 5 Online resources. . . . . . . . . . . . . . . . . . 5 World Wide Web . . . . . . . . . . . . . . . . . 6 Borland newsgroups . . . . . . . . . . . . . . . . 6 Chapter 2 Borland Enterprise Server overview and architecture 7 BES architecture overview . . . . . . . . . . . . . . 7 BES services overview . . . . . . . . . . . . . . . . 8 Web Server . . . . . . . . . . . . . . . . . . . . 8 JMS . . . . . . . . . . . . . . . . . . . . . . . . 9 Smart Agent . . . . . . . . . . . . . . . . . . . . 9 2PC Transaction Service . . . . . . . . . . . . . 9 The Partition and its services . . . . . . . . . . . . . 9 Connector Service . . . . . . . . . . . . . . . . . 10 EJB Container . . . . . . . . . . . . . . . . . . . 10 JDataStore Server . . . . . . . . . . . . . . . . . 10 Lifecycle Interceptor Manager . . . . . . . . . . . 10 Naming Service . . . . . . . . . . . . . . . . . . 10 Session Storage Service . . . . . . . . . . . . . 11 Transaction Manager . . . . . . . . . . . . . . . 11 Web Container . . . . . . . . . . . . . . . . . . . 11 Borland Enterprise Server and J2EE APIs . . . . . . 11 JDBC . . . . . . . . . . . . . . . . . . . . . . . 12 Java Mail. . . . . . . . . . . . . . . . . . . . . . 12 JTA. . . . . . . . . . . . . . . . . . . . . . . . . 12 JAXP . . . . . . . . . . . . . . . . . . . . . . . . 12 JNDI . . . . . . . . . . . . . . . . . . . . . . . . 12 RMI-IIOP. . . . . . . . . . . . . . . . . . . . . . 12 Other Technologies . . . . . . . . . . . . . . . . 13 Optimizeit Profiler and Optimizeit ServerTrace . . 13 Chapter 3 Partitions 15 Partitions Overview . . . . . . . . . . . . . . . . . . 15 Creating Partitions . . . . . . . . . . . . . . . . . . 16 Running Partitions . . . . . . . . . . . . . . . . . . 17 Running unmanaged Partitions . . . . . . . . . . 17 Running managed Partitions . . . . . . . . . . . 18 Running Partitions with Optimizeit Profiler or ServerTrace . . . . . . . . . . . . . . . . . . . 19 Partition logging . . . . . . . . . . . . . . . . . 19 Configuring Partitions . . . . . . . . . . . . . . . . 19 Application archives . . . . . . . . . . . . . . . 19 Working with Partition services. . . . . . . . . . 20 Partition handling of services . . . . . . . . . 20 Configuring individual services . . . . . . . . 20 Configuring VisiNaming Service Clusters for BES. . . . . . . . . . . . . . . . . . . . 20 Gathering Statistics. . . . . . . . . . . . . . . . 21 Security management and policies. . . . . . . . 21 Classloading policies . . . . . . . . . . . . . . . 21 Partition Lifecycle Interceptors . . . . . . . . . . 21 JMX support in Partitions . . . . . . . . . . . . . . 22 Configuring the JMX Agent. . . . . . . . . . . . 22 Partition monitoring. . . . . . . . . . . . . . . . 23 Partition MBeans . . . . . . . . . . . . . . . . . 23 Deploying custom MBeans . . . . . . . . . . . . 24 Locating the JMX agent . . . . . . . . . . . . . 25 Thread pools. . . . . . . . . . . . . . . . . . . . . 25 Default thread pool . . . . . . . . . . . . . . . . 25 Auxiliary thread pool . . . . . . . . . . . . . . . 26 Chapter 4 Web components 29 Apache web server implementation . . . . . . . . . 29 Apache configuration . . . . . . . . . . . . . . . 29 Apache configuration syntax . . . . . . . . . . . 30 Running Apache web server on a privileged port. . . . . . . . . . . . . . . . . . 30 Using the .htaccess files . . . . . . . . . . . . . 31 Apache directory structure . . . . . . . . . . 31 Borland web container implementation . . . . . . . 32 Servlets and JavaServer Pages . . . . . . . . . 32 Typical web application development process . . 33 Web application archive (WAR) file. . . . . . . . 33 Borland-specific DTD . . . . . . . . . . . . . 33 Adding ENV variables for the web container . . . . . . . . . . . . . . . . 36 Microsoft Internet Information Services (IIS) web server . . . . . . . . . . . . . . . . . . . . . 37 IIS/IIOP redirector directory structure . . . . . . 37 Smart Agent implementation . . . . . . . . . . . . 38 Connecting an Apache web server to a Borland web container . . . . . . . . . . . . . 38 Connecting Borland web containers to Java Session Service . . . . . . . . . . . . . . 39 Chapter 5 Web server to web container connectivity 41 Apache web server to Borland web container connectivity. . . . . . . . . . . . . . . . . . . . . 41 Modifying the Borland web container IIOP configuration . . . . . . . . . . . . . . . . . . 41 i
- Page 1: Developer’s Guide Enterprise Serv
- Page 5 and 6: Entity beans . . . . . . . . . . .
- Page 7 and 8: Chapter 23 Using JMS 209 Configurin
- Page 9 and 10: Entity Bean Properties (applicable
- Page 11 and 12: Figures 0.1 Borland Enterprise Serv
- Page 13 and 14: BES Products and Editions overview
- Page 15 and 16: Documentation conventions Important
- Page 17 and 18: Contacting Borland support World Wi
- Page 19 and 20: BES services overview Figure 0.1 Bo
- Page 21 and 22: The Partition and its services ■
- Page 23 and 24: Borland Enterprise Server and J2EE
- Page 25 and 26: 14 BES Developer’s Guide
- Page 27 and 28: Creating Partitions Creating Partit
- Page 29 and 30: Running Partitions Table 3.1 Option
- Page 31 and 32: Configuring Partitions You can also
- Page 33 and 34: JMX support in Partitions ■ ■ A
- Page 35 and 36: JMX support in Partitions Figure 3.
- Page 37 and 38: Thread pools Partition properties r
- Page 39 and 40: 28 BES Developer’s Guide
- Page 41 and 42: Apache web server implementation Fo
- Page 43 and 44: Borland web container implementatio
- Page 45 and 46: Borland web container implementatio
- Page 47 and 48: Borland web container implementatio
- Page 49 and 50: Smart Agent implementation Smart Ag
- Page 51 and 52: 40 BES Developer’s Guide
Contents<br />
Chapter 1<br />
Introduction to <strong>Borland</strong> Enterprise Server<br />
(BES) 1<br />
BES Products and Editions overview . . . . . . . . . 1<br />
AppServer Edition . . . . . . . . . . . . . . . . . 1<br />
AppServer Edition features . . . . . . . . . . 2<br />
VisiBroker Edition . . . . . . . . . . . . . . . . . 2<br />
VisiBroker Edition features . . . . . . . . . . . 2<br />
<strong>Borland</strong> Enterprise Server Documentation . . . . . . 3<br />
Accessing BES online help topics in the<br />
standalone Help Viewer . . . . . . . . . . . . . 4<br />
Accessing BES online help topics from<br />
within a BES GUI tool . . . . . . . . . . . . . . 4<br />
Documentation conventions . . . . . . . . . . . . . 4<br />
Platform conventions . . . . . . . . . . . . . . . 5<br />
Contacting <strong>Borland</strong> support. . . . . . . . . . . . . . 5<br />
Online resources. . . . . . . . . . . . . . . . . . 5<br />
World Wide Web . . . . . . . . . . . . . . . . . 6<br />
<strong>Borland</strong> newsgroups . . . . . . . . . . . . . . . . 6<br />
Chapter 2<br />
<strong>Borland</strong> Enterprise Server overview and<br />
architecture 7<br />
BES architecture overview . . . . . . . . . . . . . . 7<br />
BES services overview . . . . . . . . . . . . . . . . 8<br />
Web Server . . . . . . . . . . . . . . . . . . . . 8<br />
JMS . . . . . . . . . . . . . . . . . . . . . . . . 9<br />
Smart Agent . . . . . . . . . . . . . . . . . . . . 9<br />
2PC Transaction Service . . . . . . . . . . . . . 9<br />
The Partition and its services . . . . . . . . . . . . . 9<br />
Connector Service . . . . . . . . . . . . . . . . . 10<br />
EJB Container . . . . . . . . . . . . . . . . . . . 10<br />
JDataStore Server . . . . . . . . . . . . . . . . . 10<br />
Lifecycle Interceptor Manager . . . . . . . . . . . 10<br />
Naming Service . . . . . . . . . . . . . . . . . . 10<br />
Session Storage Service . . . . . . . . . . . . . 11<br />
Transaction Manager . . . . . . . . . . . . . . . 11<br />
Web Container . . . . . . . . . . . . . . . . . . . 11<br />
<strong>Borland</strong> Enterprise Server and J2EE APIs . . . . . . 11<br />
JDBC . . . . . . . . . . . . . . . . . . . . . . . 12<br />
Java Mail. . . . . . . . . . . . . . . . . . . . . . 12<br />
JTA. . . . . . . . . . . . . . . . . . . . . . . . . 12<br />
JAXP . . . . . . . . . . . . . . . . . . . . . . . . 12<br />
JNDI . . . . . . . . . . . . . . . . . . . . . . . . 12<br />
RMI-IIOP. . . . . . . . . . . . . . . . . . . . . . 12<br />
Other Technologies . . . . . . . . . . . . . . . . 13<br />
Optimizeit Profiler and Optimizeit ServerTrace . . 13<br />
Chapter 3<br />
Partitions 15<br />
Partitions Overview . . . . . . . . . . . . . . . . . . 15<br />
Creating Partitions . . . . . . . . . . . . . . . . . . 16<br />
Running Partitions . . . . . . . . . . . . . . . . . . 17<br />
Running unmanaged Partitions . . . . . . . . . . 17<br />
Running managed Partitions . . . . . . . . . . . 18<br />
Running Partitions with Optimizeit Profiler or<br />
ServerTrace . . . . . . . . . . . . . . . . . . . 19<br />
Partition logging . . . . . . . . . . . . . . . . . 19<br />
Configuring Partitions . . . . . . . . . . . . . . . . 19<br />
Application archives . . . . . . . . . . . . . . . 19<br />
Working with Partition services. . . . . . . . . . 20<br />
Partition handling of services . . . . . . . . . 20<br />
Configuring individual services . . . . . . . . 20<br />
Configuring VisiNaming Service Clusters<br />
for BES. . . . . . . . . . . . . . . . . . . . 20<br />
Gathering Statistics. . . . . . . . . . . . . . . . 21<br />
Security management and policies. . . . . . . . 21<br />
Classloading policies . . . . . . . . . . . . . . . 21<br />
Partition Lifecycle Interceptors . . . . . . . . . . 21<br />
JMX support in Partitions . . . . . . . . . . . . . . 22<br />
Configuring the JMX Agent. . . . . . . . . . . . 22<br />
Partition monitoring. . . . . . . . . . . . . . . . 23<br />
Partition MBeans . . . . . . . . . . . . . . . . . 23<br />
Deploying custom MBeans . . . . . . . . . . . . 24<br />
Locating the JMX agent . . . . . . . . . . . . . 25<br />
Thread pools. . . . . . . . . . . . . . . . . . . . . 25<br />
Default thread pool . . . . . . . . . . . . . . . . 25<br />
Auxiliary thread pool . . . . . . . . . . . . . . . 26<br />
Chapter 4<br />
Web components 29<br />
Apache <strong>web</strong> <strong>server</strong> implementation . . . . . . . . . 29<br />
Apache configuration . . . . . . . . . . . . . . . 29<br />
Apache configuration syntax . . . . . . . . . . . 30<br />
Running Apache <strong>web</strong> <strong>server</strong> on a<br />
privileged port. . . . . . . . . . . . . . . . . . 30<br />
Using the .htaccess files . . . . . . . . . . . . . 31<br />
Apache directory structure . . . . . . . . . . 31<br />
<strong>Borland</strong> <strong>web</strong> container implementation . . . . . . . 32<br />
Servlets and JavaServer Pages . . . . . . . . . 32<br />
Typical <strong>web</strong> application development process . . 33<br />
Web application archive (WAR) file. . . . . . . . 33<br />
<strong>Borland</strong>-specific DTD . . . . . . . . . . . . . 33<br />
Adding ENV variables for the<br />
<strong>web</strong> container . . . . . . . . . . . . . . . . 36<br />
Microsoft Internet Information Services (IIS)<br />
<strong>web</strong> <strong>server</strong> . . . . . . . . . . . . . . . . . . . . . 37<br />
IIS/IIOP redirector directory structure . . . . . . 37<br />
Smart Agent implementation . . . . . . . . . . . . 38<br />
Connecting an Apache <strong>web</strong> <strong>server</strong> to a<br />
<strong>Borland</strong> <strong>web</strong> container . . . . . . . . . . . . . 38<br />
Connecting <strong>Borland</strong> <strong>web</strong> containers to<br />
Java Session Service . . . . . . . . . . . . . . 39<br />
Chapter 5<br />
Web <strong>server</strong> to <strong>web</strong><br />
container connectivity 41<br />
Apache <strong>web</strong> <strong>server</strong> to <strong>Borland</strong> <strong>web</strong> container<br />
connectivity. . . . . . . . . . . . . . . . . . . . . 41<br />
Modifying the <strong>Borland</strong> <strong>web</strong> container IIOP<br />
configuration . . . . . . . . . . . . . . . . . . 41<br />
i