Sun logo      Previous      Contents      Next     

Sun Java System Application Server Enterprise Edition 8.1 Administration Guide 2005Q1


Who Should Use This Book
Before You Read This Book
How This Book Is Organized
Conventions Used in This Book
Typographic Conventions
Default Paths and File Names
Shell Prompts
Related Documentation
Books in This Documentation Set
Other Server Documentation
Accessing Sun Resources Online
Contacting Sun Technical Support
Related Third-Party Web Site References
Sun Welcomes Your Comments

Chapter 1   Getting Started
About the Sun Java System Application Server
What is the Application Server?
Application Server Architecture
Access to External Systems
Admin Console
asadmin Utility
Application Server Management Extension (AMX)
Application Server Configuration
Configuring the Application Server
Configuring Domains
Creating a Domain
Deleting a Domain
Listing Domains
Starting the Domain
On Windows, to start the default domain:
Restarting the Server or Domain
Stopping the Domain
To stop the domain using the Admin Console:
On Windows, to stop the default domain:
Recreating the Domain Administration Server
Steps for DAS Migration
Application Server Instances
About Application Server Instances
Defining Application Server Instances
About Stand-Alone Instances
Viewing General Server Information
Managing Applications
Managing Resources
Administration Server Advanced Settings
Setting Applications Configurations
Setting the auto deploy
Setting Additional Properties
Setting Domain Attributes
Instance Specific Configuration Properties
Adding or Deleting Instance Properties
Creating an Instance
Starting an Instance
Recovering Transactions
Stopping an Instance
Shutting Down the Server Instance
Configuration Changes
Changing Application Server Configuration
Ports in the Application Server
Viewing Port Numbers
Changing the Administrative Server Port
Changing an HTTP Port
Changing an IIOP Port
Configuring a JMX Connector Using the Admin Service
Editing the JMX Connector Configuration
Changing the J2SE Software
Using Online Help
Further Information

Chapter 2   Configuring Clusters
About Clusters
What is a Cluster?
Cluster Types
Clusters, Instances, Load Balancers, and Sessions
Admin Console Tasks for Clusters
Creating a Cluster
Configuring a Cluster
Migrating EJB Timers
Creating Server Instances for a Cluster
Configuring Clustered Server Instances
Configuring Applications for a Cluster
Configuring Resources for a Cluster
Deleting a Cluster
Using Multiple Clusters for Online Upgrades Without Loss of Service

Chapter 3   Configuring Load Balancing and Failover
About HTTP Load Balancing and Failover
HTTP Load Balancing and Failover
Requirements for HTTP Load Balancing
Understanding Assigned Requests and Unassigned Requests
HTTP Load Balancing Algorithm
About the Sticky Round Robin Load Balancing Algorithm
Load Balancing and Failover Sample Applications
Overview of HTTP Load Balancing Set-up
Configuring Web Servers for HTTP Load Balancing
About Web Server Configuration
Modifications to Sun Java System Web Server
Modifications to Apache Web Server
Modifications Made by the Installer
Modifications After Installation
Additional Modifications on Microsoft Windows
Modifications to Microsoft IIS
Configuring Multiple Web Server Instances
HTTP Load Balancer Configuration Tasks
Creating an HTTP Load Balancer Configuration
Creating an HTTP Load Balancer Reference
Enabling Server Instances for Load Balancing
Enabling Applications for Load Balancing
Creating the HTTP Health Checker
Creating a Health Checker
Additional Health Check Properties for Healthy Instances
Exporting the Load Balancer Configuration File
Changing the HTTP Load Balancer Configuration
Enabling Dynamic Reconfiguration
Disabling (Quiescing) a Server Instance or Cluster
Disabling (Quiescing) an Application
Configuring HTTP and HTTPS Session Failover
About HTTPS Routing
Configuring HTTPS Routing
Known Issues in Load Balancing HTTP/HTTPS Requests
Configuring Idempotent URLs
Configuring HTML Error Pages
Monitoring the HTTP Load Balancer Plug-in
Configuring Log Messages
Types of Log Messages
Load Balancer Configurator Log Messages
Request Dispatch and Runtime Log Messages
Configurator Error Messages
Configuring Monitoring
Understanding Monitoring Messages
Upgrading an Application
About Rolling Upgrades
Upgrading In a Single Stand-alone Cluster
Upgrading in Two Clusters
About RMI-IIOP Load Balancing and Failover
Requirements for RMI-IIOP Load Balancing and Failover
RMI-IIOP Load Balancing and Failover Algorithm
RMI-IIOP Sample Application

