opmnctl

Courtesy: http://download.oracle.com/docs/cd/B25221_05/core.1013/b15976/opmnctl.htm

What is OPMN?

OPMN is installed and configured with every Oracle Application Server installation type and is essential for running Oracle Application Server.

OPMN features the following functionality:

• Provides a command-line interface for process control and monitoring for single or multiple Oracle Application Server components and instances.
• Provides an integrated way to manage Oracle Application Server components.
• Enables management of Oracle Application Server subcomponents and sub-subcomponents.
• Channels all events from different Oracle Application Server component instances to all Oracle Application Server components that can utilize them.
• Solves interdependency issues between Oracle Application Server components by enabling you to start and stop components in order.
• Enables customizing of enterprise functionality by using event scripts.
• Enables gathering of host and Oracle Application Server process statistics and tasks.
• Provides automatic restart of Oracle Application Server processes when they become unresponsive, terminate unexpectedly, or become unreachable as determined by ping and notification operations.
• Provides automatic death detection of Oracle Application Server processes.
• Does not depend on any other Oracle Application Server component being up and running before it can be started and used.

The OPMN server should be started as soon as possible after turning on the computer. OPMN must be running whenever OPMN-managed components are turned on or off.

Oracle Application Server components managed by OPMN should never be started or stopped manually. Do not use command line scripts or utilities from previous versions of Oracle Application Server for starting and stopping Oracle Application Server components. OPMN must be the last service turned off whenever you restart or turn off your computer.

Use the Application Server Control Console and the opmnctl command line utility to start or stop Oracle Application Server components.

opmnctl

opmnctl is the supported tool for starting and stopping all components in an Oracle Application Server instance, with the exception of the Oracle Enterprise Manager 10g Application Server Control Console (Application Server Control Console). opmnctl provides a centralized way to control and monitor Oracle Application Server components from the command line. You can use opmnctl to execute control and monitoring commands across multiple Oracle Application Server instances simultaneously.

opmnctl also enables you to perform operations on a specified Oracle Application Server instance in a cluster or all instances in a cluster using an optional parameter called scope. You can also use the scope option to control an individual Oracle Application Server process.

The opmnctl command is located in the following directory locations:

(Linux) ORACLE_HOME/opmn/bin/opmnctl

(Microsoft Windows) ORACLE_HOME\opmn\bin\opmnctl

opmnctl Syntax

The following command shows an example of the syntax of the opmnctl command:

opmnctl [verbose] [<scope>] <command> [<options>]

Table 4-1 provides a description about opmnctl syntax.

Table 4-1 opmnctl Syntax

opmnctl Command Quick Reference

Example below lists opmnctl commands for quick reference. You can obtain the same output information by executing the opmnctl help command.

Example: opmnctl Commands

prompt > opmnctl help

scope command options

_________ __________ __________

start - Start opmn

startall - Start opmn and all managed processes

stopall - Stop opmn and all managed processes

shutdown - Shutdown opmn and all managed processes

[<scope>] startproc [<attr>=<val>..] - Start opmn managed processes

[<scope>] restartproc [<attr>=<val>..] - Restart opmn managed processes

[<scope>] stopproc [<attr>=<val>..] - Stop opmn managed processes

[<scope>] reload - Trigger opmn to reread opmn.xml

[<scope>] status [<options>] - Get managed process status

[<scope>] dmsdump [<attr>=<val>&..] - Get DMS stats

[<scope>} set [<attr>=<val> ..] - Set opmn log parameters

[<scope>] query [<attr>=<val> ..] - Query opmn log parameters

ping [<max_retry>] - Ping local opmn

validate [<filename>] - Validate the given xml file

config [<options>] - Modify the opmn xml file

help - Print brief usage description

usage [<command>] - Print detailed usage description