Provided by: resource-agents_3.9.2-5ubuntu4_i386 bug


       ocf_heartbeat_oracle - Manages an Oracle Database instance


       oracle [start | stop | status | monitor | meta-data | validate-all]


       Resource script for oracle. Manages an Oracle Database instance as an
       HA resource.


           The Oracle SID (aka ORACLE_SID).  (unique, required, string, no

           The Oracle home directory (aka ORACLE_HOME). If not specified, then
           the SID along with its home should be listed in /etc/oratab.
           (optional, string, no default)

           The Oracle owner (aka ORACLE_OWNER). If not specified, then it is
           set to the owner of file $ORACLE_HOME/dbs/*${ORACLE_SID}.ora. If
           this does not work for you, just set it explicitely.  (optional,
           string, no default)

           Sometimes IPC objects (shared memory segments and semaphores)
           belonging to an Oracle instance might be left behind which prevents
           the instance from starting. It is not easy to figure out which
           shared segments belong to which instance, in particular when more
           instances are running as same user. .sp What we use here is the
           "oradebug" feature and its "ipc" trace utility. It is not optimal
           to parse the debugging information, but I am not aware of any other
           way to find out about the IPC information. In case the format or
           wording of the trace report changes, parsing might fail. There are
           some precautions, however, to prevent stepping on other peoples
           toes. There is also a dumpinstipc option which will make us print
           the IPC objects which belong to the instance. Use it to see if we
           parse the trace file correctly. .sp Three settings are possible:
           .sp - none: don't mess with IPC and hope for the best (beware:
           you'll probably be out of luck, sooner or later) - instance: try to
           figure out the IPC stuff which belongs to the instance and remove
           only those (default; should be safe) - orauser: remove all IPC
           belonging to the user which runs the instance (don't use this if
           you run more than one instance as same user or if other apps
           running as this user use IPC) .sp The default setting "instance"
           should be safe to use, but in that case we cannot guarantee that
           the instance will start. In case IPC objects were already left
           around, because, for instance, someone mercilessly killing Oracle
           processes, there is no way any more to find out which IPC objects
           should be removed. In that case, human intervention is necessary,
           and probably _all_ instances running as same user will have to be
           stopped. The third setting, "orauser", guarantees IPC objects
           removal, but it does that based only on IPC objects ownership, so
           you should use that only if every instance runs as separate user.
           .sp Please report any problems. Suggestions/fixes welcome.
           (optional, string, default instance)

           The clear of the backup mode of ORACLE.  (optional, boolean,
           default false)

           How to stop Oracle is a matter of taste it seems. The default
           method ("checkpoint/abort") is: .sp alter system checkpoint;
           shutdown abort; .sp This should be the fastest safe way bring the
           instance down. If you find "shutdown abort" distasteful, set this
           attribute to "immediate" in which case we will .sp shutdown
           immediate; .sp If you still think that there's even better way to
           shutdown an Oracle instance we are willing to listen.  (optional,
           string, default checkpoint/abort)


       This resource agent supports the following actions (operations):

           Starts the resource. Suggested minimum timeout: 120.

           Stops the resource. Suggested minimum timeout: 120.

           Performs a status check. Suggested minimum timeout: 5.

           Performs a detailed status check. Suggested minimum timeout: 30.
           Suggested interval: 120.

           Performs a validation of the resource configuration. Suggested
           minimum timeout: 5.

           Suggested minimum timeout: 5.

           Retrieves resource agent metadata (internal use only). Suggested
           minimum timeout: 5.


       The following is an example configuration for a oracle resource using
       the crm(8) shell:

           primitive p_oracle ocf:heartbeat:oracle \
             params \
               sid=string \
             op monitor depth="0" timeout="30" interval="120"



       Linux-HA contributors (see the resource agent source for information
       about individual authors)