Chapter 4   Configuring Node Agents
About Node Agents
Node Agents
Automatically Created Node Agent
Node Agents and Server Instance Management
Additional Node Agents
Node Agent Placeholders
Deploying Node Agents
Before Deploying Node Agents
Online Deployment
Offline Deployment
Node Agent and Domain Administration Server Synchronization
Node Agent Synchronization
Server Instance Synchronization
Synchronizing Large Applications
Viewing Node Agent Logs
Tasks Available through the Admin Console and asadmin Tool
Admin Console Tasks for Node Agents
Viewing General Node Agent Information
Creating a Node Agent Placeholder
Deleting a Node Agent Configuration
Editing a Node Agent Configuration
Editing a Node Agent Realm
Editing the Node Agent’s Listener for JMX
Tasks for Node Agents in asadmin Tool
Creating a Node Agent
Starting a Node Agent
Stopping a Node Agent
Deleting a Node Agent

Chapter 5   Deploying Applications
About Deployment
The Deployment Life Cycle
Types of J2EE Archive Files
Naming Conventions
Admin Console Tasks for Deploying Applications
Deploying an Enterprise Application
Deploying a Web Application
Launching a Deployed Web Application
Deploying an EJB Module
Deploying a Connector Module
Creating a Lifecycle Module
Deploying an Application Client Module
Admin Console Tasks for Listing, Undeploying, and Enabling Applications
Listing Deployed Applications
Listing Subcomponents
Viewing Module Descriptors of Deployed Applications
Undeploying an Application
Enabling and Disabling an Application
Managing Application Targets
Deploying on Additional Virtual Servers
Redeploying to Multiple Targets
Development Environment
Production Environment
Enabling and Disabling Dynamic Reloading
Deployment Methods for Developers
Using Auto Deploy
Deploying an Unpackaged Application From a Directory
Using the deploytool Utility
Using a Deployment Plan

Chapter 6   JDBC Resources
About JDBC Resources
JDBC Resources
JDBC Connection Pools
How JDBC Resources and Connection Pools Work Together
Setting Up Database Access
General Steps for Setting Up Database Access
Integrating a JDBC Driver
About JDBC Connection Pools
Creating a JDBC Connection Pool
Editing a JDBC Connection Pool
General Settings
Pool Settings
Connection Validation
Transaction Isolation
Verifying Connection Pool Settings
Deleting a JDBC Connection Pool
About JDBC Resources
Creating a JDBC Resource
Editing a JDBC Resource
Deleting a JDBC Resource
Enabling and Disabling a JDBC Resource
About Persistence Manager Resources
Creating a Persistence Manager Resource
Editing a Persistence Manager Resource
Managing Resource Targets
Deleting a Persistence Manager Resource
Enabling and Disabling a Persistence Manager Resource

Chapter 7   Configuring Availability and Session Persistence
About Availability and Session Persistence
Why Session Persistence Is Needed
Overview of Session Persistence Configuration
Levels of Availability
Availability of Single Sign-on in the HTTP Session State
Sample Applications
Admin Console Tasks for Configuring Availability
Configuring the SFSB Session Store When Availability Is Disabled
Configuring Availability at the Server Instance Level
Configuring Availability at the Web Container Level
Configuring Availability at the EJB Container Level

Chapter 8   Configuring Java Message Service Resources
About JMS Resources
The JMS Provider in the Application Server
JMS Resources
The Relationship Between JMS Resources and Connector Resources
Admin Console Tasks for JMS Connection Factories
Creating a JMS Connection Factory Resource
Editing a JMS Connection Factory Resource
Deleting a JMS Connection Factory Resource
Admin Console Tasks for JMS Destination Resources
Creating a JMS Destination Resource
Editing a JMS Destination Resource
Deleting a JMS Destination Resource
Admin Console Tasks for JMS Physical Destinations
Creating a JMS Physical Destination
Deleting a JMS Physical Destination
Admin Console Tasks for the JMS Provider
Configuring General Properties for the JMS Provider
Creating a JMS Host
Editing a JMS Host
Deleting a JMS Host

Chapter 9   Configuring JavaMail Resources
About JavaMail
The JavaMail API
Admin Console Tasks for JavaMail
Creating a JavaMail Session
Editing a JavaMail Session
Deleting a JavaMail Session

