opmnctl Usage

In this section we'll cover the purpose, location, common usage, and syntax for the opmnctl utility.

Purpose

OPMN system is a background process that manages all the individual components for a given 10g AS instance. Each of these interrelated processes is managed by OPMN. If a process dies, OPMN will attempt to restart it. It continually polls the processes that it expects to be up and restarts them if they die or become unreachable.

Though OPMN is a background process, it has a command-line interface that can be used to stop or start all the processes for a given installation. The opmnctl utility is a handy way to start or stop the software without having to use the web GUI ASC utility.

Location

Located in the 10g AS $ORACLE_HOME/opmn/bin directory.

Common Usages

Common usages for opmnctl are shown in the following sections.

Start up all processes

 $ opmnctl startall opmnctl: starting opmn and all managed processes...

Shut down all processes

 $ opmnctl stopall opmnctl: stopping opmn and all managed processes...

Start and stop individual processes (OHS, for example)

 $ opmnctl stopproc ias-component=HTTP_Server opmnctl: stopping opmn managed processes... $ opmnctl startproc ias-component=HTTP_Server opmnctl: starting opmn managed processes...

Restart individual processes (OHS or OC4J, for example)

 $ opmnctl restartproc ias-component=HTTP_Server opmnctl: restarting opmn managed processes... $ opmnctl restartproc ias-component=OC4J process-type=home opmnctl: restarting opmn managed processes...

Check status

 $ opmnctl status Processes in Instance: 904mt1.mike.wessler.name -------------------+--------------------+-------+--------- ias-component       process-type          pid  status -------------------+--------------------+-------+--------- OC4J                home                30930  Alive HTTP_Server         HTTP_Server         31207  Alive dcm-daemon          dcm-daemon          30611  Alive LogLoader           logloaderd            N/A  Down $

Syntax

To get a list of available arguments, issue opmnctl -help , as follows :

 $ opmnctl -help usage: /u01/app/oracle/product/9.0.4inf1/OraHome1/opmn/bin/opmnctl [verbose] [<scope>] <command> [<options>] verbose: print detailed execution message if available Permitted <scope>/<command>/<options> combinations are:  scope    command    options  -------  ---------  ---------           start                         - Start opmn           startall                      - Start opmn & all managed processes           stopall                       - Stop opmn & all managed processes           shutdown                      - Shutdown opmn & 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           ping        [<max_retry>]     - Ping local opmn           validate    [<filename>]      - Validate the given xml file           help                          - Print brief usage description           usage       [<command>]       - Print detailed usage description $