SUNW.ldom

, ldom

- resource type implementation for failover guest domains.

Description

The LDoms Guest Domains data service for Oracle Solaris Cluster is configured as a resource managed by the Oracle Solaris Cluster Resource Group Manager (RGM).

You must set the following properties on an LDoms resource by using clresource(1CL) man page.

Standard Properties

The standard resource property Failover is set for all failover resource types.

Resource_dependencies (string array)

Specifies a list of resources upon which a resource depends. This list includes any HAStoragePlus resources that are used by a resource. The default value for this property is null.

You can specify an alternate kind of dependency by using the Resource_dependencies_weak, Resource_dependencies_restart, or Resource_dependencies_offline_restart property instead of the Resource_dependencies property. For more information, see the r_properties(5) man page.

Category

Optional

Default

The empty list

Tunable

Any time

Failover_mode (enum)

Default

SOFT

Tunable

When disabled

Retry_count (integer)

Default

2

Tunable

When disabled

Retry_interval (integer)

Default

370

Tunable

When disabled

Thorough_probe_interval (integer)

Default

60

Tunable

Any time

Extension Properties

Domain_name (string)

Indicates the name of the LDoms guest domain.

Category

Required

Default

No default

Tunable

When disabled

Migration_type (enum)

This property specifies the type of migration when the resource is being switched over or a failover is triggered. Possible values are MIGRATE and NORMAL.

Category

Optional

Default

MIGRATE

Tunable

Any time

Plugin_probe (string)

This property specifies the command that checks the status of the logical-guest domain. This should return with an exit status of 0 if the guest domain is running properly. The probe status is used within the HA-xVM probing algorithm to determine whether to restart the guest domain locally or to failover the guest domain to another node.

Category

Optional

Default

Null

Tunable

Any time

password_file (string)

This property specifies the complete path to the file containing the target host password required for guest domain migration.

Category

Required if the Migration_type property is set to MIGRATE.

Default

No default

Tunable

When disabled

Log_level (enum)

Specifies the level, or type of diagnostic messages that are logged by the LDoms data service. You can specify None, Info, or Err for this property. When you specify None, diagnostic messages are not logged by the LDoms data service. When you specify Info, both information and error messages are logged. When you specify Err, only error messages are logged.

Category

Optional

Default

Info

Tunable

Any time

Debug_level (integer)

This property indicates the level to which the debug messages of the Solaris Cluster agent for LDoms guest domain component are logged.

Category

Required

Default

Info

Tunable

When disabled

Monitor_retry_count (integer )

This property controls the restarts of the fault monitor. It indicates the number of times the fault monitor is restarted by the process monitor facility and corresponds to the -n option passed to the pmfadm(1M) command. The number of restarts is counted in a specified time window (see the property Monitor_retry_interval. Note that this property refers to the restarts of the fault monitor itself, not guest domains. The restarts of the guest domain resources are controlled by the system-defined properties Thorough_Probe_Interval, Retry_Interval, and Retry_Count, as specified in their descriptions. See clresource(1CL). You can modify the value for this property at any time.

Default

4

Tunable

Any time

Monitor_retry_interval (integer )

Indicates the time (in minutes) over which the failures of the fault monitor are counted and corresponds to the -t option passed to thepmfadm(1M) command. If the number of times the fault monitor fails exceeds the value of Monitor_retry_count, the fault monitor is not restarted by the process monitor facility. You can modify the value for this property at any time.

Default

2

Tunable

Any time

Probe_timeout (integer )

Indicates the time-out value (in seconds) used by the fault monitor to probe an LDOM instance. You can modify the value for this property at any time.

Default

30

Tunable

Any time

Examples

Example 1 Creating a Failover LDoms Guest-Domain Resource

The following example creates a failover LDoms guest-domain resource named ldom-rs in an existing resource group named ldom-rg. In this example, ldg1 is the domain name of the ldom-rs resource. The fault monitor of the LDoms guest-domain resource uses the plugin_probe script to check the status of the LDoms guest domain.

example# clresourcetype register SUNW.ldom
example# clresource create -g ldom-rg -t SUNW.ldom \
-p Domain_name=ldg1 -p Password_file=/global/ldom/pass \\
-p Plugin_probe="/opt/SUNWscxvm/bin/ppkssh -P \\
fmuser:/export/fmuser/ .ssh/id_dsa:ldg1:multi-user-server:online" \\
ldom-rs 

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

pmfadm(1M), scha_resource_get(3HA), clresourcetype(1CL), clresourcegroup(1CL), attributes(5), r_properties(5)

Oracle Solaris Cluster Data Services Planning and Administration Guide