B
OSD Registry Entries

The information in this appendix is based on Oracle Corporation's reference implementation of the cluster Operating System Dependent (OSD) modules. Consequently, some of this information may not be applicable to your particular cluster environment.
 

Additional Information: Consult with your hardware vendor for more details about installing and configuring your particular cluster configuration

This appendix describes the registry entries for the following DLLs, and information on whether they are required or optional:

Specific topics covered in this appendix are:

• Generic Operating System Dependent Registry Entries
• CM Reference Registry Entries
• P&M Registry Entries

 

 

Generic Operating System Dependent Registry Entries

Operating System Dependent (OSD) components provide the key functions for proper operation of Oracle8i Parallel Server options. Each required or optional OSD module interacts with the Oracle8i Parallel Server runtime environment as a single DLL.

Oracle8i Parallel Server requires a set of registry entries to determine the full path of OSD DLLs. The values for CMDLL, IODLL, IPCDLL, and STARTDLL inform the Oracle8i Parallel Server environment and test tools where to find the OSD DLLs.

For the required DLLs, vendors need to set the registry entries and supply DLLs. Optional DLLs use Oracle default values. If optional DLL registry values are set, these values override Oracle default registry entries.

OSD value types fall into following categories:

• The REG_SZ prefix identifies a value entry as a data string
• The REG_DWORD prefix identifies a value entry as a DWORD (hexadecimal data) entry
• The REG_MULTI_SZ prefix identifies a value entry as a multiple string

 

 

The following registry entries are defined in the SOFTWARE\ORACLE\OSD subkey on the local machine:

Values	Value Type	Description
		HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OSD
CMDLL	REG_SZ	Specifies the full path of the Cluster Manager (CM) DLL. Required.
IODLL	REG_SZ	Specifies the full path of the Input/Output (IO) DLL. Required.
IPCDLL	REG_SZ	Specifies the full path of the Inter-Process Communication (IPC) DLL. Required.
PMDLL	REG_SZ	Specifies the full path of the Performance & Management (P&M) DLL. P&M is not an OSD component, but resides in this area. This DLL is maintained by Oracle. Required if using Oracle Enterprise Manager.
STARTDLL	REG_SZ	Specifies the full path of the Startup DLL. Optional.

 

Note: The Performance and Management (P&M) DLL is no longer installed with the vendor OSD layer. The P&M DLL is installed with the Oracle8i Parallel Server Option in the ORACLE_BASE\ORACLE_HOME\BIN directory.

CM Reference Registry Entries

The Cluster Manager (CM) registry values are defined in SOFTWARE\ORACLE\OSD\CM:

Value	Value Type	Description
		HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OSD\CM
ErrorLog	REG_SZ	Specifies the location of the CM error log file if CM is started by the Startup module. Oracle recommends using SYSTEMROOT\SYSTEM32\CM.LOG.  If CM is started as a service, the error log is automatically placed in this location. In this case, it is not necessary to set a value for ErrorLog. If CM is not a service, see "Installing and De-Installing CM As a Service". Optional.
CmSrvrPath	REG_SZ	Specifies the full path of the CM executable.  Required if the START module is used and CM is started by the Startup module.
DefinedNodes	REG_MULTI_SZ	A list of TCP/IP DNS host names. Each host name defines a potential member of the cluster. These host name must be the same as the host name in the SYSTEMROOT\SYSTEM32\DRIVERS\ETC\HOSTS file. Required.Note: : The order of HostNames in this value is important since it defines the node numbers (0...n). Each host that is a cluster member must have exactly the same value.
PollInterval	REG_DWORD	Defines the check-in time among CMs on different nodes. Each CM is expected to send at least one status packet to all other nodes per pollinterval. Default: 1000 milliseconds, or 1 second
MissCount	REG_DWORD	Defines the number of check in intervals that can be missed before a CM and its related node is declared down by the cluster.  Default: 3
CmHostName	REG_SZ	Used by the local CM. Useful in a multi-host environment, when more than one network is available on the node.
CmDiskFile	REG_SZ	Enables Split-Brain feature.To enable, set this to a partition greater than 2MB, for example: \\.\OPS_CMDISK. Null value means feature is disabled.

P&M Registry Entries

The P&M component was a vendor-supplied component installed with the OSD layer prior to this release. This component interacted with the Oracle Enterprise Manager tools. Because P&M must be implemented in a precise manner, this component is now installed with the Oracle8i Parallel Server Option rather than as an OSD module.

The Performance and Management (P&M) registry values are defined in HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OSD\PM. Under this subkey, each Oracle8i Parallel Server cluster has its own registry subkey. The domain key name is the same as the cluster name. Within these keys, values are defined to provide the per-domain and per-instance information.

The following are the P&M registry entries:

Value	Value Type	Description
		HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OSD\PM
		HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OSD\PM \DB_NAME
0	REG_MULTI_SZ	Specifies the cluster instance ID data assigned to the OP1 on the primary node with the following format: SID COMPUTER_NAME HOST_NAME ORACLE_HOME
1	REG_MULTI_SZ	Specifies the cluster instance ID data assigned to the OP2 on the second node with the following format: SID COMPUTER_NAME HOST_NAME ORACLE_HOME