4-16 Oracle Fusion Middleware Oracle Process Manager and Notification Server Administrators Guide
Please note that the -force option circumvents most pre-validation checks. Therefore, Oracle recommends using the -force option with caution. An
example is shown in section Force deleteinstance
.
Force deleteinstance The deleteinstance command operates in a forced mode if the option -force
true is included in the command. When used, this option directs opmnctl to proceed with the operation regardless of warnings and errors detected for the Oracle instance.
Because the Oracle instance may be in a bad or non-responsive state, Oracle recommends explicitly providing non-required values that are associated and
appropriate for the Oracle instance for example, -instanceName, -adminHost, -adminPort to ensure that the proper values are used.
During the course of cleanup, the forced deleteinstance command displays warnings and exceptions consistent with the damaged state of the Oracle instance.
These warnings and exceptions are provided as visual feedback for the inconsistencies encountered and do not necessarily indicate that further corrective action is needed.
For example: opmnctl deleteinstance -force true -instanceName instance1 -adminHost
myadminserver -adminPort 7001 or
opmnctl deleteinstance -force true -instanceName instance1
4.3.4.4.4 deletecomponent The deletecomponent command deletes a system
component. The deletecomponent command uses the following arguments:
■
Adminserver
■
Logging
■
Oracle Instance
■
-componentName
: The system component name. For example:
opmnctl deletecomponent -componentName ohs1
4.3.4.4.5 registerinstance The registerinstance command switches the Oracle
instance to a registered state and updates the Adminserver value. The registerinstance command uses the following arguments:
■
Adminserver
■
Logging
■
Oracle Instance
For example: opmnctl registerinstance -adminHost myhostname -adminPort 8000
4.3.4.4.6 unregisterinstance The unregisterinstance command switches the Oracle
instance to a non-registered state and updates the Adminserver value.
opmnctl Commands 4-17
For example: opmnctl unregisterinstance
The unregisterinstance command uses the following arguments:
■
Adminserver
■
Logging
■
Oracle Instance
■
-force
: directs the opmnctl unregisterinstance command to proceed regardless of discrepancies in the Oracle instance. This option is only enabled with
a value of true. The default value is false. Please note that the -force option circumvents most pre-validation checks.
Therefore, Oracle recommends using the -force option with caution. An example is shown in section
Forced unregisterinstance
Forced unregisterinstance The unregisterinstance command can operate in a forced mode when the option
-force true is included.
This option directs opmnctl unregisterinstance to unregister the Oracle instance but limits the scope of these changes exclusively to the Adminserver. In other words, it
unregisters an Oracle instance name from the Adminserver without examining or interacting with an Oracle instance except optionally for writing to the
provision.log file.
This mode can readily break registration associations. For example, executing this command with the name of a operational registered Oracle instance would put
Adminserver and the Oracle instance out of synchronization. Afterward, the Adminserver no longer lists the Oracle instance or associated system components;
however, in this example, the Oracle instance would still be configured as registered and but would fail most provisioning commands. Therefore, Oracle recommends
using the -force option with caution.
For example: opmnctl unregisterinstance -force true -instanceName instance1 -adminHost
myadminserver -adminPort 7001
4.3.4.4.7 updateinstanceregistration The updateinstanceregistration command
updates information registered on the Adminserver for the Oracle instance. Specifically, the updateinstanceregistration command updates the registered
OPMN remote port, OPMN remote host and OPMN wallet from the current OPMN settings.
The updateinstanceregistration command uses the following arguments:
■
Adminserver
■
Logging
■
Oracle Instance
For example: opmnctl updateinstanceregistration
