Sun Java System Application Server 8.1: Administration & Deployment

Transcription

1 Sun Java System Application Server 8.1: Administration & Deployment Student Guide - Volume I IAS-4444 Rev A D62040GC10 Edition 1.0 D63846

2 Copyright 2006, 2009, Oracle and/or its affiliates. All rights reserved. Disclaimer This document contains proprietary information, is provided under a license agreement containing restrictions on use and disclosure, and is protected by copyright and other intellectual property laws. You may copy and print this document solely for your own use in an Oracle training course. The document may not be modified or altered in any way. Except as expressly permitted in your license agreement or allowed by law, you may not use, share, download, upload, copy, print, display, perform, reproduce, publish, license, post, transmit, or distribute this document in whole or in part without the express authorization of Oracle. The information contained in this document is subject to change without notice. If you find any problems in the document, please report them in writing to: Oracle University, 500 Oracle Parkway, Redwood Shores, California USA. This document is not warranted to be error-free. Sun Microsystems, Inc. Disclaimer This training manual may include references to materials, offerings, or products that were previously offered by Sun Microsystems, Inc. Certain materials, offerings, services, or products may no longer be offered or provided.oracle and its affiliates cannot be held responsible for any such references should they appear in the text provided. Restricted Rights Notice If this documentation is delivered to the U.S. Government or anyone using the documentation on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS The U.S. Government s rights to use, modify, reproduce, release, perform, display, or disclose these training materials are restricted by the terms of the applicable Oracle license agreement and/or the applicable U.S. Government contract. Trademark Notice Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd.

3 This page intentionally left blank.

4 This page intentionally left blank.

5 Table of Contents About This Course...Preface-xvii Course Goals... Preface-xvii Product Names... Preface-xviii Course Map... Preface-xix Topics Not Covered... Preface-xx How Prepared Are You?... Preface-xxi Introductions...Preface-xxii How to Use Course Materials...Preface-xxiii Conventions...Preface-xxiv Icons...Preface-xxiv Typographical Conventions... Preface-xxv Additional Conventions...Preface-xxvi Introducing Application Server SE/EE Objectives Relevance Additional Resources Overview of Application Server Application Server 8.1 Editions Supported Features Comparison Sun Java Enterprise System Suites Sun Java Application Platform Suite Application Server Key Concepts Web Architecture With Load Balancing Clustering Failover Failover With HADB Application Server HA Architecture Application Server SE/EE 8.1 Features Key HA Features Developer Productivity Support Tools Provided With Application Server v

6 Management Architecture Objectives Additional Resources Introducing the Components and Concepts of Application Server SE/EE Administrative Domains in Application Server Server Instances Cluster Configuration Configuration Types Applications and Resources References Entity Relationships Sample Cluster Configuration One Sample Cluster Configuration Two Sample Configuration Three Management Architecture Main Components DAS Central Repository Central Repository Directory Structure Local Repository Cache Node Agent Node Agent, Server Instance, and DAS Multi-Domain Management Architecture Synchronization Node Agent Synchronization At Create Time Node Agent Synchronization At Start Time Server Instance Synchronization JMX API MBeans JMX Connectors Installing Application Server SE/EE Objectives Relevance Additional Resources Key Features of the Application Server SE/EE 8.1 Installation Supported Installation Features Matrix Product Components PointBase and Application Server 8.1 Configuration Supported Platforms for Installation Support for JDBC API Drivers Support for Databases Support for Web Servers Configuration Considerations vi Sun Java System Application Server SE/EE Q2: Administration and Deployment

7 Application Server SE/EE 8.1 System Requirements HADB Platforms and System Requirements Installation Modes Directory Structure and File Layout Installation Root Directory Structure DAS Directory Structure Node Agent Directory Structure Server Instance Directory Structure Installation Log Files Sample Applications Configuration and Administration Objectives Additional Resources Administration Infrastructure Domain Configuration Primary Domain Configuration Files Named Configuration The domain.xml File Structure Referencing Elements The domain.xml Reference Example Properties in the domain.xml File Server Instance Specialization Port Specialization Port Specialization Example Configuring Specialized Ports Dynamic Reconfiguration Dynamic Reconfigured Changes Administration Tools The asadmin Utility Local asadmin Commands The asadmin Utility Domain Commands Target Option The Admin Console Features of the Admin Console GUI Configuring Cluster Node Agent Configuration Modes Node Agent Placeholder Online Node Agent Offline Node Agent The asadmin CLI Node Agent Commands GUI Creating Node Agent Placeholder Domain Backup and Restore Principles of Operation Overview of Administrative Security Transport Security vii

