Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 What's New in OPMN?

• 1.1 Grouping Mechanism for OC4J Groups
• 1.2 New Output for opmnctl status command
• 1.3 New opmnctl Option

2 OPMN: Overview

• 2.1 What is OPMN?
• 2.2 How OPMN Works
  • 2.2.1 Oracle Notification Server
  • 2.2.2 Oracle Process Manager
  • 2.2.3 PM Modules
• 2.3 What Oracle Application Server Components Does OPMN Manage?
  • 2.3.1 Oracle Enterprise Manager 10g Application Server Control Console
  • 2.3.2 Grid Computing and OPMN
  • 2.3.3 OPMN for Cluster Discovery

3 The opmn.xml File

• 3.1 opmn.xml
• 3.2 OC4J Groups
• 3.3 Dynamic Discovery in opmn.xml
  • 3.3.1 Multi-Cast Configuration
  • 3.3.2 Discovery Server Configuration
  • 3.3.3 Gateway Configuration
• 3.4 Dynamic Resource Management
  • 3.4.1 Resource Management Directives
  • 3.4.2 RMD Configuration
    • 3.4.2.1 RMD Conditionals
    • 3.4.2.2 RMD Actions
    • 3.4.2.3 RMD Exceptions
    • 3.4.2.4 RMD Configuration in the opmn.xml file
    • 3.4.2.5 RMD Evaluation
• 3.5 Service Failover
• 3.6 Automatic Restart
• 3.7 Event Scripts
• 3.8 Start Order Dependencies
• 3.9 OPMN Log Files
• 3.10 Security
  • 3.10.1 Remote Security
• 3.11 IPv6 Support

4 opmnctl Commands

• 4.1 opmnctl
  • 4.1.1 opmnctl Syntax
• 4.2 opmnctl Command Quick Reference
• 4.3 opmnctl Detailed Command Description
  • 4.3.1 Command Definitions
    • 4.3.1.1 Scope
    • 4.3.1.2 Attributes
    • 4.3.1.3 Verbose
  • 4.3.2 Server Control Commands
    • 4.3.2.1 Server Control Commands on Microsoft Windows
    • 4.3.2.2 opmnctl start
    • 4.3.2.3 opmnctl startall
    • 4.3.2.4 opmnctl stopall
    • 4.3.2.5 opmnctl shutdown
    • 4.3.2.6 opmnctl reload
  • 4.3.3 Process Control Commands
    • 4.3.3.1 opmnctl startproc, opmnctl restartproc and opmnctl stopproc
    • 4.3.3.2 Progressive Request Reports
    • 4.3.3.3 Sequential Requests
    • 4.3.3.4 opmnctl config
    • 4.3.3.5 Starting a Specific J2EE Application
    • 4.3.3.6 Starting an OC4J group
  • 4.3.4 Status Commands
    • 4.3.4.1 opmnctl status
    • 4.3.4.2 opmnctl status for OC4J Groups
    • 4.3.4.3 opmnctl dmsdump
    • 4.3.4.4 opmnctl ping
    • 4.3.4.5 opmnctl set
    • 4.3.4.6 opmnctl query
  • 4.3.5 Help Commands
    • 4.3.5.1 opmnctl help
    • 4.3.5.2 opmnctl usage
    • 4.3.5.3 opmnctl validate

5 Using OPMN

• 5.1 Starting OPMN
• 5.2 Starting and Stopping OPMN-Managed Processes for a Local Oracle Application Server Instance
• 5.3 Starting and Stopping all OPMN Managed Processes for a Remote Oracle Application Server Instance
• 5.4 Starting and Stopping an Oracle Application Server Component in a Local Oracle Application Server Instance
• 5.5 Starting and Stopping an Oracle Application Server Process Type in a Local Oracle Application Server Instance
• 5.6 Starting and Stopping a Multi-Oracle Application Server Instance Environment
• 5.7 Starting a Component on an Oracle Application Server Cluster
• 5.8 Starting an OC4J Group

6 opmn.xml Common Configuration

• 6.1 Example of opmn.xml Elements and Attributes
• 6.2 opmn.xml Element and Attribute Descriptions

7 Configuring Oracle HTTP Server

• 7.1 Oracle HTTP Server Process Module Configuration
• 7.2 Oracle HTTP Server Minimum Configuration
• 7.3 Oracle HTTP Server Complete Configuration
• 7.4 Oracle HTTP Server Attribute Descriptions
• 7.5 Oracle HTTP Server 2
• 7.6 Generic Apache (Linux only)

8 Configuring OC4J

• 8.1 OC4J Process Module Configuration
• 8.2 OC4J Minimum Configuration
• 8.3 OC4J Complete Configuration
• 8.4 OC4J Group Configuration
• 8.5 OC4J Attribute Descriptions

9 Configuring Oracle Application Server Port Tunnel

• 9.1 OracleAS Port Tunnel Process Module Configuration
• 9.2 OracleAS Port Tunnel Minimum Configuration
• 9.3 OracleAS Port Tunnel Complete Configuration
• 9.4 OracleAS Port Tunnel Attribute Descriptions

10 Configuring Custom Process

• 10.1 Custom Process Module Configuration
• 10.2 Custom Process Minimum Configuration
• 10.3 Custom Process Complete Configuration
  • 10.3.1 Ping
• 10.4 Custom Process Attribute Descriptions

A OPMN Troubleshooting

• A.1 Problems and Solutions
  • A.1.1 Oracle Application Server Process Does Not Start
  • A.1.2 Determining if Oracle Application Server Processes are Dying or Unresponsive
  • A.1.3 opmnctl Command Execution Times Out
  • A.1.4 Oracle Application Server Component Automatically Restarted by OPMN
  • A.1.5 Unexpected opmnctl start Behavior
  • A.1.6 Disabled Element in the opmn.xml File
  • A.1.7 Unable to Start OC4J
  • A.1.8 Unable to Stop Component
  • A.1.9 globalInitNLS Error
  • A.1.10 Start Remote Hosts of a Cluster Independently
  • A.1.11 OPMN Start Up Consumes CPU Processing Capability
  • A.1.12 Error Messages During Start-up of OPMN
  • A.1.13 Disable, or Reconfigure, Firewall When Creating Topology Using Multi-Cast Address Configuration
  • A.1.14 Increasing Size of opmn.log File
• A.2 Diagnosing OPMN Problems
  • A.2.1 OPMN log Files
    • A.2.1.1 opmn.log and opmn.dbg File Rotation
    • A.2.1.2 Process Console log File Rotation
  • A.2.2 opmnctl debug
  • A.2.3 Oracle Enterprise Manager 10g Application Server Control Console
  • A.2.4 Troubleshooting with Event Scripts
  • A.2.5 opmn.xml Environment Variables
• A.3 Need More Help?

Index