Chapter 10   JNDI Resources
About Java Naming and Directory Interface (JNDI)
JNDI Names and Resources
J2EE Naming Services
Naming References and Binding Information
About Custom Resources
Using Custom Resources
Creating Custom Resources
Editing Custom Resources
Deleting Custom Resources
Listing Custom Resources
About External JNDI Repositories and Resources
Using External JNDI Repositories and Resources
Creating External Resources
Editing External Resources
Deleting External Resources
Listing External Resources

Chapter 11   Connector Resources
About Connectors
Connector Modules, Connection Pools, and Resources
Admin Console Tasks for Connector Connection Pools
General Steps for Setting Up EIS Access
Creating a Connector Connection Pool
Editing a Connector Connection Pool
Deleting a Connector Connection Pool
Admin Console Tasks for Connector Resources
Creating a Connector Resource
Editing a Connector Resource
Deleting a Connector Resource
Configuring a Connector Service
Admin Console Tasks for Administered Object Resources
Creating an Administered Object Resource
Editing an Administered Object Resource
Deleting an Administered Object Resource

Chapter 12   Managing Named Configurations
About Named Configurations
Named Configurations
The default-config Configuration
Configurations Created when Creating Instances or Clusters
Unique Port Numbers and Configurations
Admin Console Tasks for Named Configurations
Creating a Named Configuration
Editing a Named Configuration’s Properties
Editing Port Numbers for Instances Referencing a Configuration
Viewing a Named Configuration’s Targets
Deleting a Named Configuration

Chapter 13   J2EE Containers
About the J2EE Containers
Types of J2EE Containers
The Web Container
The EJB Container
Admin Console Tasks for the J2EE Containers
Configuring the General Web Container Settings
Configuring Web Container Sessions
Configuring the Manager Properties
Configuring the Store Properties
Configuring the General EJB Settings
Session Store Location
Pool Settings
Cache Settings
Configuring the Message-Driven Bean Settings
Configuring the EJB Timer Service Settings
Configuring the Timer Service
Using an External Database with the Timer Service

Chapter 14   Configuring Security
About Application Server Security
Overview of Security
Understanding Application and System Security
Tools for Managing Security
Managing Security of Passwords
Assigning Security Responsibilities
About Authentication and Authorization
Authenticating Entities
Authorizing Users
Specifying JACC Providers
Auditing Authentication and Authorization Decisions
Configuring Message Security
Understanding Users, Groups, Roles, and Realms
Introduction to Certificates and SSL
About Digital Certificates
About Secure Sockets Layer
About Firewalls
Managing Security With the Admin Console
Server Security Settings
Realms and file Realm Users
JACC Providers
Audit Modules
Message Security
HTTP and IIOP Listener Security
Admin Service Security
Security Maps
Admin Console Tasks for Security
Configuring Security Settings
Controlling Access to Administration Tools
Admin Console Tasks for Realms
Creating a Realm
Creating an ldap Realm
Creating the solaris Realm
Creating a Custom Realm
Editing a Realm
Editing the file and admin-realm Realms
Managing Users with Network Security Services (NSS)
Managing file Realm Users
Editing the certificate Realm
Configuring Mutual Authentication
Deleting a Realm
Setting the Default Realm
Admin Console Tasks for JACC Providers
Creating a JACC Provider
Editing a JACC Provider
Deleting a JACC Provider
Setting the Active JACC Provider
Admin Console Tasks for Audit Modules
Creating an Audit Module
Editing an Audit Module
Deleting an Audit Module
Enabling and Disabling Audit Logging
Setting the Active Audit Module
Using the Default Audit Module
Admin Console Tasks for Listeners and JMX Connectors
Configuring Security for HTTP Listeners
Configuring Security for IIOP Listeners
Configuring Security for the Admin Service’s JMX Connector
Setting Listener Security Properties
Admin Console Security Tasks for Virtual Servers
Configuring Single Sign-On (SSO)
Admin Console Tasks for Connector Connection Pools
About Connector Connection Pools
About Security Maps
Creating a Security Map
Editing a Security Map
Deleting a Security Map
Working with Certificates and SSL
About Certificate Files
Changing the Location of Certificate Files
About the Keytool Utility
About the CertUtil Utility
Generating a Server Certificate
Signing a Digital Certificate
Using a Certificate From a CA
Deleting a Certificate
Further Information

Chapter 15   Configuring Message Security
About Message Security
Overview of Message Security
Understanding Message Security in the Application Server
Assigning Message Security Responsibilities
About Security Tokens and Security Mechanisms
Glossary of Message Security Terminology
Securing a Web Service
Configuring Application-Specific Web Services Security
Securing the Sample Application
Configuring the Application Server for Message Security
Configuring a JCE Provider
Admin Console Tasks for Message Security
Enabling Providers for Message Security
Configuring a Message Security Provider
Creating a Message Security Provider
Actions of Request and Response Policy Configurations
Deleting a Message Security Configuration
Deleting a Message Security Provider
Enabling Message Security for Client Applications
Setting the Request and Response Policy for the Application Client Configuration
Further Information