8 The asadmin Utility Password Security Master Password Password Encryption Deployment Objectives Relevance Additional Resources Key Deployment Features J2EE Technology Deployment API Architecture Deployment Targets Deployment Life Cycle Initial Deployment Enabling and Disabling Adding and Deleting Targets Redeployment Undeployment Other Deployment Features Deployment Methods Deploying an Enterprise Application Auto Deploy Configuring Auto Deploy Directory Deployment DeployTool Deployment Feature Comparison HTTP Load Balancing Objectives Relevance Additional Resources Application Server Load Balancing Load Balancing Methods Sticky Round-Robin Load Balancing Dynamic Load Balancing Features of the Application Server s Load Balancer Health Check Mechanism Quiescing Idempotent URL Retries Configurable Error Pages Principles of Load Balancing Load Balancer Installation HTTP Load Balancer Configuration Creating an HTTP Load Balancer Configuration Deleting an HTTP Load Balancer Configuration viii Sun Java System Application Server SE/EE Q2: Administration and Deployment

9 Creating and Deleting an HTTP Load Balancer Reference Enabling and Disabling Server Instances for Load Balancing Enabling and Disabling Applications for Load Balancing Creating and Deleting the HTTP Health Checker Generating a Load Balancer Configuration File Setting Up HTTP Load Balancing HTTP Load Balancing Setup Steps Adding a New Instance to Load Balancing Rolling Upgrade Overview Rolling Upgrade in Mixed Mode Rolling Upgrade Inside a Cluster Rolling Upgrade in Non-Mixed Mode Validation of Load Balancer Configuration Load Balancer Logging Configuring the Load Balancer Log Identifying Log Messages Interpreting Log Messages The RequestStart Message The RequestExit Message The UnhealthyInstances Message The FailedOverRequest Message The Quiesced Message HADB Basics Objectives Relevance Additional Resources HADB Features Interfaces to HADB HADB Hardware Architecture Protecting Data in the HADB Data Fragmentation and Replication Node Monitoring Fault Tolerance Node Recovery Node Repair Double Network Achieving High Availability Configuring a System for the HADB Database DRU, Host, and Node Configurations HADB Deployment Topology Hardware Configuration Supported OS Versions for HADB V ix

10 Shared Memory and Semaphore Configuration Performance Considerations Other Considerations HADB Management Architecture Terminology HADB Management Architecture Relationships: Agent, Domain, Database Instance, and Application Server Cluster HADB Directory Structure Configure and Start Management Agent MA Configuration Files An ma.cfg Example Starting the MA Communicating With the MA Performing Simple Management Tasks The hadbm Commands Create a Domain Create a Database Create a Database Example 1 Domain Does Not Exist Create a Database Example 2 Domain Already Exists Monitor a Database List and Modify Database Configuration Attributes Start and Stop a Database Start and Stop a Node Clear a Database Delete a Database Increase Database Storage Capacity on the Nodes Clear and Archive History Files Manage HADB Software Packages Configuring a Cluster for HA Tasks Performed by the configure-ha-cluster Command HTTP Session Persistence Objectives Relevance Additional Resources Fundamentals of a Session and Session Persistence Session Basics How a Session Works HTTP Session Persistence Session Persistence Subsystem Architecture Supported Features Supported J2EE Object References EJB Technology Reference Failover Distributed Container Semantics x Sun Java System Application Server SE/EE Q2: Administration and Deployment

11 Session Persistence Mechanisms Persistence Types The memory Persistence Type The file Persistence Type The ha Persistence Type Persistence Frequency Persistence Scope The session Scope The modified-session Scope The modified-attribute Scope Comparison of Persistence Types HA for SSO Sessions Criteria for Distributed Sessions Across Multiple Instances Availability at Different Levels Configuring Session Persistence for HA Creating and Configuring the HA Cluster Enabling HA for an Instance Using the CLI Enabling HA for an Instance Using the GUI Configuring Availability for the Web Container Using the CLI Configuring Availability for the Web Container Using the GUI Making a Web Application Distributable Configuring Availability Settings for a Web Application 8-45 RMI/IIOP Load Balancing and Failover Objectives Relevance Additional Resources Basics of RMI/IIOP RMI/IIOP Communication RMI/IIOP Load Balancing and Failover Features Supported Client Types for RMI/IIOP Architecture Load Balancer Sub-System Failover Sub-Systems Server-Side Configuration Properties of a Named Configuration Setting Instance-specific Values Creating an IIOP Listener Creating a Secure IIOP Listener Related CLI Commands Configuring Clients Sample sun-acc.xml File Rolling Upgrade for Applications Accessed by Application Clients xi

