JBoss Admin Development Guide
   Next

JBoss Admin Development Guide

JBoss 3.2.6

Copyright © 2004 JBoss, Inc.

Table of Contents

Forward
About Open Source
About JBoss
1. JBoss: A Full J2EE Implementation with JMX
2. What this Book Covers
1. Installing and Building the JBoss Server
1.1. Getting the Binary Files
1.1.1. Prerequisites
1.1.2. Installing the Binary Package
1.1.2.1. Directory Structure
1.1.3. The Default Server Configuration File Set
1.2. Basic Installation Testing
1.3. Booting from a Network Server
1.4. Building the Server from Source Code
1.4.1. Accessing the JBoss CVS Repositories at SourceForge
1.4.2. Understanding CVS
1.4.3. Anonymous CVS Access
1.4.4. Obtaining a CVS Client
1.4.5. Building the JBoss 3.2.6 Distribution Using the Source Code
1.4.6. Building the JBoss 3.2.6 Distribution Using the CVS Source Code
1.4.7. An Overview of the JBoss CVS Source Tree
1.4.8. Using the JBossTest unit testsuite
2. The JBoss JMX Microkernel
2.1. JMX
2.1.1. An Introduction to JMX
2.1.1.1. Instrumentation Level
2.1.1.2. Agent Level
2.1.1.3. Distributed Services Level
2.1.1.4. JMX Component Overview
2.2. JBoss JMX Implementation Architecture
2.2.1. The JBoss ClassLoader Architecture
2.2.2. Class Loading and Types in Java
2.2.2.1. ClassCastExceptions - I'm Not Your Type
2.2.2.2. IllegalAccessException - Doing what you should not
2.2.2.3. LinkageErrors - Making Sure You Are Who You Say You Are
2.2.2.4. Inside the JBoss Class Loading Architecture
2.2.3. JBoss XMBeans
2.2.3.1. Descriptors
2.2.3.2. The Management Class
2.2.3.3. The Constructors
2.2.3.4. The Attributes
2.2.3.5. The Operations
2.2.3.6. Notifications
2.3. Connecting to the JMX Server
2.3.1. Inspecting the Server - the JMX Console Web Application
2.3.1.1. Securing the JMX Console
2.3.2. Connecting to JMX Using RMI
2.3.3. Command Line Access to JMX
2.3.3.1. Connecting twiddle to a Remote Server
2.3.3.2. Sample twiddle Command Usage
2.3.4. Connecting to JMX Using Any Protocol
2.4. Using JMX as a Microkernel
2.4.1. The Startup Process
2.4.2. JBoss MBean Services
2.4.2.1. The SARDeployer MBean
2.4.2.2. The Service Life Cycle Interface
2.4.2.3. The ServiceController MBean
2.4.2.4. Specifying Service Dependencies
2.4.2.5. Identitifying Unsatisfied Dependencies
2.4.2.6. Hot Deployment of Components, the URLDeploymentScanner
2.4.3. Writing JBoss MBean Services
2.4.3.1. A Standard MBean Example
2.4.3.2. XMBean Examples
2.4.4. Deployment Ordering and Dependencies
2.5. JBoss Deployer Architecture
2.5.1. Deployers and ClassLoaders
2.6. Exposing MBean Events via SNMP
2.6.1. The SNMP Adaptor Service
2.6.2. The Event to Trap Service
2.7. Remote Access to Services, Detached Invokers
2.7.1. A Detached Invoker Example, the MBeanServer Invoker Adaptor Service
2.7.2. Detached Invoker Reference
2.7.2.1. The JRMPInvoker - RMI/JRMP Transport
2.7.2.2. The PooledInvoker - RMI/Socket Transport
2.7.2.3. The IIOPInvoker - RMI/IIOP Transport
2.7.2.4. The JRMPProxyFactory Service - Building Dynamic JRMP Proxies
2.7.2.5. The HttpInvoker - RMI/HTTP Transport
2.7.2.6. The HA JRMPInvoker - Clustered RMI/JRMP Transport
2.7.2.7. The HA HttpInvoker - Clustered RMI/HTTP Transport
2.7.2.8. HttpProxyFactory - Building Dynamic HTTP Proxies
2.7.2.9. Steps to Expose Any RMI Interface via HTTP
3. Naming on JBoss
3.1. An Overview of JNDI
3.1.1. The JNDI API
3.1.1.1. Names
3.1.1.2. Contexts
3.1.2. J2EE and JNDI - The Application Component Environment
3.1.2.1. ENC Usage Conventions
3.2. The JBossNS Architecture
3.2.1. The Naming InitialContext Factories
3.2.1.1. Naming Discovery in Clustered Environments
3.2.1.2. The HTTP InitialContext Factory Implementation
3.2.1.3. The Login InitialContext Factory Implementation
3.2.2. Accessing JNDI over HTTP
3.2.3. Accessing JNDI over HTTPS
3.2.4. Securing Access to JNDI over HTTP
3.2.5. Securing Access to JNDI with a Read-Only Unsecured Context
3.2.6. Additional Naming MBeans
3.2.6.1. org.jboss.naming.ExternalContext MBean
3.2.6.2. The org.jboss.naming.NamingAlias MBean
3.2.6.3. The org.jboss.naming.JNDIView MBean
4. Transactions on JBoss
4.1. Transaction/JTA Overview
4.1.1. Pessimistic and optimistic locking
4.1.2. The components of a distributed transaction
4.1.3. The two-phase XA protocol
4.1.4. Heuristic exceptions
4.1.5. Transaction IDs and branches
4.2. JBoss Transaction Internals
4.2.1. Adapting a Transaction Manager to JBoss
4.2.2. The Default Transaction Manager
4.2.2.1. org.jboss.tm.XidFactory
4.2.3. UserTransaction Support
5. EJBs on JBoss
5.1. The EJB Client Side View
5.1.1. Specifying the EJB Proxy Configuration
5.2. The EJB Server Side View
5.2.1. Detached Invokers - The Transport Middlemen
5.2.2. The HA JRMPInvoker - Clustered RMI/JRMP Transport
5.2.3. The HA HttpInvoker - Clustered RMI/HTTP Transport
5.3. The EJB Container
5.3.1. EJBDeployer MBean
5.3.1.1. Verifying EJB deployments
5.3.1.2. Deploying EJBs Into Containers
5.3.1.3. Container configuration information
5.3.2. Container Plug-in Framework
5.3.2.1. org.jboss.ejb.ContainerPlugin
5.3.2.2. org.jboss.ejb.Interceptor
5.3.2.3. org.jboss.ejb.InstancePool
5.3.2.4. org.jboss.ebj.InstanceCache
5.3.2.5. org.jboss.ejb.EntityPersistenceManager
5.3.2.6. org.jboss.ejb.StatefulSessionPersistenceManager
5.4. Entity Bean Locking and Deadlock Detection
5.4.1. Why JBoss Needs Locking
5.4.2. Entity Bean Lifecycle
5.4.3. Default Locking Behavior
5.4.4. Pluggable Interceptors and Locking Policy
5.4.5. Deadlock
5.4.5.1. Dedlock Detection
5.4.5.2. Catching ApplicationDeadlockException
5.4.5.3. Viewing Lock Information
5.4.6. Advanced Configurations and Optimizations
5.4.6.1. Short-lived Transactions
5.4.6.2. Ordered Access
5.4.6.3. Read-Only Beans
5.4.6.4. Explicitly Defining Read-Only Methods
5.4.6.5. Instance Per Transaction Policy
5.4.7. Running Within a Cluster
5.4.8. Troubleshooting
5.4.8.1. Locking Behavior Not Working
5.4.8.2. IllegalStateException
5.4.8.3. Hangs and Transaction Timeouts
6. Messaging on JBoss
6.1. JMS Examples
6.1.1. A Point-To-Point Example
6.1.2. A Pub-Sub Example
6.1.3. A Pub-Sub With Durable Topic Example
6.1.4. A Point-To-Point With MDB Example
6.2. JBoss Messaging Overview
6.2.1. Invocation Layer
6.2.1.1. RMI IL (deprecated)
6.2.1.2. OIL IL (deprecated)
6.2.1.3. UIL IL (deprecated)
6.2.1.4. UIL2 IL
6.2.1.5. JVM IL
6.2.1.6. HTTP IL
6.2.2. Security Manager
6.2.3. Destination Manager
6.2.4. Message Cache
6.2.5. State Manager
6.2.6. Persistence Manager
6.2.6.1. File PM
6.2.6.2. Rolling Logged PM
6.2.6.3. JDBC2 PM
6.2.7. Destinations
6.2.7.1. Queues
6.2.7.2. Topics
6.3. JBoss Messaging Configuration and MBeans
6.3.1. org.jboss.mq.il.jvm.JVMServerILService
6.3.2. org.jboss.mq.il.rmi.RMIServerILService (deprecated)
6.3.3. org.jboss.mq.il.oil.OILServerILService (deprecated)
6.3.4. org.jboss.mq.il.uil.UILServerILService (deprecated)
6.3.5. org.jboss.mq.il.uil2.UILServerILService
6.3.5.1. Configuring ILs for SSL
6.3.5.2. JMS client properties for the UIL2 transport
6.3.6. org.jboss.mq.il.http.HTTPServerILService
6.3.7. org.jboss.mq.server.jmx.Invoker
6.3.8. org.jboss.mq.server.jmx.InterceptorLoader
6.3.9. org.jboss.mq.sm.file.DynamicStateManager
6.3.10. org.jboss.mq.security.SecurityManager
6.3.11. org.jboss.mq.server.jmx.DestinationManager
6.3.12. org.jboss.mq.server.MessageCache
6.3.13. org.jboss.mq.pm.file.CacheStore
6.3.14. org.jboss.mq.pm.file.PersistenceManager
6.3.15. org.jboss.mq.pm.rollinglogged.PersistenceManager
6.3.16. org.jboss.mq.pm.jdbc2.PersistenceManager
6.3.17. Destination MBeans
6.3.17.1. org.jboss.mq.server.jmx.Queue
6.3.17.2. org.jboss.mq.server.jmx.Topic
6.3.18. Administration Via JMX
6.3.18.1. Creating Queues At Runtime
6.3.18.2. Creating Topics At Runtime
6.3.18.3. Managing a JBossMQ User IDs at Runtime
6.4. Specifying the MDB JMS Provider
6.4.1. org.jboss.jms.jndi.JMSProviderLoader MBean
6.4.2. org.jboss.jms.asf.ServerSessionPoolLoader MBean
6.4.3. Integrating non-JBoss JMS Providers
7. Connectors on JBoss
7.1. JCA Overview
7.2. An Overview of the JBossCX Architecture
7.2.1. BaseConnectionManager2 MBean
7.2.2. RARDeployment MBean
7.2.3. JBossManagedConnectionPool MBean
7.2.4. CachedConnectionManager MBean
7.2.5. A Sample Skeleton JCA Resource Adaptor
7.3. Configuring JCA Adaptors
7.3.1. Configuring JDBC DataSources
7.3.2. Configuring Generic JCA Adaptors
7.3.3. Sample Configurations
8. Security on JBoss
8.1. J2EE Declarative Security Overview
8.1.1. Security References
8.1.2. Security Identity
8.1.3. Security roles
8.1.4. EJB method permissions
8.1.5. Web Content Security Constraints
8.1.6. Enabling Declarative Security in JBoss
8.2. An Introduction to JAAS
8.2.1. What is JAAS?
8.2.1.1. The JAAS Core Classes
8.3. The JBoss Security Model
8.3.1. Enabling Declarative Security in JBoss Revisited
8.4. The JBoss Security Extension Architecture
8.4.1. How the JaasSecurityManager Uses JAAS
8.4.2. The JaasSecurityManagerService MBean
8.4.3. The JaasSecurityDomain MBean
8.4.4. An XML JAAS Login Configuration MBean
8.4.5. The JAAS Login Configuration Management MBean
8.4.6. Using and Writing JBossSX Login Modules
8.4.6.1. org.jboss.security.auth.spi.IdentityLoginModule
8.4.6.2. org.jboss.security.auth.spi.UsersRolesLoginModule
8.4.6.3. org.jboss.security.auth.spi.LdapLoginModule
8.4.6.4. org.jboss.security.auth.spi.DatabaseServerLoginModule
8.4.6.5. BaseCertLoginModule
8.4.6.6. org.jboss.security.auth.spi.ProxyLoginModule
8.4.6.7. org.jboss.security.auth.spi.RunAsLoginModule
8.4.6.8. org.jboss.security.ClientLoginModule
8.4.7. Writing Custom Login Modules
8.4.7.1. Support for the Subject Usage Pattern
8.4.7.2. A Custom LoginModule Example
8.4.8. The DynamicLoginConfig service
8.5. The Secure Remote Password (SRP) Protocol
8.5.1. Providing Password Information for SRP
8.5.2. Inside of the SRP algorithm
8.5.2.1. An SRP example
8.6. Running JBoss with a Java 2 security manager
8.7. Using SSL with JBoss using JSSE
8.8. Configuring JBoss for use Behind a Firewall
8.9. How to Secure the JBoss Server
8.9.1. The jmx-console.war
8.9.2. The web-console.war
8.9.3. The http-invoker.sar
8.9.4. The jmx-invoker-adaptor-server.sar
9. Integrating Servlet Containers
9.1. The AbstractWebContainer Class
9.1.1. The AbstractWebContainer Contract
9.1.2. Creating an AbstractWebContainer Subclass
9.1.2.1. Use the Thread Context Class Loader
9.1.2.2. Integrate Logging Using log4j
9.1.2.3. Delegate web container authentication and authorization to JBossSX
9.2. JBoss/Tomcat-5 bundle notes
9.2.1. The Tomcat server.xml file
9.2.1.1. Connector
9.2.1.2. Engine
9.2.1.3. Host
9.2.1.4. DefaultContext
9.2.1.5. Logger
9.2.1.6. Valve
9.2.2. Using SSL with the JBoss/Tomcat bundle
9.2.3. Setting up Virtual Hosts
9.2.4. Serving Static Content
9.2.5. Using Apache with the Tomcat
9.2.6. Using Clustering
10. MBean Services Miscellany
10.1. System Properties Management
10.2. Property Editor Management
10.3. Services Binding Management
10.3.1. Running Two JBoss Instances
10.4. Scheduling Tasks
10.4.1. org.jboss.varia.scheduler.Scheduler
10.5. The JBoss Logging Framework
10.5.1. org.jboss.logging.Log4jService
10.6. RMI Dynamic Class Loading
10.6.1. org.jboss.web.WebService
11. The CMP Engine
11.1. Getting Started
11.1.1. Example Code
11.1.2. Tests
11.1.3. Read-ahead
11.2. The jbosscmp-jdbc Structure
11.3. Entity Beans
11.3.1. Entity Mapping
11.4. CMP-Fields
11.4.1. CMP-Field Abstract Accessors
11.4.2. CMP-Field Declaration
11.4.3. CMP-Field Column Mapping
11.4.4. Read-only Fields
11.4.5. Auditing Entity Access
11.4.6. Dependent Value Classes (DVCs)
11.5. Container Managed Relationships
11.5.1. CMR-Field Abstract Accessors
11.5.2. Relationship Declaration
11.5.3. Relationship Mapping
11.5.3.1. Relationship Role Mapping
11.5.3.2. Foreign Key Mapping
11.5.3.3. Relation-table Mapping
11.6. Queries
11.6.1. Finder and ejbSelect Declaration
11.6.2. EJB-QL Declaration
11.6.3. Overriding the EJB-QL to SQL Mapping
11.6.4. JBossQL
11.6.5. DynamicQL
11.6.6. DeclaredSQL
11.6.6.1. Parameters
11.6.7. EJBQL 2.1 and SQL92 queries
11.6.8. BMP Custom Finders
11.7. Optimized Loading
11.7.1. Loading Scenario
11.7.2. Load Groups
11.7.3. Read-ahead
11.7.3.1. on-find
11.7.3.2. on-load
11.7.3.3. none
11.8. Loading Process
11.8.1. Commit Options
11.8.2. Eager-loading Process
11.8.3. Lazy loading Process
11.8.3.1. Relationships
11.8.4. Lazy loading result sets
11.9. Transactions
11.10. Optimistic Locking
11.11. Entity Commands and Primary Key Generation
11.11.1. Existing Entity Commands
11.12. Defaults
11.12.1. A sample jbosscmp-jdbc.xml defaults declaration
11.13. Datasource Customization
11.13.1. Function Mapping
11.13.2. Type Mapping
11.13.3. User Type Mappings
A. The JBoss Group and Our LGPL License
A.1. About The JBoss Group
A.2. The GNU Lesser General Public License (LGPL)
B. Book Example Installation
   Next
   Forward