JBoss.org Community Documentation

JBoss Application Server 5.0.0

Administration And Development Guide

Authors

JBoss Community

Edited by

JBoss Community

Mar 2008

Abstract

This book is a "Work In Progress" guide to the administration and configuration of the JBoss Application Server 5.

What this Book Covers
About JBoss
1. About Open Source
2. About Professional Open Source
3. Help Contribute
1. Introduction
1.1. JBoss Application Server use cases
1.1.1. What is the difference between the community JBoss Application Server and the JBoss Enterprise Application Platform?
1.2. JBoss Application Server 5 compatibility issues
I. JBoss AS Infrastructure
2. JBoss Application Server 5 architecture
II. JBoss Application Server 5 Configuration
3. Deployment
3.1. Deployable Application Types
3.2. Standard Server Configurations
4. Microcontainer
4.1. An overview of the Microcontainer modules
4.2. Configuration
4.3. References
5. Web Services
5.1. Who needs web services?
5.2. Service Oriented Architecture (SOA)
5.3. What web services are not...
5.4. Jboss Web services Attachment support with XOP (XML-binary Optimized Packaging) and SwA
5.5. Using SwaRef with JAX-WS endpoints
5.6. MTOM/XOP
5.7. Enabling MTOM per endpoint
5.7.1. The MTOM enabled SOAP 1.1 binding ID
5.8. Document/Literal
5.9. Document/Literal (Bare)
5.10. Document/Literal (Wrapped)
5.11. RPC/Literal
5.12. RPC/Encoded
5.13. Web Service Endpoints
5.14. Plain old Java Object (POJO)
5.15. The endpoint as a web application
5.16. Packaging the endpoint
5.17. Accessing the generated WSDL
5.18. EJB3 Stateless Session Bean (SLSB)
5.19. Endpoint Provider
5.20. WebServiceContext
5.21. Web Service Clients
5.21.1. Service
5.21.2. Dynamic Proxy
5.21.3. WebServiceRef
5.21.4. Dispatch
5.21.5. Asynchronous Invocations
5.21.6. Oneway Invocations
5.22. Common API
5.22.1. Handler Framework
5.22.2. Message Context
5.22.3. Fault Handling
5.23. DataBinding
5.23.1. Using JAXB with non annotated classes
5.24. Attachments
5.24.1. MTOM/XOP
5.24.2. SwaRef
5.25. Tools
5.25.1. Bottom-Up (Using wsprovide)
5.25.2. Top-Down (Using wsconsume)
5.25.3. Client Side
5.25.4. Command-line & Ant Task Reference
5.25.5. JAX-WS binding customization
5.26. Web Service Extensions
5.26.1. WS-Addressing
5.26.2. WS-BPEL
5.26.3. WS-Eventing
5.26.4. WS-Security
5.26.5. WS-Transaction
5.26.6. XML Registries
5.26.7. WS-Policy
5.27. JBossWS Extensions
5.27.1. Proprietary Annotations
5.28. Web Services Appendix
5.29. References
6. JBoss5 Virtual Deployment Framework
6.1. MainDeployerImpl
6.2. Current StructureDeployers JBoss5StructureDeployerClasses
6.3. Deployer Helper/Base Classes JBoss5BaseDeployerClasses
6.4. Current Deployers
6.5. Virtual File System JBoss5VirtualFileSystem
7. JBOSS AOP
7.1. Some key terms
7.2. Creating Aspects in JBoss AOP
7.3. Applying Aspects in JBoss AOP
8. JBoss Cache
8.1. What is JBoss Cache?
8.2. And what is Pojo Cache?
8.3. Summary of Features
8.4. Running JBoss Cache in the JBoss Application server
8.5. Pojo Cache Deployment Options
8.5.1. Programatic Deployment
8.5.2. JMX-Based Deployment in JBoss AS (JBoss AS 5.x and 4.x)
8.5.3. Via JBoss Microcontainer (JBoss AS 5.x)
8.6. References:
9. JBoss Transactions
9.1. Why do you need JBoss Transaction
9.2. JBoss Transactions Java EE 5 Support
9.3. JBoss Transactions Web Services Support
9.4. How does JBossTS address these issues?
10. JGroups
10.1. Flexible Protocol Stack
11. Remoting
11.1. Summary of JBoss Remoting Features
11.2. JBoss Remoting Configuration in the JBoss Application Server
12. JBoss Messaging 1.4.1
12.1. Configuring JBoss Messaging
12.1.1. Configuring the SecurityStore
12.1.2. SecurityStore Attributes
12.2. Configuring the ServerPeer
12.3. Server Attributes
12.3.1. ServerPeerID
12.3.2. DefaultQueueJNDIContext
12.3.3. DefaultTopicJNDIContext
12.3.4. PostOffice
12.3.5. DefaultDLQ
12.3.6. DefaultMaxDeliveryAttempts
12.3.7. DefaultExpiryQueue
12.3.8. DefaultRedeliveryDelay
12.3.9. MessageCounterSamplePeriod
12.3.10. FailoverStartTimeout
12.3.11. FailoverCompleteTimeout
12.3.12. DefaultMessageCounterHistoryDayLimit
12.3.13. ClusterPullConnectionFactory
12.3.14. DefaultPreserveOrdering
12.3.15. RecoverDeliveriesTimeout
12.3.16. SuckerPassword
12.3.17. StrictTCK
12.3.18. Destinations
12.3.19. MessageCounters
12.3.20. MessageCountersStatistics
12.3.21. SupportsFailover
12.3.22. PersistenceManager
12.3.23. JMSUserManager
12.3.24. SecurityStore
12.4. MBean operations of the ServerPeer MBean
12.4.1. DeployQueue
12.4.2. UndeployQueue
12.4.3. DestroyQueue
12.4.4. DeployTopic
12.4.5. UndeployTopic
12.4.6. DestroyTopic
12.4.7. ListMessageCountersHTML
12.4.8. ResetAllMesageCounters
12.4.9. ResetAllMesageCounters
12.4.10. EnableMessageCounters
12.4.11. DisableMessageCounters
12.4.12. RetrievePreparedTransactions
12.4.13. ShowPreparedTransactions
III. Clustering Guide
13. Clustering
13.1. Introduction
13.2. Cluster Definition
13.3. HAPartition
13.4. JBoss Cache channels
13.4.1. Service Architectures
13.4.2. Load-Balancing Policies
13.4.3. Farming Deployment
13.4.4. Distributed state replication services
13.5. Clustered JNDI Services
13.5.1. How it works
13.5.2. Client configuration
13.6. Clustered Session EJBs
13.6.1. Stateless Session Bean in EJB 2.x
13.6.2. Stateful Session Bean in EJB 2.x
13.6.3. Stateless Session Bean in EJB 3.0
13.6.4. Stateful Session Beans in EJB 3.0
13.7. Clustered Entity EJBs
13.7.1. Entity Bean in EJB 2.x
13.7.2. Entity Bean in EJB 3.0
13.8. HTTP Services
13.8.1. Configuring load balancing using Apache and mod_jk
13.8.2. Download the software
13.8.3. Configure Apache to load mod_jk
13.8.4. Configure worker nodes in mod_jk
13.8.5. Configuring JBoss to work with mod_jk
13.8.6. Configuring HTTP session state replication
13.8.7. Enabling session replication in your application
13.8.8. Using FIELD level replication
13.8.9. Monitoring session replication
13.8.10. Using Clustered Single Sign On
13.8.11. Clustered Singleton Services
13.9. Clustered JMS Services
13.9.1. High Availability Singleton Fail-over
13.10. JBossCache and JGroups Services
13.10.1. JGroups Configuration
13.10.2. Common Configuration Properties
13.10.3. Transport Protocols
13.10.4. Discovery Protocols
13.10.5. Failure Detection Protocols
13.10.6. Reliable Delivery Protocols
13.10.7. Other Configuration Options
IV. Performance Tuning
14. JBoss AS 5 Performance Tuning
14.1. Introduction
14.2. Instrumentation
14.3. Tuning the JVM
14.4. Tuning JBoss Application Server
14.4.1. Database Connection
14.4.2. Other key configurations
A. Use Alternative Databases with JBoss AS
A.1. How to Use Alternative Databases
A.2. Install JDBC Drivers
A.2.1. Special notes on Sybase
A.3. Creating a DataSource for the External Database
A.4. Change Database for the JMS Services
A.5. Support Foreign Keys in CMP Services
A.6. Specify Database Dialect for Java Persistence API
A.7. Change Other JBoss AS Services to Use the External Database
A.7.1. The Easy Way
A.7.2. The More Flexible Way
A.8. A Special Note About Oracle DataBases