12 EJB Container High Availability Objectives Relevance Additional Resources SFSB Failover Features SFSB Passivation Checkpointing Steps in Checkpointing SFSB Failover Support for Various Deployment Scenarios Transparent Failover Configuring SFSB Failover Availability Hierarchy Availability at Different Levels Instance-Level Availability Container-Level Availability Application and EJB Module-Level Availability Enabling at Bean and Method Levels EJB Timer Service Application Server EE 8.1 EJB Timers EJB Timer Service Configuration Configuring Timer Service Settings EJB Timer Migration Transaction Recovery Server Instance Restarts After Failure RM Failure in the Second Phase Server Instance Fails and Does Not Restart JMS Clustering and Failover Objectives Relevance Additional Resources JMS Message Queue Product Editions Components of a Message Queue Messaging System Message Queue 3.6 Features Multi-Consumer Durable Subscription Message Queue 3.6 Integrating With Application Server Application Server s Built-in JMS Architecture of the Built-in JMS Delivery of Inbound Messages Connector Architecture The ActivationSpec Component Sample MDB Descriptor Resource Adapter Features xii Sun Java System Application Server SE/EE Q2: Administration and Deployment

13 JMS Configuration JMS Configuration GUI Types of JMS JMS Connection Pool Connection Failover Multi-Broker Clusters Multi-Broker Cluster Architecture Multi-Broker Cluster Architecture Multi-Broker Cluster Configuration Out-of-Box Scenario Dedicated Brokers Multi-Broker Cluster Deployment MQ and Application Server Clustering Normal MQ and Application Server Clustering Server Instance Failure MQ and Application Server Clustering Server Instance Restart MQ and Application Server Clustering Broker Failure Failover of a Durable Subscription Multi-Broker Cluster Performance Upgrade and Migration Objectives Relevance Additional Resources Application Server Compatibility Web Server Application Server Compatibility 7.1 to Upgrading to Application Server SE/EE Server Configuration Migration Upgrade Version Support Supported Features of Upgrade Tool Non-Supported Features of Upgrade Tool Upgrading Clusters Application Migration Issues Migrating From Earlier Versions Migrating From Earlier Versions DDs Migrating From Earlier Versions Servlets and JSP Pages Migrating From Earlier Versions Web Application Modules Migrating From Earlier Versions Migrating EJB Modules Migrating From Earlier Versions EJB 1.1 to EJB Migrating From Earlier Versions Migrating EJB Clients Migrating From Earlier Versions JDBC API Code xiii

14 Migrating From Earlier Versions HTTP Session Failover Migrating From Earlier Versions Enterprise Applications Java AVK Enterprise Migration Tool Migration Tool Input Migration Tool GUI Migration Report Post-Migration Tasks Tuning Performance Objectives Relevance Additional Resources Performance Roles of Key Web Components Performance Tuning Tuning Applications Version Consistency Request Partitioning Read-Only Beans Relationship Prefetch Tuning Application Server Tuning the EJB Container Tunables of EJB Objects EJB Pool Parameters EJB Cache Parameters SFSB Cache Remote Interfaces and Local Interfaces Using Local Interfaces Parameter Passing Tuning Other Resources Tuning Log and Deployment Settings General Tuning Tips Tuning Application Server for HA JDBC API Connection Pool for HA Tuning the Connection Pool When SSO Is Enabled Impact of Session Size on Performance HTTP Session Persistence Frequency HTTP Session Persistence Scope Other HTTP Session Tuning Considerations SFSB Checkpointing Load Balancer Tuning Tuning the HADB OS Configurations Disk Usage xiv Sun Java System Application Server SE/EE Q2: Administration and Deployment

15 HADB-specific Parameters HADB Tuning Scenarios Useful Performance Tuning Tools Troubleshooting Objectives Additional Resources Resources for Identifying Problems Log Files Console Messages Application Server SE/EE 8.1 Processes The JVM Process Thread Dump Core Dump Problems in Application Server Prerequisite JDK Software Installation Cannot Install Load Balancer to New Web Server Instance Application Server 8.1 Start Problems Network Connection Port Conflicts Administrative Client Problems The asadmin Utility Cannot Access the Admin Console Application Server Problems Auto Deploy Auto Deploy Configuration GUI HTTP Session Failover Not Working Troubleshooting Server Hang Problems Troubleshooting Server Crash Problems Troubleshooting Server Crash Problems Troubleshooting JVM Process Problems Troubleshooting JVM Process Problems Load Balancer Errors Load Balancer Files Not Found Load Balancer Timeout Period Problems Dynamic Reconfiguration Fails HADB Problems HADB Database Creation Fails HADB Administration Errors The hadbm Command Fails: The agents <url> could not be reached The hadbm Command Fails: JAVA_HOME not defined The create Command Fails: Path does not exist on a host The hadbm createdomain Command Fails xv

16 The hadbm Command Does Not Return Control to the User Database Does Not Start Database Restart Problems HADB Management Agent Crashes HADB Holding on to Shared Memory Double Node Failure The create-session-store Command Fails Session Data Corrupted Performance Problems xvi Sun Java System Application Server SE/EE Q2: Administration and Deployment