Administrator’s Guide 10g Release 2 (10.1.2) - Oracle

[Pages:100]Oracle? Application Server

Administrator's Guide 10g Release 2 (10.1.2)

B13995-08

September 2006

Oracle Application Server Administrator's Guide, 10g Release 2 (10.1.2)

B13995-08

Copyright ? 2002, 2006, Oracle. All rights reserved.

Contributing Authors: Helen Grembowicz, , Kevin Hwang, Peter LaQuerre, Mary Beth Roeser, Harry Schaefer, Deborah Steiner

Contributors: Megan Ginter, Pavana Jain, Kai Li, Thomas Van Raalte, Andrew Salt, Pavi Sandhu

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.

Contents

List of TFiagbuleress

Preface ............................................................................................................................................................. xxv

Audience................................................................................................................................................... xxv Documentation Accessibility ................................................................................................................. xxv Related Documentation .......................................................................................................................... xxvi Conventions ............................................................................................................................................. xxvi

What's New in Oracle Application Server Administration? ......................................... xxvii

New Features for 10g Release 2 (10.1.2.0.2) ........................................................................................ xxvii New Features for 10g Release 2 (10.1.2.0.0) ....................................................................................... xxviii

Part I Getting Started

1 Getting Started After Installing Oracle Application Server

1.1 Task 1: Set Up Environment Variables .................................................................................... 1-1

1.2 Task 2: Use the Oracle Application Server Welcome Page................................................... 1-3

1.3 Task 3: Check Your Port Numbers ........................................................................................... 1-5

1.4 Task 4: Get Started with Managing Components .................................................................. 1-6

1.4.1

Getting Started with Oracle Process Manager and Notification Server (OPMN)...... 1-7

1.4.2

Getting Started with Distributed Configuration Management (DCM) ....................... 1-8

1.4.3

Getting Started with Oracle HTTP Server........................................................................ 1-8

1.4.4

Getting Started with Oracle Application Server Containers for J2EE (OC4J)............. 1-9

1.4.5

Getting Started with OracleAS Web Cache ..................................................................... 1-9

1.4.6

Getting Started with OracleAS Portal............................................................................ 1-10

1.4.7

Getting Started with OracleAS Wireless ....................................................................... 1-10

1.4.8

Getting Started with OracleBI Discoverer..................................................................... 1-10

1.4.8.1

Prepare for Multidimensional Analysis ................................................................. 1-11

1.4.8.2

Prepare for Relational Analysis............................................................................... 1-14

1.4.9

Getting Started with OracleAS Forms Services............................................................ 1-15

1.4.10

Getting Started with OracleAS Reports Services ......................................................... 1-15

1.4.11

Getting Started with OracleAS Personalization ........................................................... 1-15

1.4.12

Getting Started with Oracle Application Server Integration Products..................... 1-16

1.4.13

Getting Started with Identity Management Components .......................................... 1-16

1.5 Task 5: Enable SSL (Optional) ................................................................................................ 1-16

iii

2 Introduction to Administration Tools

2.1 Overview of Oracle Application Server Administration Tools ........................................... 2-1

2.1.1

Managing Oracle Application Server with Oracle Enterprise Manager 10g .............. 2-1

2.1.1.1

Using Application Server Control to Manage Oracle Application Server ........... 2-2

2.1.1.2

Using Grid Control to Manage Your Enterprise...................................................... 2-2

2.1.1.3

Using Database Control to Manage an OracleAS Metadata Repository Database......................................................................................................................... 2-2

2.1.2

Managing Oracle Application Server from the Command Line .................................. 2-3

2.1.3

Using Other Tools to Monitor the Built-In Performance Metrics ................................. 2-3

2.2 About Oracle Enterprise Manager 10g Application Server Control.................................... 2-4

2.2.1

Introducing the Enterprise Manager Home Pages ......................................................... 2-5

2.2.2

About the Underlying Technologies................................................................................. 2-5

2.2.3

Managing Previous Versions of Oracle Application Server.......................................... 2-6

2.2.4

Using the Application Server Control Console Online Help ........................................ 2-7

2.3 Getting Started with the Application Server Control Console............................................. 2-7

2.3.1

