Oracle SOA Suite 10g R3: Administration. Student Guide

Oracle SOA Suite 10g R3: Administration Student Guide D53181GC10 Edition 1.0 January 2009

Authors Ramaa Mani Saurabh Banerjee Technical Contributors and Reviewers Todd Bao David Berry Steve Button Bijoy Choudhury Manoj Das Litha Dhananjayan Floyd D'Silva Philip Garm Barry Hiern Taj-ul Islam Vikas Jain Paul Kasewurm Teria Kidd Mike Lehmann Aija Lehtonen Soren Madsen Debu Panda Nagavalli Pataballa Manish Pawar Abhimanyu Prabhavalkar William (Cas) Prewitt Srinivas Putrevu Gayathri Rajagopal Shankar Raman Holger Dindler Rasmussen Evgenia Julia Rosa Aninda Sengupta David Shaffer Clemens Utschig-Utschig Dr Volker Zell Frances Zhao Copyright 2008, 2009 Oracle. All rights reserved. Disclaimer This document contains proprietary information 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 where your use constitutes "fair use" under copyright 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 94065 USA. This document is not warranted to be error-free. Restricted Rights Notice If this documentation is delivered to the United States Government or anyone using the documentation on behalf of the United States 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 is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Editors Aju Kumar Nita Pavitran Graphic Designer Satish Bettegowda Publishers Michael Sebastian Joseph Fernandez

Contents Preface 1 Introduction Objectives 1-2 Course Lessons 1-4 Lesson 1: Introduction 1-6 Lesson 2: Getting Started with Oracle Application Server 1-7 Lesson 3: Installing Oracle Application Server 10g Release 3 (10.1.3.1.0) 1-8 Lesson 4: Administering and Managing Oracle Application Server 1-9 Lesson 5: Introducing Service-Oriented Architecture and Oracle SOA Suite 10g 1-10 Lesson 6: Administering and Monitoring Oracle BPEL 1-11 Lesson 7: Administering and Monitoring Oracle ESB 1-12 Lesson 8: Administering Oracle WSM 1-13 Lesson 9: Monitoring Oracle WSM 1-14 Lesson 10: High Availability Solutions for Oracle SOA Suite 1-15 Lesson 11: Backing Up and Restoring Oracle Application Server 1-16 Lesson 12: Troubleshooting Oracle Application Server 1-17 Course Schedule 1-18 Summary 1-19 2 Getting Started with Oracle Application Server Objectives 2-2 Identifying Different Administrative Roles 2-4 Challenges of Creating and Maintaining E-Business Applications 2-6 Oracle Application Server 10g R2 (10.1.2.0.2): Overview 2-7 Oracle Application Server 10g R3: Overview 2-9 Oracle Application Server 10g R3: Components and Solutions 2-11 Differences Between Oracle Application Server 10g R3 and Earlier Releases 2-13 Use Cases: Oracle Application Server 10g R3 2-15 Oracle Application Server 10g R3: Terminology 2-16 What Is a Group? 2-17 Key Features in Oracle Application Server 10g R3 2-18 Support for J2EE 1.4 Standards in Oracle Application Server 10g R3 2-19 Support for SOA Components 2-21 Support for OC4J Java Single Sign-On 2-22 Support for Creating Groups 2-23 Support for J2EE 1.4 Web Services 2-25 Key Features of Application Server Control 2-28 Summary 2-29 iii

