JBoss 3.2 Deployment and Administration

Transcription

1 JBoss 3.2 Deployment and Administration Meeraj Kunnumpurath APress Media, LLC

2 }Boss 3.2 Deployment and Administration Copyright 2004 by Meeraj Kunnumpurath Originally published by Apress in 2004 Ali rights reserved. No part of this work may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage or retrieval system, without the prior written permission of the copyright owner and the publisher. ISBN ISBN (ebook) DOI / Trademarked names may appear in this book. Rather than use a trademark symbol with every occurrence of a trademarked name, we use the names only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. Technical Reviewer: Craig Berry Editorial Board: Dan Appleman, Craig Berry, Gary Cornell, Tony Davis, Steven Rycroft, Julian Skinner, Martin Streicher, Jim Sumser, Karen Watterson, Gavin Wray, John Zukowski Assistant Publisher: Grace Wong Project Manager: Tracy Brown Collins Copy Editor: Kim Wimpsett Production Manager: Kari Brooks Production Editor: Kelly Winquist Proofreader: Lori Bring Compositor: Molly Sharp Indexer: Bill Johncocks Cover Designer: Kurt Krames The information in this book is distributed on an "as is" hasis, without warranty. Although every precaution has been taken in the preparation of this work, neither the author(s) nor Apress shall have any liability to any person or entity with respect to any loss or damage caused or alleged to be caused directly or indirectly by the information contained in this work.

3 Contents at a Glance About the Author... ix Introduction... xi Chapter 1 Chapter 2 Chapter 3 Chapter4 Chapter 5 Chapter6 Chapter7 ChapterS Chapter9 ]Boss Server 3.x Features... 1 Installing ]Boss... 5 Operating ]Boss The ]Boss Configuration Architecture Runtime Properties Configuring Naming Configuring Security Configuring JCA and Datasources Configuring JBossMQ Chapter 10 Configuring JavaMail Chapter 11 Configuring Jetty Chapter 12 Configuring Tomcat Chapter 13 Configuring Clusters Chapter 14 Configuring Logging Chapter 15 The ]Boss Deployment Architecture Chapter 16 Configuring WAR Deployment Chapter 17 Developing EJBs with]boss Chapter 18 Configuring CMP Chapter 19 EAR Configuration Chapter 20 Additional ]Boss Configuration Index Ill

4 Contents About the Author... ix Introduction... xi Chapter 1 ]Boss Server 3.x Features ]Boss Components ]Boss Versions J2EE Support Custom Features... 4 Chapter 2 Installing ]Boss Installing ]Boss ]Boss Directory Structure Server Configuration Sets Chapter 3 Operating ]Boss Starting ]Boss Shutting Down ]Boss Chapter 4 The ]Boss Configuration Architecture An Overview of JMX JMX in]boss Accessing the JMX Agent Chapter 5 Runtime Properties ]Boss Classloading Setting the Classpath Setting ]VM Options Chapter 6 Configuring Naming The ]Boss Naming Service JNDI Client Configuration JNDI View External JNDI Namespaces JNDI Link References HTTP-Based JNDI Chapter 7 Configuring Security ]Boss Security Features The ]Boss Security Layer JBossSX Implementation Security Proxies Enabling SSL v

5 Contents Chapter 8 Configuring JCA and Datasources JCA injbosscx JBossCX and Datasources Chapter 9 Configuring JBossMQ JBossMQ Architecture Invocation Layer Destination Manager Message Cache State Manager Persistence Manager Destinations Security Manager Administering JMS Chapter 10 Configuring JavaMail The Mail Service MBean Configuring the Mail Service Chapter 11 Configuring Jetty AbstractWebContainer Configuring Jetty Chapter 12 Configuring Tomcat Configuring Tomcat Chapter 13 Configuring Clusters An Overview of Clustering Clustering Requirements ]Boss Clustering Chapter 14 Configuring Logging The Logging MBean Log4J Overview Configuring Logging Administering Logging TRACE Priority Chapter 15 The]Boss Deployment Architecture Deployers Hot Deployment The Deployment Process Chapter 16 Configuring WAR Deployment The ]Boss Web Deployment Descriptor vi

6 Contents Chapter 17 Developing E]Bs withjboss Container Configuration Invoker Proxy Binding Container Configuration Details Bean-Level Configuration EJB Security Chapter 18 Configuring CMP CMP Configuration Files Mapping EJB Names Datasource Mapping Datasource Create and Remove Table Table Name Read-Only Mapping CMP Fields Mapping Relationships Mapping Queries Tuning CMP Performance Optimistic Locking Auditing Locking and Concurrency Entity Commands Chapter 19 EAR Configuration The EAR Deployer The ]Boss EAR Deployment Descriptor Chapter 20 Additional}Boss Configuration Scheduling Tasks System Properties Index vii

7 About the Author MeeraJ Kunnumpurath Meeraj works as a senior information specialist with Electronic Data Systems. He has been using enterprise Java for more than four years. He's a Sun Certified Java Programmer and Web Component Developer. He also writes for popular web sites and journals. He loves football (as it's called outside the United States). He's a big fan of Chelsea Football Club and hopes they win the premiership this season. You can reach Meeraj at meeraj@lycos.com I thank Allah for making this possible. I'd like to thank the ]Boss Group and all the ]Boss developers for producing such a wonderful product and making the source open. Without their source, I wouldn't have been able to write this book. I'd also ltke to thank Craig for helping me do this book as well as all the other projects I've been involved with at Wrox and Apress with Craig. I also thank Abdul Rahim for the friend and brother he has been. I'd ltke to dedicate the work I've done for this book to my brothers and sisters, who have been refugees in their own land, for 50 years of endless suffering and misery. Allah says, "Veriry hardship follows ease. " lx