Displaying the Application Server Control Console ...................................................... 2-7

2.3.1.1

Using the Application Server Control Console URL............................................... 2-7

2.3.1.2

Displaying the Application Server Control Console from the Welcome Page.... 2-8

2.3.2

Understanding the Initial Application Server Control Console Home Page.............. 2-8

2.3.3

Using the Application Server Home Page ....................................................................... 2-9

2.3.4

Using the Oracle Application Server Farm Page ......................................................... 2-10

2.3.5

Using an Oracle Application Server Component Home Page ................................... 2-11

2.4 Monitoring and Diagnosing with the Application Server Control Console ................... 2-12

2.4.1

Reviewing the Application Server Component Topology ......................................... 2-12

2.4.2

Reviewing General Information and Resource Usage ................................................ 2-13

2.4.3

Reviewing the Resources of the Application Server Host .......................................... 2-14

2.4.4

Monitoring Application Server Components ............................................................... 2-15

2.4.5

Displaying the All Metrics Page for the Application Server or an Application Server Component 2-15

2.4.6

Monitoring J2EE Applications ........................................................................................ 2-16

2.4.7

Obtaining More Information About Monitoring Oracle Application Server .......... 2-17

2.5 Managing the OracleAS Metadata Repository Database with Database Control.......... 2-17

2.6 About Oracle Enterprise Manager 10g Grid Control.......................................................... 2-19

2.6.1

About the Components of Grid Control ....................................................................... 2-19

2.6.2

Installing the Grid Control Components ...................................................................... 2-19

2.6.3

Logging In to the Grid Control Console........................................................................ 2-20

2.6.4

Viewing a List of Application Servers in the Grid Control Console ......................... 2-21

2.6.5

Overview of Grid Control Monitoring Tasks ............................................................... 2-22

2.6.6

Obtaining More Information About Grid Control....................................................... 2-23

3 Starting and Stopping

3.1 3.2 3.2.1 3.2.2 3.2.3 3.2.4

Overview of Starting and Stopping Procedures..................................................................... 3-1 Starting and Stopping Application Server Instances............................................................. 3-1

Starting OracleAS Infrastructure ....................................................................................... 3-2 Stopping OracleAS Infrastructure..................................................................................... 3-3 Starting a Middle-Tier Instance ......................................................................................... 3-4 Stopping a Middle-Tier Instance ....................................................................................... 3-5

iv

3.3 3.3.1 3.3.2 3.4 3.5 3.5.1 3.5.2 3.6 3.6.1 3.6.2 3.6.3 3.6.4

Starting and Stopping Components......................................................................................... 3-5 Starting and Stopping Components Using opmnctl ...................................................... 3-5 Starting and Stopping Components Using Application Server Control Console ...... 3-6

Enabling and Disabling Components ...................................................................................... 3-6 Starting and Stopping an Oracle Application Server Environment .................................... 3-7

Starting an Oracle Application Server Environment...................................................... 3-7 Stopping an Oracle Application Server Environment.................................................... 3-7 Starting and Stopping: Special Topics ..................................................................................... 3-8 Starting and Stopping Log Loader .................................................................................... 3-8 Starting and Stopping in High Availability Environments........................................... 3-9 Resolving OC4J Errors When Starting Multiple Instances ............................................ 3-9 Forcing a Shut Down of OracleAS Metadata Repository ........................................... 3-12

Part II Basic Administration

4 Managing Ports

4.1 About Managing Ports ............................................................................................................... 4-1

4.2 Viewing Port Numbers .............................................................................................................. 4-2

4.3 Changing Middle-Tier Ports ..................................................................................................... 4-2

4.3.1

Changing Oracle Enterprise Manager Ports .................................................................... 4-3

4.3.2

Changing OC4J Ports .......................................................................................................... 4-4

4.3.3

Changing the Oracle HTTP Server Listen Ports.............................................................. 4-6

4.3.4

Changing the Oracle HTTP Server Diagnostic Port ....................................................... 4-9

4.3.5

Changing OracleAS Web Cache Ports........................................................................... 4-10

4.3.5.1

Changing the OracleAS Web Cache Listen Ports ................................................. 4-10

4.3.5.2