3 Installing Oracle Application Server 10g Release 3 (10.1.3.1.0) Objectives 3-2 Oracle Application Server 10g Release 3 (10.1.3.1.0): Installation Types 3-3 Oracle Application Server 10g Release 3 (10.1.3.1.0): Installation Components 3-5 Differences Between Basic and Advanced Installations 3-7 Identifying Different Oracle Application Server 10g R3 Topologies 3-9 Installing a Managed OC4J Instance 3-10 Installing an Integrated Web Server and OC4J Middle Tier 3-11 Installing an SOA Administration Interface 3-12 Installing a J2EE Server with the SOA Suite 3-13 Installing J2EE Server, Web Server, and the SOA Suite 3-14 Installing J2EE Server and the SOA Suite with a Remote Oracle HTTP Server 3-15 Installing J2EE Server and Separate SOA Applications with a Remote Oracle HTTP Server 3-16 Installing Multiple SOA Middle Tiers with a Remote Oracle HTTP Server 3-17 Oracle Application Server 10g R3 Installation: Overview 3-18 Minimum Requirements for Installing Oracle Application Server 10g Release 3 (10.1.3.1.0) 3-19 Setting Up the Environment 3-21 Preparing an Oracle Database 10g for Oracle SOA Suite 10g 3-23 Oracle Application Server 10g R3: Installation Steps 3-24 Starting the Installation 3-25 Oracle Universal Installer 3-26 Oracle Application Server Installation Screen 3-27 First Installation of an Oracle Product 3-28 Oracle Application Server: Basic Installation 3-29 Oracle Application Server Advanced Installation 3-30 Specify Database Connect Information 3-31 Specify Database Schema Passwords and Port Configuration Options 3-32 Administration Settings 3-33 Cluster Topology Configuration 3-35 End of Installation 3-36 Postinstallation Tasks 3-37 Accessing the Oracle Application Server 10g Release 3 (10.1.3.1.0) Instance 3-38 Application Server Control 3-39 Oracle Application Server (10.1.3) Patch Set (10.1.3.3.0) 3-40 Applying Oracle Application Server Patch 3-41 Running the Upgrade Script on the Patched Application Server Instance 3-43 Installing SOA Components Individually 3-44 Summary 3-45 Practice 3 Overview: Installing Oracle Application Server 10g Release 3 (10.1.3.1.0) 3-46 iv

4 Administering and Managing Oracle Application Server Objectives 4-2 Management Infrastructure 4-4 Management Tools in Oracle Application Server 4-5 Application Server Control Console: Overview 4-7 New Features of Application Server Control in Oracle Application Server 10g Release 3 (10.1.3.x) 4-9 Displaying the Application Server Control Console 4-11 Displaying the OC4J: Home Page 4-13 Viewing the Active ascontrol 4-14 Starting, Stopping, and Restarting Oracle Application Server Instances 4-15 Managing Groups 4-16 Creating and Deleting OC4J Instances 4-17 Viewing Ports 4-18 Configuring Logging 4-19 Viewing the Log Files Message Format 4-20 Viewing Log Files 4-21 Listing Log Files for Components 4-22 OC4J Component Logger 4-23 Oracle Process Manager and Notification Server (OPMN) 4-25 Important opmnctl Commands 4-26 Starting and Stopping a Middle-Tier Instance 4-28 Viewing Ports 4-29 admin_client.jar Utility 4-30 Tasks Based on Ant 4-31 Deploying an Application 4-32 Deploying with the Oracle Application Server Control Console 4-33 Deploying a J2EE Application by Using Application Server Control 4-34 Deploying a Web Service 4-36 Deploying with admin_client.jar 4-37 Deployment URI: Overview 4-38 Deploying an Archive 4-39 Deploying with Ant Tasks 4-41 OC4J Ant Components 4-42 Prerequisites for Using OC4J Ant Tasks 4-43 Deploying an Archive (build.xml) 4-44 Starting, Restarting, and Stopping Applications by Using admin_client.jar 4-46 Restarting OC4J Instances by Using admin_client.jar 4-47 Starting and Stopping Applications by Using Ant 4-48 Restarting and Stopping OC4J Instances by Using Ant 4-49 Configuring Instances to Use OC4J Java Single Sign-On (Java SSO) 4-50 v

