2 Using OPMN

This chapter provides command-line examples on how to use OPMN for Oracle Application Server. It features the following topics:

• Section 2.1, "Starting OPMN"

• Section 2.2, "Starting and Stopping OPMN-Managed Processes for a Local Oracle Application Server Instance"

• Section 2.3, "Starting and Stopping all OPMN Managed Processes for a Remote Oracle Application Server Instance"

• Section 2.4, "Starting and Stopping an Oracle Application Server Component in a Local Oracle Application Server Instance"

• Section 2.5, "Starting and Stopping an Oracle Application Server Process Type in a Local Oracle Application Server Instance"

• Section 2.6, "Starting and Stopping a Multi-Oracle Application Server Instance Environment"

• Section 2.7, "Starting a Component on an Oracle Application Server Farm"

2.1 Starting OPMN

OPMN 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 host.

Use the following command to start OPMN without starting other Oracle Application Server components:

prompt > opmnctl start

2.2 Starting and Stopping OPMN-Managed Processes for a Local Oracle Application Server Instance

Use the following command to start OPMN-managed processes for a local Oracle Application Server instance:

prompt > opmnctl startproc

Use the following command to stop OPMN-managed processes for a local Oracle Application Server instance:

prompt > opmnctl stopproc

Note: Without arguments the opmnctl startproc and opmnctl stopproc commands start and stop all OPMN-managed processes.

2.3 Starting and Stopping all OPMN Managed Processes for a Remote Oracle Application Server Instance

Use the following command to start OPMN managed processes for a remote Oracle Application Server instance:

prompt > opmnctl @instance:oracleas2.foo.com startproc

Use the following command to stop OPMN managed processes for a remote Oracle Application Server instance:

prompt > opmnctl @instance:oracleas2.foo.com stopproc

2.4 Starting and Stopping an Oracle Application Server Component in a Local Oracle Application Server Instance

Use the following command to start Oracle Internet Directory in a local Oracle Application Server instance:

prompt > opmnctl startproc ias-component=OID

Use the following command to stop Oracle Internet Directory in a local Oracle Application Server instance:

prompt > opmnctl stopproc ias-component=OID

2.5 Starting and Stopping an Oracle Application Server Process Type in a Local Oracle Application Server Instance

Use the following command to start the performance_server process-type in a local Oracle Application Server instance:

prompt > opmnctl startproc ias-component=wireless process-type=performance_server

Use the following command to stop the performance_server process-type in a local Oracle Application Server instance:

prompt > opmnctl stopproc ias-component=wireless process-type=performance_server

2.6 Starting and Stopping a Multi-Oracle Application Server Instance Environment

Use the following command to start a multi-Oracle Application Server instance environment from local instance oracleas1:

prompt > opmnctl @instance:oracleas1.foo.com:oracleas2.bar.com startproc

This command starts all processes of all components on both instances specified with the <scope> argument. Notice that the local instance oracleas1 is specified in the command.

Use the following command to stop a multi-Oracle Application Server instance environment from local instance oracleas1:

prompt > opmnctl @instance:oracleas1.foo.com:oracleas2.bar.com stopproc

This command stops all processes of all components on all two instances specified with the <scope> argument. Notice that the local instance oracleas1 is specified in the command.

Note: You must also indicate your local Oracle Application Server instance when using the @instance <scope> with other Oracle Application Server instances. Commands with a <scope> argument only operates on the instances described by the <scope> argument. The command will only be applied to the local instance if it is described in the <scope> argument.

2.7 Starting a Component on an Oracle Application Server Farm

Use the following command to start the same Oracle Application Server component on multiple Oracle Application Server instances:

prompt > opmnctl @farm startproc ias-component=HTTP_Server

Use the following command to stop the same Oracle Application Server component on multiple Oracle Application Server instances:

prompt > opmnctl @farm stopproc ias-component=HTTP_Server