Changing the OracleAS Web Cache Administration Port................................... 4-17

4.3.5.3

Changing the OracleAS Web Cache Invalidation Port ........................................ 4-18

4.3.5.4

Changing the OracleAS Web Cache Statistics Port .............................................. 4-19

4.3.6

Changing the DCM Discovery Port ............................................................................... 4-19

4.3.7

Changing the Java Object Cache Port ............................................................................ 4-20

4.3.8

Changing the Log Loader Port ....................................................................................... 4-20

4.3.9

Changing OPMN Ports (ONS Local, Request, and Remote)...................................... 4-20

4.3.10

Changing the Port Tunneling Port ................................................................................. 4-21

4.3.11

Changing the OracleAS Portal Port ............................................................................... 4-22

4.3.12

Changing the OracleAS Wireless Port........................................................................... 4-22

4.3.13

Changing OracleBI Discoverer Ports ............................................................................. 4-22

4.3.14

Changing the OracleAS Forms Services Port ............................................................... 4-22

4.3.15

Changing OracleAS Reports Services Ports.................................................................. 4-22

4.3.15.1

Changing the OracleAS Reports Services Bridge Port......................................... 4-23

4.3.15.2

Changing the OracleAS Reports Services Network Port..................................... 4-23

4.3.15.3

Changing the OracleAS Reports Services SQL*Net Port..................................... 4-24

4.4 Changing Infrastructure Ports ............................................................................................... 4-24

4.4.1

Changing the OracleAS Metadata Repository Net Listener Port .............................. 4-24

4.4.1.1

Changing the KEY Value for an IPC Listener ....................................................... 4-29

4.4.2

Changing Oracle Internet Directory Ports .................................................................... 4-29

4.4.3

Changing the HTTP Server Port on an Identity Management Installation.............. 4-33

v

4.4.4 4.5 4.6

Changing OracleAS Certificate Authority Ports .......................................................... 4-40 Changing OracleAS Developer Kit Ports ............................................................................. 4-41 Changing Oracle Content Management Software Development Kit Ports..................... 4-41

5 Managing Log Files

5.1 Introduction to Oracle Application Server Logging .............................................................. 5-1

5.1.1

Understanding Log File Data and Naming ..................................................................... 5-1

5.1.1.1

ODL Message Formatting and ODL Log File Naming ........................................... 5-2

5.1.1.2

Log File Messages by Component ............................................................................. 5-2

5.1.2

Using a Log Repository....................................................................................................... 5-3

5.1.3

Configuring Component Logging Options ..................................................................... 5-4

5.2 Listing and Viewing Log Files with Application Server Control ........................................ 5-4

5.2.1

Listing Log Files for Components ..................................................................................... 5-5

5.2.2

Listing Log Files from Oracle Application Server Components Pages ....................... 5-6

5.2.3

Using Log Files Advanced Search..................................................................................... 5-6

5.3 Searching Diagnostic Messages in a Log Repository............................................................. 5-7

5.3.1

Getting Started with Log Repository ................................................................................ 5-7

5.3.2

Searching Log Repository with Simple Search................................................................ 5-7

5.3.3

Searching Log Repository with Advanced Search.......................................................... 5-8

5.3.4

Viewing Repository Log Entry Details............................................................................. 5-9

5.3.5

Using Regular Expressions with Log Repository Search............................................... 5-9

5.4 Diagnosing Problems and Correlating Messages ............................................................... 5-10

5.4.1

Correlating Messages Across Log Files and Components.......................................... 5-10

5.4.2

Diagnosing Component Problems ................................................................................. 5-11

5.5 Using Oracle Application Server Log Loader...................................................................... 5-11

5.5.1

Starting and Stopping Log Loader ................................................................................. 5-12

5.5.2

Enabling and Disabling Log Loader .............................................................................. 5-12

5.5.3

Updating the Log Configuration.................................................................................... 5-12

5.5.4

Setting Log Loader Properties ........................................................................................ 5-13

5.5.5

Understanding Log Loader Diagnostic Messages ....................................................... 5-14

5.6 Advanced Logging Topics...................................................................................................... 5-14

5.6.1

Using the printlogs Tool to View Log Messages.......................................................... 5-15

5.6.2