Setting Java SSO Properties and Generating the Symmetric Key 4-51 Configuring the Security Provider for the javasso Application 4-52 Configuring the Security Provider for Partner Applications 4-53 Enabling Partner Applications to Use Java SSO 4-54 Summary 4-55 Practice 4 Overview: Administering and Managing Oracle Application Server 4-56 5 Introducing Service-Oriented Architecture and Oracle SOA Suite 10g Objectives 5-2 Service-Oriented Architecture 5-3 Services and Web Services 5-4 What Is a Web Service? 5-6 Web Services 5-7 Web Services: Architecture 5-9 Identifying Web Service Standards 5-10 Describing Composite Applications 5-11 Identifying Standards that Enable SOA 5-12 Oracle SOA Suite: Introduction 5-14 Phases of SOA Applications 5-16 Oracle SOA Suite 10g Environment 5-17 Oracle Application Server 10g 5-19 Describing Oracle BPEL Process Manager Architecture 5-20 Describing Oracle Enterprise Service Bus Architecture 5-21 Integrating Services with Oracle ESB 5-22 Describing Oracle Business Rules 5-23 Describing Oracle Web Services Manager 5-25 Describing Oracle Service Registry 5-27 Integrating with Oracle Service Registry 5-28 Monitoring Business Activity with Oracle BAM 5-29 Introducing Oracle SOA Development Tools 5-31 Introducing the Adapter Framework 5-32 Identifying OracleAS Adapter Types 5-33 Technology Adapters 5-35 Application, Legacy, and Custom Adapters 5-36 Summary 5-37 6 Administering and Monitoring Oracle BPEL Objectives 6-2 Managing with Oracle SOA Suite 10g 6-3 Accessing Oracle BPEL Control Console 6-4 Accessing Oracle BPEL Admin Console 6-6 Users and Roles 6-7 vi

BPEL Server Administration 6-8 Creating a BPEL Domain 6-10 Compiling and Deploying a BPEL Process 6-12 Deploying a BPEL Suitcase to a Specific Domain 6-14 Viewing Deployed, Running, and Completed Processes 6-15 Instantiating a Process 6-16 Viewing the Visual Flow 6-17 Viewing the Audit Trail 6-18 Viewing Debug Information 6-19 Viewing the BPEL Process Life Cycle and States 6-20 Process Versioning 6-22 Managing BPEL Processes 6-24 Viewing Process Instances 6-30 Viewing Process Activities 6-31 Testing BPEL Processes 6-32 Test Suites: Overview 6-33 Creating a Test Case from Oracle BPEL Control 6-35 Test Cases: Overview 6-37 Running a Test Suite and Viewing Report Results 6-38 Oracle BPEL Process Reports 6-40 BPEL Process Management API 6-42 Dehydration 6-44 Managing the BPEL Dehydration Store 6-46 Trimming the Dehydration Store 6-48 Other Management Tasks 6-51 Configuring and Viewing BPEL Process Logs 6-52 Summary 6-54 Practice 6 Overview: Administering and Monitoring Oracle BPEL 6-55 7 Administering and Monitoring Oracle ESB Objectives 7-2 Administering the Enterprise Service Bus 7-3 ESB: Foundation for SOA 7-4 Enterprise Service Bus Architecture: Single Instance 7-5 Enterprise Service Bus: Cluster 7-7 Managing ESB Metadata Server and ESB Runtime Server 7-9 Creating, Configuring, and Managing Oracle Enterprise Service Bus 7-11 Basic ESB Implementation Patterns 7-13 ESB System 7-15 Creating a System 7-16 ESB Adapter Framework 7-17 Creating an ESB Service 7-19 vii