Chapter 16   Transactions
About Transactions
What is a Transaction?
Transactions in J2EE Technology
Admin Console Tasks for Transactions
Configuring Transactions
Transaction Recovery
Transaction Timeouts
Transaction Logging

Chapter 17   Configuring the HTTP Service
About the HTTP Service
What Is the HTTP Service?
Virtual Servers
HTTP Listeners
Admin Console Tasks for the HTTP Service
Configuring the HTTP Service
Configuring the HTTP Service Access Log
Configuring HTTP Service Request Processing Threads
Configuring the HTTP Service Keep-Alive Subsystem
Configuring the HTTP Service Connection Pool
Configuring the HTTP Protocol for the HTTP Service
Configuring the HTTP File Cache for the HTTP Service
Admin Console Tasks for Virtual Servers
Creating a Virtual Server
Editing a Virtual Server
Deleting a Virtual Server
Admin Console Tasks for HTTP Listeners
Creating an HTTP Listener
Editing an HTTP Listener
Deleting an HTTP Listener

Chapter 18   Configuring the Object Request Broker
About the Object Request Broker
What is the ORB?
IIOP Listeners
Admin Console Tasks for the ORB
Configuring the ORB
Admin Console Tasks for IIOP Listeners
Creating an IIOP Listener
Editing an IIOP Listener
Deleting an IIOP Listener

Chapter 19   Thread Pools
About Thread Pools
Thread Pools in the Application Server
Admin Console Tasks for Thread Pools
Creating Thread Pools
Editing Thread Pools
Deleting Thread Pools

Chapter 20   Configuring Logging
About Logging
Log Records
The Logger Namespace Hierarchy
Admin Console Tasks for Logging
Configuring General Logging Settings
Configuring Log Levels
Viewing the Server Log

Chapter 21   Monitoring Components and Services
About Monitoring
Monitoring in the Application Server
Overview of Monitoring
About the Tree Structure of Monitorable Objects
The Applications Tree
The HTTP Service Tree
The Resources Tree
The Connector Service Tree
The JMS Service Tree
The ORB Tree
The Thread Pool Tree
About Statistics for Monitored Components and Services
EJB Container Statistics
Web Container Statistics
HTTP Service Statistics
JDBC Connection Pools Statistics
JMS/Connector Service Statistics
Statistics for Connection Managers in an ORB
Thread Pools Statistics
Transaction Service Statistics
Java Virtual Machine (JVM) Statistics
Production Web Container (PWC) Statistics
Admin Console Tasks for Enabling and Disabling Monitoring
Configuring Monitoring Levels Using the Admin Console
Configuring Monitoring Using the asadmin Tool
Admin Console Tasks for Viewing Monitoring Data
Viewing Monitoring Data in the Admin Console
Viewing Monitoring Data With the asadmin Tool
Using the asadmin Tool to View Monitoring Data
Understanding and Specifying Dotted Names
Examples of the list and get Commands
Petstore Example
Expected Output for list and get Commands at All Levels
Using JConsole

Chapter 22   Java Virtual Machine and Advanced Settings
Admin Console Tasks for JVM™ Settings
Configuring the JVM General Settings
Configuring the JVM Classpath Settings
Configuring the JVM Options
Disabling the Security Manager
Configuring the JVM Profiler Settings
Admin Console Tasks for Advanced Settings
Setting the Advanced Domain Attributes

Appendix A   Compiling and Configuring Apache Web Server
Minimum Requirements
Minimum Requirements for Apache 1.3
Minimum Requirements for Apache 2
Installing SSL-aware Apache
Compiling and Building OpenSSL
Configuring Apache with mod_ssl
Compiling and Building Apache
Compiling and Building Apache 1.3
Compiling and Building Apache 2
Starting and Stopping Apache

Appendix B   Automatically Restarting a Domain or Node Agent
Restarting Automatically on UNIX Platforms
Restarting Automatically on the Microsoft Windows Platform
Security for Automatic Restarts

Appendix C   Dotted Name Attributes for domain.xml
Top Level Elements
Elements Not Aliased

Previous      Contents      Next     

Copyright 2004 - 2005 Sun Microsystems, Inc. All rights reserved.