Understanding ODL Messages and ODL Log Files .................................................... 5-15

5.6.2.1

ODL Message Contents ............................................................................................ 5-15

5.6.2.2

ODL Log File Naming .............................................................................................. 5-16

5.6.3

Understanding Log Loader Log File Format Conversion .......................................... 5-17

5.6.4

Component Diagnostic Log File Registration .............................................................. 5-18

5.6.5

Configuring Components to Produce ODL Messages and ECIDs............................ 5-19

5.6.5.1

Configuring Oracle HTTP Server to Produce ODL Messages ............................ 5-20

5.6.5.2

Configuring OC4J to Produce ODL Messages ...................................................... 5-20

5.6.5.3

Configuring OC4J to Produce ECIDs ..................................................................... 5-20

5.6.6

Creating and Managing a Diagnostic Message Database Repository ...................... 5-21

5.6.6.1

Creating a Diagnostic Message Database Repository .......................................... 5-21

5.6.6.2

Removing Old Messages from the Diagnostic Message Repository ................. 5-23

5.6.6.3

Deleting the Diagnostic Message Repository ........................................................ 5-23

5.6.6.4

Reconfiguring Log Loader to Use a File-Based Repository................................. 5-23

5.6.7

Limitations and Configuration ....................................................................................... 5-23

vi

6 Managing an OracleAS Metadata Repository

6.1 6.2 6.3 6.3.1

6.3.2 6.4 6.4.1 6.4.2 6.4.3 6.5 6.6

Frequently Asked Questions About OracleAS Metadata Repository................................. 6-1 Postinstallation Status of OracleAS Metadata Repository Schemas.................................... 6-4 Viewing OracleAS Metadata Repository Schema Passwords.............................................. 6-6

Viewing OracleAS Metadata Repository Schema Passwords using Oracle Directory Manager .................................................................................................. 6-6 Viewing OracleAS Metadata Repository Schema Passwords using ldapsearch........ 6-7 Changing OracleAS Metadata Repository Schema Passwords ........................................... 6-7 Changing Schema Passwords Using the Application Server Control Console....... 6-10 Changing Schema Passwords Using SQL*Plus............................................................ 6-10 Changing Schema Passwords in Oracle Internet Directory ....................................... 6-10 Changing the Character Set of OracleAS Metadata Repository ....................................... 6-11 Renaming and Relocating OracleAS Metadata Repository Datafiles .............................. 6-12

Part III Advanced Administration

7 Reconfiguring Application Server Instances

7.1 Expanding a Middle-Tier Installation...................................................................................... 7-1

7.2 Configuring Additional Components After Installation ...................................................... 7-2

7.2.1

Configuring OracleAS Web Cache After Installation .................................................... 7-3

7.2.1.1

Things to Know Before You Start............................................................................... 7-3

7.2.1.2

Configuring OracleAS Web Cache............................................................................. 7-4

7.2.1.3

Post-Configuration Tasks ............................................................................................ 7-4

7.2.2

Configuring OracleAS Portal After Installation.............................................................. 7-4

7.2.2.1

Things to Know Before You Start............................................................................... 7-4

7.2.2.2

Configuring OracleAS Portal...................................................................................... 7-5

7.2.2.3

Post-Configuration Tasks ............................................................................................ 7-5

7.2.2.4

Steps Needed If OracleAS Portal Configured Before OracleAS Web Cache ....... 7-6

7.2.3

Configuring OracleAS Wireless After Installation ......................................................... 7-7

7.2.3.1

Configuring OracleAS Wireless ................................................................................. 7-7

7.2.3.2

Post-Configuration Tasks ............................................................................................ 7-7

7.2.4

Configuring OracleBI Discoverer After Installation....................................................... 7-8

7.2.4.1

Configuring OracleBI Discoverer............................................................................... 7-8

7.2.4.2

Post-Configuration Tasks ............................................................................................ 7-8

7.2.5

Configuring OracleAS Forms Services After Installation.............................................. 7-9

7.2.5.1

Configuring OracleAS Forms Services...................................................................... 7-9

7.2.5.2

Post-Configuration Tasks ............................................................................................ 7-9

7.2.6

Configuring OracleAS Reports Services After Installation ........................................ 7-10