8 Introduction Over the past five years, Java 2 Enterprise Edition (J2EE) has evolved as one of the most popular technologies for building enterprise-class applications. J2EE provides a platform for building robust, high-performing, scalable, manageable, maintainable, and portable enterprise-class applications. One of the key factors that has contributed significantly to the success of J2EE as an enterprise platform is portability. Specifically, J2EE is an open standard and isn't tied to any proprietary vendor-specific implementation. It takes the "write once, run anywhere" spirit of Java to new heights. J2EE provides portability of applications across J2EE vendors by externalizing the runtime behavior of the components such as transactions, security, persistence, lifecycle management, and so on from the compiled binaries of the components into Extensible Markup Language (XML)-based deployment descriptors. One of the important features of J2EE is that it lets the container providers decide how to implement the aforementioned runtime services that they provide to the components. In most cases, the component developers will concentrate on the business logic behind the components; application assemblers and component deployers will take these components and configure their runtime behavior based on the target platform on which they'll be deployed. Application assemblers and deployers usually do this by amending the standard deployment descriptors that come with the components and adding container-specific deployment descriptors to the components. Hence, to develop powerful J2EE applications that fully utilize the runtime services provided by the platforms in which they run, you should be well versed with the configuration and deployment of J2EE components on specific application servers. Also, to ensure that applications run properly once they're deployed, you should be able to monitor and manage the components within the application server environments.

9 Introduction This book concentrates on one of the most popular open-source application servers, ]Boss, with more than 50,000 downloads a month, from the ]Boss Group. The book covers ]Boss 3.x and specifically version 3.2, which supports most of the J2EE 1.3 features. This book covers how to configure various J2EE components to fully utilize the runtime services provided by the ]Boss server and shows how to configure, manage, and administrate the ]Boss server itself. Throughout this book, I'll use the petstore application version from Sun Microsystems to illustrate the various deployment aspects of J2EE components on the ]Boss server. The petstore application comes preconfigured with the deployment information required for the J2EE Reference Implementation (RI) from Sun Microsystems. You'll learn how to configure these components to fully utilize the runtime services provided by the ]Boss server. In the process, you'll also identify the key issues involved in porting J2EE applications from one application server to another. You can download the petstore application from jjava.sun.comjj2eejdownload.html. What's Covered in This Book? Chapter 1 covers the ]Boss 3.x server features that you'll need to know. The rest of the chapters cover topics that can be broadly classified into the following categories: Q Q Q Running the server Configuring the server Deploying components Running the Server This section covers the following topics: Q Server installation in Chapter 2 Q Server architecture in Chapter 2 Q Operating the server in Chapter 3 Configuring the Server This section covers the following topics: Q The ]Boss Java Management Extensions (JMX) management and administration architecture in Chapter 4 Q Configuring runtime properties in Chapter 5 xll

10 Reading XML Structures o Configuring naming services in Chapter 6 o Configuring security in Chapter 7 o Configuring Java Database Connectivity (JDBC) datasources in Chapter 8 o Configuring Java Message Service (JMS)-administered objects in Chapter 9 0 Configuring mail sessions in Chapter 10 0 Configuring the Tomcat and Jetty web containers and web servers in Chapters 11 and 12 0 Configuring cluster environments in Chapter 13 o Configuring logging properties in Chapter 14 Deploying Components This section covers the following topics: 0 The ]Boss deployment architecture in Chapter 15 0 Deploying web components and the ]Boss web deployment descriptor in Chapter 16 o Deploying Enterprise JavaBean (E]B) components and the ]Boss EJB deployment descriptors in Chapters 17 and 18 o Deploying Enterprise Archive (EAR) applications and the ]Boss EAR deployment descriptor in Chapter 19 0 Deploying custom ]Boss components in Chapter 20 Reading XML Structures Throughout this book, you'll see diagrams generated using XMLSpy from Altova ( / that illustrate the structure of the various XML documents that are used to configure ]Boss and the various components deployed within ]Boss. This section provides a brief overview of the notations and icons used by XMLSpy for representing the various aspects of an XML content model. Please note that this section isn't a tutorial on XML, XML Schema, or Document Type Definitions (DTDs). XIII

11 Introduction XMLSpy uses the notation highlighted in the following diagram for representing "sequence" in an XML schema: In the previous diagram, this therefore means that the Altova element will contain a Name and Division subelement as so: <Altova> <Name/> <Division/> </Altova> The notation highlighted in the following diagram represents "choice" in an XML schema: In the previous diagram, this therefore means that the Altova element will contain either a Name or a Division subelement. An element that can appear exactly once in its parent's content model is represented by a solid border: An element that can optionally appear in its parent's content model is represented by a dashed border: : Element ' """"""""""=.:.~ xlv

12 Reading XML Structures The following notation represents an element that can appear from zero to many times in its parent's content model: The following notation represents an element that can appear from zero to a fixed number of times in its parent's content model. In the following diagram, the element may appear zero to ten times: The following notation represents an element that can appear from one to many times in its parent's content model: The following notation represents an element that can appear from one to a fixed number of times in its parent's content model. In the following diagram, the element may appear one to ten times: XV