Oracle ESB Control: Services View 7-20 Instances View in ESB Control 7-22 Oracle ESB Control: Domain Value Maps 7-24 Managing Oracle ESB Systems and Service Groups 7-26 Viewing and Updating Service Definitions 7-27 Routing Rules: Overview 7-30 Creating or Modifying Routing Rules 7-31 Trackable Fields 7-33 Testing an ESB Service 7-35 Synchronous or Asynchronous Execution 7-37 Error Handling in ESB 7-38 Types of Errors in ESB 7-39 Color Coding in the Instances View 7-40 Viewing the Errors Tab 7-41 Errors Raised in Inbound Adapter Services 7-42 Errors Raised in Synchronously Called Services 7-43 Errors Raised in Asynchronously Called Services 7-44 Changing Routing Rules 7-45 Retryable Errors 7-47 Notification Channels in ESB 7-48 Moving the ESB Instance to a Different Oracle Home 7-49 import and export Utilities in ESB 7-51 Viewing Application Logs in ESB 7-53 Configuring Logging Levels 7-55 Summary 7-56 Practice 7 Overview: Administering and Monitoring Oracle ESB 7-57 8 Administering Oracle WSM Objectives 8-2 Need for Web Service Security 8-3 Web Service Security Approaches 8-4 WS-Security 8-6 WS-Security Fundamentals 8-7 Oracle Web Services Manager 8-9 Oracle WSM Server Components 8-10 Oracle WSM Server Components 8-11 Oracle WSM Policy Manager 8-12 Oracle WSM Enforcement Components 8-14 Oracle WSM Monitor 8-16 Gateway Versus Agent 8-17 Accessing Oracle Web Services Manager Control 8-19 viii

Configuring a Gateway 8-20 Configuring a Server Agent 8-22 Installing the Server Agent to the Oracle Application Server 8-23 Registering a Web Service with the Gateway 8-24 Policy Management in Oracle WSM 8-25 Oracle WSM Policy Steps 8-27 Viewing the Policy Steps 8-29 Adding a Policy Step to a Gateway Web Service 8-30 Pipeline Templates 8-32 Creating a Policy Pipeline Template 8-33 Using the Pipeline Template in the Server Agent s Policy 8-34 Restoring Previous Policy Versions 8-36 Using the Oracle WSM Test Page 8-38 Invoking a Secured Service from BPEL 8-39 Using Oracle WSM Client and Server Agents to Enforce Security Policies 8-40 Configuring a Client Agent 8-41 Installing a Client Agent 8-42 Configuring a Client Agent for a BPEL/ESB Process 8-43 Securing a BPEL Process in Oracle WSM 8-45 Invoking a Secured Web Service from BPEL 8-46 Invoking a Secured Web Service from ESB 8-47 Summary 8-48 Practice 8 Overview: Administering Oracle WSM 8-49 9 Monitoring Oracle WSM Objectives 9-2 Oracle WSM Monitoring and Auditing 9-3 Oracle WSM Monitor Architecture 9-5 Managing the Operational Environment 9-6 Monitoring System Performance 9-7 Metric Measurement Graphs: Snapshot 9-9 Metric Measurement Graphs: Service-Level Agreement Compliance 9-10 Metric Measurement Graphs: Execution Details 9-12 Metric Measurement Graphs: Access Control 9-13 Metric Measurement Graphs: Latency Variance 9-14 Metric Measurement Graphs: Traffic Analysis 9-15 Viewing Message Logs 9-16 Creating Custom Views 9-17 Executing Custom Views 9-18 What Are Oracle WSM Alarms? 9-19 Creating an Alarm Rule 9-20 ix

