DISCLAIMER: The information and links provided on this site are my personal notes, based on my limited experience installing, using, and deinstalling Oracle databases and application servers on a variety of computers using Windows NT/2000/XP operating systems. The installation and deinstallation procedures found here can cause irreversable loss of data and may damage your operating system. However, you are welcome to use them AT YOUR OWN RISK. I am in no way responsible for data you lose or operating systems you damage or destroy.

What Is opmnctl?

opmnctl is a command-line interface to the OracleAS components and sub-components. It can start, stop, and provide status of the application.

Full explanation here

Location of opmctl

opmnctl is located at \ORACLE_HOME\opmn\bin

opmnctl Commands

D:\OraHome1\opmn\bin>opmnctl -h

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

verbose: print detailed execution message if available

Permitted <scope>/<command>/<options> combinations are:

 scope    commnad       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

D:\OraHome1\opmn\bin>

Starting OracleAS with opmnctl

D:\OracleAS\opmn\bin>opmnctl startall
opmnctl: starting opmn and all managed processes...

D:\OracleAS\opmn\bin>

Stopping OracleAS with opmnctl

D:\OracleAS\opmn\bin>opmnctl shutdown
opmnctl: shutting down opmn and all managed processes...

D:\OracleAS\opmn\bin>

Checking Status of OracleAS with opmnctl


D:\OracleAS\opmn\bin>opmnctl status

Processes in Instance: OraAS.foobar.com
-------------------+--------------------+-------+---------
ias-component      | process-type       |   pid | status
-------------------+--------------------+-------+---------
OC4J               | OC4J_BI_Forms      |  1384 | Alive
OC4J               | home               |  1996 | Alive
WebCache           | WebCacheAdmin      |  1976 | Alive
WebCache           | WebCache           |  3416 | Alive
HTTP_Server        | HTTP_Server        |  2552 | Alive
dcm-daemon         | dcm-daemon         |  2188 | Alive
LogLoader          | logloaderd         |   N/A | Down

Stopping and Starting a Single Process


D:\OraHome1\opmn\bin>opmnctl status

Processes in Instance: infra_904.foo.bar.com
-------------------+--------------------+-------+---------
ias-component      | process-type       |   pid | status
-------------------+--------------------+-------+---------
OID                | OID                |  1456 | Alive
OC4J               | OC4J_SECURITY      |  3392 | Alive
HTTP_Server        | HTTP_Server        |  1100 | Alive
dcm-daemon         | dcm-daemon         |  3340 | Alive
LogLoader          | logloaderd         |   N/A | Down


D:\OraHome1\opmn\bin>opmnctl stopproc ias-component=OID
opmnctl: stopping opmn managed processes...

D:\OraHome1\opmn\bin>opmnctl status

Processes in Instance: infra_904.foo.bar.com
-------------------+--------------------+-------+---------
ias-component      | process-type       |   pid | status
-------------------+--------------------+-------+---------
OID                | OID                |   N/A | Down
OC4J               | OC4J_SECURITY      |  3392 | Alive
HTTP_Server        | HTTP_Server        |  1100 | Alive
dcm-daemon         | dcm-daemon         |  3340 | Alive
LogLoader          | logloaderd         |   N/A | Down


D:\OraHome1\opmn\bin>opmnctl startproc ias-component=OID
opmnctl: starting opmn managed processes...

D:\OraHome1\opmn\bin>opmnctl status

Processes in Instance: infra_904.foo.bar.com
-------------------+--------------------+-------+---------
ias-component      | process-type       |   pid | status
-------------------+--------------------+-------+---------
OID                | OID                |  3632 | Alive
OC4J               | OC4J_SECURITY      |  3392 | Alive
HTTP_Server        | HTTP_Server        |  1100 | Alive
dcm-daemon         | dcm-daemon         |  3340 | Alive
LogLoader          | logloaderd         |   N/A | Down

[Return to HowTos]