Appendix A Sun Cluster HA for MaxDB Extension Properties

Extension properties for Sun Cluster HA for MaxDB resource types are described in the following sections.

• SUNW.sapdb Extension Properties

• SUNW.sap_xserver Extension Properties

For details about system-defined properties, see the r_properties(5) man page and the rg_properties(5) man page.

SUNW.sapdb Extension Properties

The SUNW.sapdb resource type represents the MaxDB application in a Sun Cluster configuration. The extension properties of this resource type are as follows:

dbmcli_Start_Option

The option that is passed to the dbmcli command to start the MaxDB database instance.

---

Note –

For MaxDB version 7.4.3, set this property to db_online.

---

Data type

String

Default

db_online

Range

Not applicable

Tunable

When disabled

DB_Name

The name of the MaxDB database instance in uppercase. This name is created when MaxDB is installed and configured as explained in Installing and Configuring MaxDB.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

DB_User

The UNIX user identity of the operating system (OS) user who administers the MaxDB database instance. This user's home directory contains the .XUSER.62 file that was created during the installation and configuration of MaxDB. For more information, see Installing and Configuring MaxDB.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

Failover_enabled

Specifies whether the fault monitor fails over the MaxDB resource if the number of attempts to restart exceeds Retry_count within the time that Retry_interval specifies. The possible values of this extension property are as follows:

• True – Specifies that the fault monitor fails over the MaxDB resource

• False – Specifies that the fault monitor does not fail over the MaxDB resource

Data type

Boolean

Default

True

Range

Not applicable

Tunable

Any time

Independent_Program_Path

The full path to the directory that contains the following programs and libraries for the MaxDB application:

• Programs that are independent of the database software version

• Libraries for the client runtime environment

Sun Cluster HA for MaxDB determines the path to the dbmcli command from the value of this property. The dbmcli command resides in the bin subdirectory of the directory that this property specifies.

Data type

String

Default

/sapdb/programs

Range

Not applicable

Tunable

When disabled

Monitor_retry_count

The maximum number of restarts by the process monitor facility (PMF) that are allowed for the fault monitor.

Data type

Integer

Default

4

Range

No range defined

Tunable

Any time

Monitor_retry_interval

The period of time in minutes during which the PMF counts restarts of the fault monitor.

Data type

Integer

Default

2

Range

No range defined

Tunable

Any time

Pid_Dir_Path

The full path to the directory under which files that store the process identities of MaxDB kernel processes are created. The process identities of MaxDB kernel processes are stored in the following files:

• pid-dir/ppid/db-name

• pid-dir/pid/db-name

The replaceable items in these file paths are as follows:

• pid-dir is the directory that the Pid_Dir_Path extension property specifies

• db-name is the name of the MaxDB database instance that the DB_Name extension property specifies

Data type

String

Default

/var/spool/sql

Range

Not applicable

Tunable

When disabled

Probe_timeout

The timeout value in seconds that the fault monitor uses to probe an MaxDB database instance.

Data type

Integer

Default

90

Range

30–99,999

Tunable

Any time

Restart_if_Parent_Terminated

Determines whether the fault monitor restarts the MaxDB database instance if the parent kernel process is terminated. The possible values of this extension property are as follows:

• True – Specifies that the fault monitor restarts the MaxDB database instance if the parent kernel process is terminated

• False – Specifies that the fault monitor does not restart the MaxDB database instance if the parent kernel process is terminated

Data type

Boolean

Default

False

Range

Not applicable

Tunable

Any time

User_Key

The user key of the database user who administers the MaxDB database instance. This user key is created when MaxDB is installed and configured as explained in Installing and Configuring MaxDB.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

SUNW.sap_xserver Extension Properties

The SUNW.sap_xserver resource type represents SAP xserver in a Sun Cluster configuration. The extension properties of this resource type are as follows:

Confdir_List

The full path to the directory that contains the MaxDB software and MaxDB database instance.

Data type

String

Default

/sapdb

Range

Not applicable

Tunable

At creation

Independent_Program_Path

The full path to the directory that contains the following programs and libraries for SAP xserver:

• Programs that are independent of the database software version

• Libraries for the client runtime environment

Sun Cluster HA for MaxDB determines the path to the x_server command from the value of this property. The x_server command resides in the bin subdirectory of the directory that this property specifies.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

When disabled

Introduced in release

3.1 4/04

Monitor_retry_count

The maximum number of restarts by the PMF that are allowed for the fault monitor.

Data type

Integer

Default

4

Range

No range defined

Tunable

Any time

Monitor_retry_interval

The period of time in minutes during which the PMF counts restarts of the fault monitor.

Data type

Integer

Default

2

Range

No range defined

Tunable

Any time

Probe_timeout

The timeout value in seconds for fault monitor probes.

Data type

Integer

Default

120

Range

No range defined

Tunable

Any time

Soft_Stop_Pct

The percentage of the Stop method timeout that is used to stop SAP xserver by using the SAP utility x_server stop. If this timeout is exceeded, the SIGKILL signal is used to stop all SAP xserver processes.

Data type

Integer

Default

50

Range

1–100

Tunable

When disabled

Xserver_User

The UNIX user identity of the OS user who administers SAP xserver.

Data type

String

Default

root

Range

Not applicable

Tunable

At creation