Jump To Close Expand all Collapse all Table of contents Administration and Configuration Guide I. Overview Expand section "I. Overview" Collapse section "I. Overview" 1. Scope of Book 2. Introduction Expand section "2. Introduction" Collapse section "2. Introduction" 2.1. Integrated Projects 2.2. Architecture 2.3. Directory Structure 2.4. JBoss Enterprise Application Platform Use Cases 2.5. Bootstrap 2.6. Hot Deployment Expand section "2.6. Hot Deployment" Collapse section "2.6. Hot Deployment" 2.6.1. Adding a Custom Deploy Folder II. JBoss Enterprise Application Platform Configuration Expand section "II. JBoss Enterprise Application Platform Configuration" Collapse section "II. JBoss Enterprise Application Platform Configuration" 3. Network Expand section "3. Network" Collapse section "3. Network" 3.1. IPv6 Support 4. JBoss Web Expand section "4. JBoss Web" Collapse section "4. JBoss Web" 4.1. System Properties Expand section "4.1. System Properties" Collapse section "4.1. System Properties" 4.1.1. Modifying System Properties 4.2. Configuring the JBoss Web Container 4.3. The Main Config File 4.4. Top-Level Elements Expand section "4.4. Top-Level Elements" Collapse section "4.4. Top-Level Elements" 4.4.1. Server 4.4.2. Service 4.5. Connector Expand section "4.5. Connector" Collapse section "4.5. Connector" 4.5.1. Executor 4.6. Containers Expand section "4.6. Containers" Collapse section "4.6. Containers" 4.6.1. Engine 4.6.2. Host 4.6.3. Context 4.7. Nested Components Expand section "4.7. Nested Components" Collapse section "4.7. Nested Components" 4.7.1. Realm 4.7.2. Valve 4.7.3. GlobalNamingResources 5. Enterprise Applications with EJB3 Services Expand section "5. Enterprise Applications with EJB3 Services" Collapse section "5. Enterprise Applications with EJB3 Services" 5.1. Session Beans 5.2. Entity Beans (a.k.a. Java Persistence API) Expand section "5.2. Entity Beans (a.k.a. Java Persistence API)" Collapse section "5.2. Entity Beans (a.k.a. Java Persistence API)" 5.2.1. The persistence.xml file 5.2.2. Use Alternative Databases 5.2.3. Default Hibernate Options 5.3. Message Driven Beans 5.4. Package and Deploy EJB3 Services Expand section "5.4. Package and Deploy EJB3 Services" Collapse section "5.4. Package and Deploy EJB3 Services" 5.4.1. Deploy the EJB3 JAR 5.4.2. Deploy EAR with EJB3 JAR 6. Logging Expand section "6. Logging" Collapse section "6. Logging" 6.1. Logging Defaults 6.2. Component-Specific Logging Expand section "6.2. Component-Specific Logging" Collapse section "6.2. Component-Specific Logging" 6.2.1. SQL Logging with Hibernate 6.2.2. Transaction Service Logging 7. Deployment Expand section "7. Deployment" Collapse section "7. Deployment" 7.1. Deployable Application Types Expand section "7.1. Deployable Application Types" Collapse section "7.1. Deployable Application Types" 7.1.1. Exploded Deployment 7.2. Standard Server Profiles Expand section "7.2. Standard Server Profiles" Collapse section "7.2. Standard Server Profiles" 7.2.1. Changing Profile 7.2.2. Creating Your Own Profile 7.3. Context Root 8. Microcontainer 9. The JNDI Naming Service Expand section "9. The JNDI Naming Service" Collapse section "9. The JNDI Naming Service" 9.1. An Overview of JNDI Expand section "9.1. An Overview of JNDI" Collapse section "9.1. An Overview of JNDI" 9.1.1. Names 9.1.2. Contexts 9.2. The JBoss Naming Service Architecture 9.3. The Naming InitialContext Factories Expand section "9.3. The Naming InitialContext Factories" Collapse section "9.3. The Naming InitialContext Factories" 9.3.1. The standard naming context factory 9.3.2. The org.jboss.naming.NamingContextFactory 9.3.3. Naming Discovery in Clustered Environments 9.3.4. The HTTP InitialContext Factory Implementation 9.3.5. The Login InitialContext Factory Implementation 9.3.6. The ORBInitialContextFactory 9.4. JNDI over HTTP Expand section "9.4. JNDI over HTTP" Collapse section "9.4. JNDI over HTTP" 9.4.1. Accessing JNDI over HTTP 9.4.2. Accessing JNDI over HTTPS 9.4.3. Securing Access to JNDI over HTTP 9.4.4. Securing Access to JNDI with a Read-Only Unsecured Context 9.5. Additional Naming MBeans Expand section "9.5. Additional Naming MBeans" Collapse section "9.5. Additional Naming MBeans" 9.5.1. JNDI Binding Manager 9.5.2. The org.jboss.naming.NamingAlias MBean 9.5.3. org.jboss.naming.ExternalContext MBean 9.5.4. The org.jboss.naming.JNDIView MBean 9.6. J2EE and JNDI - The Application Component Environment Expand section "9.6. J2EE and JNDI - The Application Component Environment" Collapse section "9.6. J2EE and JNDI - The Application Component Environment" 9.6.1. ENC Usage Conventions 10. Web Services Expand section "10. Web Services" Collapse section "10. Web Services" 10.1. The need for web services 10.2. What web services are not 10.3. Document/Literal 10.4. Document/Literal (Bare) 10.5. Document/Literal (Wrapped) 10.6. RPC/Literal 10.7. RPC/Encoded 10.8. Web Service Endpoints 10.9. Plain old Java Object (POJO) 10.10. The endpoint as a web application 10.11. Packaging the endpoint 10.12. Accessing the generated WSDL 10.13. EJB3 Stateless Session Bean (SLSB) 10.14. Endpoint Provider 10.15. WebServiceContext 10.16. Web Service Clients Expand section "10.16. Web Service Clients" Collapse section "10.16. Web Service Clients" 10.16.1. Service 10.16.2. Dynamic Proxy 10.16.3. WebServiceRef 10.16.4. Dispatch 10.16.5. Asynchronous Invocations 10.16.6. Oneway Invocations 10.17. Common API Expand section "10.17. Common API" Collapse section "10.17. Common API" 10.17.1. Handler Framework 10.17.2. Message Context 10.17.3. Fault Handling 10.18. DataBinding Expand section "10.18. DataBinding" Collapse section "10.18. DataBinding" 10.18.1. Using JAXB with non annotated classes 10.19. Attachments Expand section "10.19. Attachments" Collapse section "10.19. Attachments" 10.19.1. MTOM/XOP 10.19.2. SwaRef 10.20. Tools Expand section "10.20. Tools" Collapse section "10.20. Tools" 10.20.1. Bottom-Up (Using wsprovide) 10.20.2. Top-Down (Using wsconsume) 10.20.3. Client Side 10.20.4. Command-line & Ant Task Reference 10.20.5. JAX-WS binding customization 10.21. Web Service Extensions Expand section "10.21. Web Service Extensions" Collapse section "10.21. Web Service Extensions" 10.21.1. WS-Addressing 10.21.2. WS-Security 10.21.3. XML Registries 10.22. JBossWS Extensions Expand section "10.22. JBossWS Extensions" Collapse section "10.22. JBossWS Extensions" 10.22.1. Proprietary Annotations 10.23. Web Services Appendix 10.24. References 11. Additional Services Expand section "11. Additional Services" Collapse section "11. Additional Services" 11.1. Exposing MBean Events via SNMP 12. JBoss AOP Expand section "12. JBoss AOP" Collapse section "12. JBoss AOP" 12.1. Some key terms 12.2. Creating Aspects in JBoss AOP 12.3. Applying Aspects in JBoss AOP 12.4. Packaging AOP Applications 12.5. The JBoss AspectManager Service 12.6. Loadtime transformation in the JBoss Enterprise Application Platform Using Sun JDK 12.7. JRockit 12.8. Improving Loadtime Performance in the JBoss Enterprise Application Platform Environment 12.9. Scoping the AOP to the classloader Expand section "12.9. Scoping the AOP to the classloader" Collapse section "12.9. Scoping the AOP to the classloader" 12.9.1. Deploying as part of a scoped classloader 12.9.2. Attaching to a scoped deployment 13. Transaction Management Expand section "13. Transaction Management" Collapse section "13. Transaction Management" 13.1. Overview 13.2. Configuration Essentials 13.3. Transactional Resources 13.4. Last Resource Commit Optimization (LRCO) 13.5. Transaction Timeout Handling 13.6. Recovery Configuration 13.7. Transaction Service FAQ 13.8. Using the JTS Module 13.9. Using the XTS Module 13.10. Transaction Management Console 13.11. Experimental Components 13.12. Source Code and Upgrading 14. Remoting Expand section "14. Remoting" Collapse section "14. Remoting" 14.1. Background 14.2. JBoss Remoting Configuration Expand section "14.2. JBoss Remoting Configuration" Collapse section "14.2. JBoss Remoting Configuration" 14.2.1. MBeans 14.2.2. POJOs 14.3. Multihomed servers 14.4. Address translation 14.5. Where are they now? 14.6. Further information. 15. Messaging Expand section "15. Messaging" Collapse section "15. Messaging" 15.1. Default JMS messaging providers 15.2. IBM WebSphere MQ Integration Expand section "15.2. IBM WebSphere MQ Integration" Collapse section "15.2. IBM WebSphere MQ Integration" 15.2.1. Configuring WebSphere MQ Integration 16. Using Production Databases with JBoss Enterprise Application Platform Expand section "16. Using Production Databases with JBoss Enterprise Application Platform" Collapse section "16. Using Production Databases with JBoss Enterprise Application Platform" 16.1. How to Use Production Databases 16.2. Installing JDBC Drivers Expand section "16.2. Installing JDBC Drivers" Collapse section "16.2. Installing JDBC Drivers" 16.2.1. Special Notes on Sybase 16.2.2. Configuring JDBC DataSources 16.3. Switching to a Production Database 16.4. Common Database-Related Tasks Expand section "16.4. Common Database-Related Tasks" Collapse section "16.4. Common Database-Related Tasks" 16.4.1. Security and Pooling 16.4.2. Change Database for the JMS Services 16.4.3. Support Foreign Keys in CMP Services 16.4.4. Specify Database Dialect for Java Persistence API 16.4.5. Change Other JBoss Enterprise Application Platform Services to use the External Database 16.4.6. A Special Note About Oracle Databases 17. Datasource Configuration Expand section "17. Datasource Configuration" Collapse section "17. Datasource Configuration" 17.1. Types of Datasources 17.2. Datasource Parameters 17.3. Datasource Examples Expand section "17.3. Datasource Examples" Collapse section "17.3. Datasource Examples" 17.3.1. Generic Datasource Example 17.3.2. Configuring a DataSource for Remote Usage 17.3.3. Configuring a Datasource to Use Login Modules 18. Pooling Expand section "18. Pooling" Collapse section "18. Pooling" 18.1. Strategy 18.2. Workaround for Oracle's JDK 18.3. Pool Access 18.4. Pool Filling 18.5. Idle Connections 18.6. Dead connections Expand section "18.6. Dead connections" Collapse section "18.6. Dead connections" 18.6.1. Valid connection checking 18.6.2. Errors during SQL queries 18.6.3. Changing, Closing or Flushing the pool 18.6.4. Using Third Party Pools III. Clustering Guide Expand section "III. Clustering Guide" Collapse section "III. Clustering Guide" 19. Introduction and Quick Start Expand section "19. Introduction and Quick Start" Collapse section "19. Introduction and Quick Start" 19.1. Quick Start Guide Expand section "19.1. Quick Start Guide" Collapse section "19.1. Quick Start Guide" 19.1.1. Initial Preparation 19.1.2. Launching a JBoss Enterprise Application Platform Cluster 19.1.3. Web Application Clustering Quick Start 19.1.4. EJB Session Bean Clustering Quick Start 19.1.5. Entity Clustering Quick Start 20. Clustering Concepts Expand section "20. Clustering Concepts" Collapse section "20. Clustering Concepts" 20.1. Cluster Definition 20.2. Service Architectures Expand section "20.2. Service Architectures" Collapse section "20.2. Service Architectures" 20.2.1. Client-side interceptor architecture 20.2.2. External Load Balancer Architecture 20.3. Load Balancing Policies Expand section "20.3. Load Balancing Policies" Collapse section "20.3. Load Balancing Policies" 20.3.1. Client-side interceptor architecture 20.3.2. External load balancer architecture 21. Clustering Building Blocks Expand section "21. Clustering Building Blocks" Collapse section "21. Clustering Building Blocks" 21.1. Group Communication with JGroups Expand section "21.1. Group Communication with JGroups" Collapse section "21.1. Group Communication with JGroups" 21.1.1. The Channel Factory Service 21.1.2. The JGroups Shared Transport 21.2. Distributed Caching with JBoss Cache Expand section "21.2. Distributed Caching with JBoss Cache" Collapse section "21.2. Distributed Caching with JBoss Cache" 21.2.1. The JBoss Enterprise Application Platform CacheManager Service 21.3. The HAPartition Service Expand section "21.3. The HAPartition Service" Collapse section "21.3. The HAPartition Service" 21.3.1. DistributedReplicantManager Service 21.3.2. DistributedState Service 21.3.3. Custom Use of HAPartition 22. Clustered JNDI Services Expand section "22. Clustered JNDI Services" Collapse section "22. Clustered JNDI Services" 22.1. How it works 22.2. Client configuration Expand section "22.2. Client configuration" Collapse section "22.2. Client configuration" 22.2.1. For clients running inside the Enterprise Application Platform 22.2.2. For clients running outside the Enterprise Application Platform 22.3. JBoss configuration Expand section "22.3. JBoss configuration" Collapse section "22.3. JBoss configuration" 22.3.1. Adding a Second HA-JNDI Service 23. Clustered Session EJBs Expand section "23. Clustered Session EJBs" Collapse section "23. Clustered Session EJBs" 23.1. Stateless Session Bean in EJB 3.0 23.2. Stateful Session Beans in EJB 3.0 Expand section "23.2. Stateful Session Beans in EJB 3.0" Collapse section "23.2. Stateful Session Beans in EJB 3.0" 23.2.1. The EJB application configuration 23.2.2. Optimize state replication 23.2.3. CacheManager service configuration 23.3. Stateless Session Bean in EJB 2.x 23.4. Stateful Session Bean in EJB 2.x Expand section "23.4. Stateful Session Bean in EJB 2.x" Collapse section "23.4. Stateful Session Bean in EJB 2.x" 23.4.1. The EJB application configuration 23.4.2. Optimize state replication 23.4.3. The HASessionStateService configuration 23.4.4. Handling Cluster Restart 23.4.5. JNDI Lookup Process 23.4.6. SingleRetryInterceptor 24. Clustered Entity EJBs Expand section "24. Clustered Entity EJBs" Collapse section "24. Clustered Entity EJBs" 24.1. Entity Bean in EJB 3.0 Expand section "24.1. Entity Bean in EJB 3.0" Collapse section "24.1. Entity Bean in EJB 3.0" 24.1.1. Configure the distributed cache 24.1.2. Configure the entity beans for cache 24.1.3. Query result caching 24.2. Entity Beans in EJB 2.x 25. HTTP Services 26. JBoss Messaging Clustering Notes 27. Clustered Deployment Options Expand section "27. Clustered Deployment Options" Collapse section "27. Clustered Deployment Options" 27.1. Clustered Singleton Services Expand section "27.1. Clustered Singleton Services" Collapse section "27.1. Clustered Singleton Services" 27.1.1. HASingleton Deployment Options 27.1.2. Determining the master node 27.2. Farming Deployment 28. JGroups Services Expand section "28. JGroups Services" Collapse section "28. JGroups Services" 28.1. Configuring a JGroups Channel's Protocol Stack Expand section "28.1. Configuring a JGroups Channel's Protocol Stack" Collapse section "28.1. Configuring a JGroups Channel's Protocol Stack" 28.1.1. Common Configuration Properties 28.1.2. Transport Protocols 28.1.3. Discovery Protocols 28.1.4. Failure Detection Protocols 28.1.5. Reliable Delivery Protocols 28.1.6. Group Membership (GMS) 28.1.7. Flow Control (FC) 28.2. Fragmentation (FRAG2) 28.3. State Transfer 28.4. Distributed Garbage Collection (STABLE) 28.5. Merging (MERGE2) 28.6. Other Configuration Issues Expand section "28.6. Other Configuration Issues" Collapse section "28.6. Other Configuration Issues" 28.6.1. Binding JGroups Channels to a Particular Interface 28.6.2. Isolating JGroups Channels 28.6.3. JGroups Troubleshooting 29. JBoss Cache Configuration and Deployment Expand section "29. JBoss Cache Configuration and Deployment" Collapse section "29. JBoss Cache Configuration and Deployment" 29.1. Key JBoss Cache Configuration Options Expand section "29.1. Key JBoss Cache Configuration Options" Collapse section "29.1. Key JBoss Cache Configuration Options" 29.1.1. Editing the CacheManager Configuration 29.1.2. Cache Mode 29.1.3. Transaction Handling 29.1.4. Concurrent Access 29.1.5. JGroups Integration 29.1.6. Eviction 29.1.7. Cache Loaders 29.1.8. Buddy Replication 29.2. Deploying Your Own JBoss Cache Instance Expand section "29.2. Deploying Your Own JBoss Cache Instance" Collapse section "29.2. Deploying Your Own JBoss Cache Instance" 29.2.1. Deployment Via the CacheManager Service 29.2.2. Deployment Via a -service.xml File 29.2.3. Deployment Via a -jboss-beans.xml File IV. Legacy EJB Support Expand section "IV. Legacy EJB Support" Collapse section "IV. Legacy EJB Support" 30. EJBs on JBoss Expand section "30. EJBs on JBoss" Collapse section "30. EJBs on JBoss" 30.1. The EJB Client Side View Expand section "30.1. The EJB Client Side View" Collapse section "30.1. The EJB Client Side View" 30.1.1. Specifying the EJB Proxy Configuration 30.2. The EJB Server Side View Expand section "30.2. The EJB Server Side View" Collapse section "30.2. The EJB Server Side View" 30.2.1. Detached Invokers - The Transport Middlemen 30.2.2. The HA JRMPInvoker - Clustered RMI/JRMP Transport 30.2.3. The HA HttpInvoker - Clustered RMI/HTTP Transport 30.3. The EJB Container Expand section "30.3. The EJB Container" Collapse section "30.3. The EJB Container" 30.3.1. EJBDeployer MBean 30.3.2. Container Plug-in Framework 30.4. Entity Bean Locking and Deadlock Detection Expand section "30.4. Entity Bean Locking and Deadlock Detection" Collapse section "30.4. Entity Bean Locking and Deadlock Detection" 30.4.1. Why JBoss Needs Locking 30.4.2. Entity Bean Lifecycle 30.4.3. Default Locking Behavior 30.4.4. Pluggable Interceptors and Locking Policy 30.4.5. Deadlock 30.4.6. Advanced Configurations and Optimizations 30.4.7. Running Within a Cluster 30.4.8. Troubleshooting 30.5. EJB Timer Configuration 31. The CMP Engine Expand section "31. The CMP Engine" Collapse section "31. The CMP Engine" 31.1. Example Code Expand section "31.1. Example Code" Collapse section "31.1. Example Code" 31.1.1. Enabling CMP Debug Logging 31.1.2. Running the examples 31.2. The jbosscmp-jdbc Structure 31.3. Entity Beans Expand section "31.3. Entity Beans" Collapse section "31.3. Entity Beans" 31.3.1. Entity Mapping 31.4. CMP Fields Expand section "31.4. CMP Fields" Collapse section "31.4. CMP Fields" 31.4.1. CMP Field Declaration 31.4.2. CMP Field Column Mapping 31.4.3. Read-only Fields 31.4.4. Auditing Entity Access 31.4.5. Dependent Value Classes (DVCs) 31.5. Container Managed Relationships Expand section "31.5. Container Managed Relationships" Collapse section "31.5. Container Managed Relationships" 31.5.1. CMR-Field Abstract Accessors 31.5.2. Relationship Declaration 31.5.3. Relationship Mapping 31.6. Queries Expand section "31.6. Queries" Collapse section "31.6. Queries" 31.6.1. Finder and select Declaration 31.6.2. EJB-QL Declaration 31.6.3. Overriding the EJB-QL to SQL Mapping 31.6.4. JBossQL 31.6.5. DynamicQL 31.6.6. DeclaredSQL 31.6.7. EJBQL 2.1 and SQL92 queries 31.6.8. BMP Custom Finders 31.7. Optimized Loading Expand section "31.7. Optimized Loading" Collapse section "31.7. Optimized Loading" 31.7.1. Loading Scenario 31.7.2. Load Groups 31.7.3. Read-ahead 31.8. Loading Process Expand section "31.8. Loading Process" Collapse section "31.8. Loading Process" 31.8.1. Commit Options 31.8.2. Eager-loading Process 31.8.3. Lazy loading Process 31.8.4. Lazy loading result sets 31.9. Transactions 31.10. Optimistic Locking 31.11. Entity Commands and Primary Key Generation Expand section "31.11. Entity Commands and Primary Key Generation" Collapse section "31.11. Entity Commands and Primary Key Generation" 31.11.1. Existing Entity Commands 31.12. Defaults Expand section "31.12. Defaults" Collapse section "31.12. Defaults" 31.12.1. A sample jbosscmp-jdbc.xml defaults declaration 31.13. Datasource Customization Expand section "31.13. Datasource Customization" Collapse section "31.13. Datasource Customization" 31.13.1. Type Mapping 31.13.2. Function Mapping 31.13.3. Mapping 31.13.4. User Type Mappings V. Appendices Expand section "V. Appendices" Collapse section "V. Appendices" A. Server Directory Structure Expand section "A. Server Directory Structure" Collapse section "A. Server Directory Structure" A.1. Server Profile Directory Structure Expand section "A.1. Server Profile Directory Structure" Collapse section "A.1. Server Profile Directory Structure" A.1.1. The default Server Profile File Set A.1.2. The all Server Profile File Set A.1.3. EJB3 Services B. Vendor-Specific Datasource Definitions Expand section "B. Vendor-Specific Datasource Definitions" Collapse section "B. Vendor-Specific Datasource Definitions" B.1. Deployer Location and Naming B.2. DB2 B.3. Oracle Expand section "B.3. Oracle" Collapse section "B.3. Oracle" B.3.1. Changes in Oracle 10g JDBC Driver B.3.2. Type Mapping for Oracle 10g B.3.3. Retrieving the Underlying Oracle Connection Object B.3.4. Limitations of Oracle 11g B.4. Sybase Expand section "B.4. Sybase" Collapse section "B.4. Sybase" B.4.1. Sybase Limitations B.5. Microsoft SQL Server Expand section "B.5. Microsoft SQL Server" Collapse section "B.5. Microsoft SQL Server" B.5.1. Microsoft JDBC Drivers B.5.2. JSQL Drivers B.5.3. jTDS JDBC Driver B.5.4. "Invalid object name 'JMS_SUBSCRIPTIONS' Exception B.6. MySQL Datasource Expand section "B.6. MySQL Datasource" Collapse section "B.6. MySQL Datasource" B.6.1. Installing the Driver B.6.2. MySQL Local-TX Datasource B.6.3. MySQL Using a Named Pipe B.7. PostgreSQL B.8. Ingres C. Logging Information and Recipes Expand section "C. Logging Information and Recipes" Collapse section "C. Logging Information and Recipes" C.1. Log Level Descriptions C.2. Separate Log Files Per Application C.3. Redirecting Category Output D. Revision History Legal Notice Settings Close Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: 日本語 English Language: 日本語 English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Part V. Appendices Previous Next