Creating an Alarm Processing Rule 9-23 Viewing Alarms by Using Oracle WSM Control 9-26 Summary 9-27 Practice 9 Overview: Monitoring Oracle WSM 9-28 10 High Availability Solutions for Oracle SOA Suite Objectives 10-2 What Is High Availability? 10-3 High Availability Solution 10-5 How to Improve Availability 10-7 Oracle Application Server Features for Improving Availability 10-8 Redundancy and Availability 10-9 OracleAS Cold Failover Clusters 10-10 OracleAS Cluster: Overview 10-13 Supported Clustering Models 10-14 Configuring Multicast Discovery with opmnctl 10-15 Benefits of OracleAS Cluster 10-16 High Availability and State Replication 10-17 Types of Configurations 10-18 Backup and Recovery Paradigm 10-19 Disaster Recovery 10-20 High Availability for Oracle SOA Suite 10-21 SOA HA Installation and Configuration Steps 10-24 Configuring the Data Tier 10-25 Installing and Configuring the Web Tier and Load Balancer 10-27 Installing and Configuring the Middle-Tier Cluster 10-28 High Availability Solutions for Oracle BPEL Process Manager 10-29 Oracle BPEL Process Manager in an Active Active Topology 10-30 Using a RAC Database for the Dehydration Store 10-32 Installing and Configuring the Cluster of BPEL Instances 10-33 Editing Configuration Files and Restarting Servers 10-34 Compiling and Deploying the BPEL Process 10-36 Oracle BPEL Process in an Active Passive Topology 10-38 High Availability Options for Adapters 10-39 Active Active Topology for Adapters 10-40 Modified Active Active Topology for Adapters 10-41 Active Passive Topology for Adapters 10-43 Oracle Enterprise Service Bus in an Active Active Topology 10-44 Clustering ESB Instances 10-47 Configuring Oracle WSM in a Clustered Environment 10-50 Installation: Overview 10-51 Setting Up the Web Services Manager Control 10-53 x

Disabling Oracle WSM Components on vhost3 10-54 Setting Up the Oracle WSM Gateway 10-55 Disabling Oracle WSM Components on vhost1 and vhost2 10-57 Testing the Oracle WSM System 10-58 Summary 10-60 Practice 10 Overview: High Availability Solutions for Oracle SOA Suite 10-61 11 Backing Up and Restoring Oracle Application Server Objectives 11-2 Backup and Recovery Features 11-3 Roadmap for Backup and Recovery 11-5 Concept of Oracle Application Server Backup and Recovery 11-6 Terminology 11-8 Backup Strategy for Oracle Application Server 11-9 Performing a Complete Oracle Application Server Environment Backup 11-11 Performing Online Backups 11-12 Performing a Backup After a Major Change 11-13 OracleAS Recovery Manager 11-14 Preparing to Configure OracleAS Recovery Manager 11-15 Configuring OracleAS Recovery Manager 11-16 Using bkp_restore.sh 11-18 Using bkp_restore.sh: Examples 11-19 Using Oracle Application Server Control for Backup and Recovery 11-22 Configuring Backup/Recovery Settings 11-23 Backup Procedures 11-24 Creating a Record of the Configuration 11-25 Performing a Complete Backup 11-26 Step 1: Shutting Down the Oracle Application Server Environment 11-27 Step 2: Backing Up the Infrastructure 11-29 Step 3: Backing Up the Middle Tier 11-31 Step 4: Backing Up Your Oracle System Files 11-32 Step 5: Starting Your Oracle Application Server Environment 11-33 Performing an Instance Backup from the Command Line 11-35 Performing a Complete Backup 11-36 Oracle Application Server Component Backup Input Files 11-37 Recovery Strategies 11-38 Restore Procedures 11-39 Restoring OracleAS Infrastructure to a New Host 11-41 Restoring OracleAS Infrastructure Configuration Files 11-44 Restoring the Middle Tier to the Same Host 11-45 Restoring the Middle Tier to a New Host 11-46 Restoring Middle-Tier Configuration Files 11-48 xi

Restoring an Oracle Application Server Instance 11-49 Recovering a Loss of Host Automatically 11-50 Backup Strategy for BPEL Dehydration Store 11-52 Summary 11-53 Practice 11 Overview: Backing Up and Restoring Oracle Application Server 11-54 12 Troubleshooting Oracle Application Server Objectives 12-2 Troubleshooting BPEL 12-3 Troubleshooting ESB 12-4 Troubleshooting OWSM 12-6 Additional Information 12-8 Summary 12-9 Appendix A Practices and Solutions Appendix B Introduction to Linux Appendix C Changes between Oracle Application Server 10g R3 (10.1.3.0.0) and Oracle Application Server 10g R3 (10.1.3.1.0) Appendix D Introduction to Oracle Enterprise Manager 10g Grid Control xii