7.2.6.1

Things to Know Before You Start............................................................................ 7-10

7.2.6.2

Configuring OracleAS Reports Services ................................................................ 7-10

7.2.6.3

Post-Configuration Tasks ......................................................................................... 7-10

7.2.7

Configuring OracleAS Personalization After Installation .......................................... 7-11

7.2.8

Configuring OracleAS Single Sign-On After Installation ........................................... 7-11

7.2.8.1

Configuring OracleAS Single Sign-On ................................................................... 7-11

7.2.8.2

Post-Configuration Tasks ......................................................................................... 7-12

7.2.9

Configuring Oracle Delegated Administration Services After Installation ............. 7-12

vii

7.2.9.1

Things to Know Before You Start............................................................................

7.2.9.2

Configuring mod_osso for Oracle Delegated Administration Services ............

7.2.9.3

Configuring Delegated Administration Service ...................................................

7.2.9.4

Post-Configuration Tasks .........................................................................................

7.2.10

Configuring Directory Integration and Provisioning After Installation ..................

7.3 Deconfiguring Components ...................................................................................................

7.4 Deleting OC4J Instances..........................................................................................................

7.5 Configuring J2EE and Web Cache to Use Infrastructure Services....................................

7.5.1

Configuring Instances to Use Oracle Identity Management ......................................

7.5.2

Configuring Instances with Oracle Identity Management to Use

OracleAS Metadata Repository

7.5.3

Configuring Instances to Use an Existing Database as a Repository ........................

7.5.4

Configuring Instances Without Oracle Identity Management to Use

OracleAS Metadata Repository

7.5.5

Configuring Instances to Use an Existing File-Based Repository..............................

7.5.6

Configuring Instances to Use a New File-Based Repository......................................

7.6 Disabling and Enabling Anonymous Binds.........................................................................

7.6.1

Disabling Anonymous Binds for RunTime Environments.........................................

7.6.2

Enabling Anonymous Binds for Configuration Changes...........................................

7-12 7-12 7-15 7-15 7-15 7-16 7-16 7-17 7-18

7-19 7-21

7-22 7-24 7-24 7-25 7-25 7-27

8 Changing Network Configurations

8.1 Overview of Procedures for Changing Network Configurations ....................................... 8-1

8.2 Changing the Hostname, Domain Name, or IP Address...................................................... 8-1

8.2.1

Understanding the chgiphost Command......................................................................... 8-2

8.2.2

Changing the Hostname, Domain Name, or IP Address of a Middle-Tier

Installation ............................................................................................................................ 8-3

8.2.3

Changing the Hostname, Domain Name, or IP Address of an Identity

Management Installation .................................................................................................... 8-9

8.2.4

Changing the Hostname or Domain Name of an OracleAS Certificate

Authority Installation....................................................................................................... 8-18

8.2.5

Changing the IP Address of an Infrastructure Containing a Metadata Repository 8-18

8.2.6

Special Topics for Changing Your Hostname or Domain Name............................... 8-21

8.2.6.1

Running SSLConfigTool for SSL Environments ................................................... 8-21

8.2.6.2

Setting the Log Level for chgiphost ........................................................................ 8-21

8.2.6.3

Customizing the chgiphost Command .................................................................. 8-21

8.2.6.4

Changing a Hostname after Upgrading from Windows 2000 to

Windows 2003 ............................................................................................................ 8-22

8.2.6.5

Recovering from Errors When Changing Your Hostname ................................. 8-22

8.3 Moving Between Off-Network and On-Network ............................................................... 8-23

8.3.1

Moving from Off-Network to On-Network (Static IP Address)................................ 8-23

8.3.2

Moving from Off-Network to On-Network (DHCP) .................................................. 8-23

8.3.3

Moving from On-Network to Off-Network (Static IP Address)................................ 8-24

8.3.4

Moving from On-Network to Off-Network (DHCP) .................................................. 8-24

8.4 Changing Between a Static IP Address and DHCP ............................................................ 8-24

8.4.1

Changing from a Static IP Address to DHCP............................................................... 8-24

8.4.2

Changing from DHCP to a Static IP Address............................................................... 8-24

viii

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download