'\" t .\" Title: ocf_heartbeat_oracle .\" Author: ClusterLabs contributors (see the resource agent source for information about individual authors) .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 12/17/2020 .\" Manual: OCF resource agents .\" Source: resource-agents UNKNOWN .\" Language: English .\" .TH "OCF_HEARTBEAT_ORACLE" "7" "12/17/2020" "resource-agents UNKNOWN" "OCF resource agents" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" ocf_heartbeat_oracle \- Manages an Oracle Database instance .SH "SYNOPSIS" .HP \w'\fBoracle\fR\ 'u \fBoracle\fR [start | stop | status | monitor | meta\-data | validate\-all] .SH "DESCRIPTION" .PP Resource script for oracle\&. Manages an Oracle Database instance as an HA resource\&. .SH "SUPPORTED PARAMETERS" .PP \fBsid\fR .RS 4 The Oracle SID (aka ORACLE_SID)\&. .sp (unique, required, string, no default) .RE .PP \fBhome\fR .RS 4 The Oracle home directory (aka ORACLE_HOME)\&. If not specified, then the SID along with its home should be listed in /etc/oratab\&. .sp (optional, string, no default) .RE .PP \fBuser\fR .RS 4 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\&. .sp (optional, string, no default) .RE .PP \fBmonuser\fR .RS 4 Monitoring user name\&. Every connection as sysdba is logged in an audit log\&. This can result in a large number of new files created\&. A new user is created (if it doesn\*(Aqt exist) in the start action and subsequently used in monitor\&. It should have very limited rights\&. Make sure that the password for this user does not expire\&. .sp (optional, string, default "OCFMON") .RE .PP \fBmonpassword\fR .RS 4 Password for the monitoring user\&. Make sure that the password for this user does not expire\&. Need to explicitly set a password to a new monitor user for the security reason\&. .sp (optional, string, default "OCFMON") .RE .PP \fBmonprofile\fR .RS 4 Profile used by the monitoring user\&. If the profile does not exist, it will be created with a non\-expiring password\&. .sp (optional, string, default "OCFMONPROFILE") .RE .PP \fBipcrm\fR .RS 4 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\*(Aqt mess with IPC and hope for the best (beware: you\*(Aqll probably be out of luck, sooner or later) .sp \- instance: try to figure out the IPC stuff which belongs to the instance and remove only those (default; should be safe) .sp \- orauser: remove all IPC belonging to the user which runs the instance (don\*(Aqt 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\&. .sp (optional, string, default "instance") .RE .PP \fBclear_backupmode\fR .RS 4 The clear of the backup mode of ORACLE\&. .sp (optional, boolean, default false) .RE .PP \fBshutdown_method\fR .RS 4 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\*(Aqs even better way to shutdown an Oracle instance we are willing to listen\&. .sp (optional, string, default "checkpoint/abort") .RE .SH "SUPPORTED ACTIONS" .PP This resource agent supports the following actions (operations): .PP \fBstart\fR .RS 4 Starts the resource\&. Suggested minimum timeout: 120s\&. .RE .PP \fBstop\fR .RS 4 Stops the resource\&. Suggested minimum timeout: 120s\&. .RE .PP \fBstatus\fR .RS 4 Performs a status check\&. Suggested minimum timeout: 5s\&. .RE .PP \fBmonitor\fR .RS 4 Performs a detailed status check\&. Suggested minimum timeout: 30s\&. Suggested interval: 120s\&. .RE .PP \fBvalidate\-all\fR .RS 4 Performs a validation of the resource configuration\&. Suggested minimum timeout: 5s\&. .RE .PP \fBmethods\fR .RS 4 Suggested minimum timeout: 5s\&. .RE .PP \fBmeta\-data\fR .RS 4 Retrieves resource agent metadata (internal use only)\&. Suggested minimum timeout: 5s\&. .RE .SH "EXAMPLE CRM SHELL" .PP The following is an example configuration for a oracle resource using the \fBcrm\fR(8) shell: .sp .if n \{\ .RS 4 .\} .nf primitive p_oracle ocf:heartbeat:oracle \e params \e sid=\fIstring\fR \e op monitor depth="0" timeout="30s" interval="120s" .fi .if n \{\ .RE .\} .SH "EXAMPLE PCS" .PP The following is an example configuration for a oracle resource using \fBpcs\fR(8) .sp .if n \{\ .RS 4 .\} .nf pcs resource create p_oracle ocf:heartbeat:oracle \e sid=\fIstring\fR \e op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="120s" .fi .if n \{\ .RE .\} .SH "SEE ALSO" .PP \m[blue]\fB\%http://clusterlabs.org/\fR\m[] .SH "AUTHOR" .PP \fBClusterLabs contributors (see the resource agent source for information about individual authors)\fR