Action entry point for Cluster Server agent for Oracle

The Cluster Server agent for Oracle supports the Action entry point, which enables you to perform predefined actions on a resource.

To perform an action on a resource, type the following command:

    # hares -action res token [-actionargs arg1 ...] \
    [-sys system] [-clus cluster]

You can also add custom actions for the agent.

For further information, refer to the Cluster Server Agent Developer’s Guide.

See Table: Predefined virtual fire drill actions. describes the agent's predefined virtual fire drill actions.

Table: Predefined agent actions describes the agent's predefined actions.

Table: Predefined agent actions

Action

Description

VRTS_GetInstanceName

Retrieves the name of the configured instance. You can use this option for the Oracle and the Netlsnr resources.

VRTS_GetRunningServices

Retrieves the list of processes that the agent monitors. You can use this option for the Oracle and the Netlsnr resources.

DBRestrict

Changes the database session to enable the RESTRICTED mode.

DBUndoRestrict

Changes the database session to disable the RESTRICTED mode.

DBSuspend

Suspends a database.

DBResume

Resumes a suspended database.

DBTbspBackup

Backs up a tablespace; actionargs contains name of the tablespace to be backed up.

Note:

VRTS_GetRunningServices, DBRestrict, DBResume, DBSuspend, DBTbspBackup, and DBUndoRestrict action entry points are not supported for Oracle PDB resources.

Table: Predefined virtual fire drill actions lists the virtual fire drill actions of the Cluster Server agent for Oracle lets you run infrastructure checks and fix specific errors.

Table: Predefined virtual fire drill actions

Virtual fire drill action

Description

getid

(Oracle agent)

Verifies that the Oracle Owner exists on the node.

home.vfd

(Oracle agent)

Verifies the following:

  • ORACLE_HOME is mounted on the node and corresponding entry is in the fstab.

    If the ORACLE_HOME is not mounted, the action entry point checks if any other resource has already mounted ORACLE_HOME.

  • Pfile is provided and it exists on the node.

  • Password file from $ORACLE_HOME/dbs/orapw[SID] is present.

owner.vfd

(Oracle agent)

Verifies the uid and gid of the Oracle Owner attribute. Checks if uid and gid of Owner attribute is the same on the node where the Oracle resource is currently ONLINE.

pfile.vfd

(Oracle agent)

Checks for the presence of pfile or spfile on the local disk. If both pfile and spfile are not present, the agent function exits. If the Oracle resource is online in the cluster, the agent function logs a message that the spfile must be on the shared storage because the Oracle resource is online.

tnsadmin.vfd

(Netlsnr agent)

Checks if listener.ora file is present. If the listener.ora file is not present, it checks if ORACLE_HOME is mounted and displays appropriate messages.