SUNW.ldom(5) (Sun Cluster Data Services Reference Manual for Solaris OS)

Sun Cluster Data Services Reference Manual for Solaris OS

SUNW.ldom(5)

Name | Description | Examples | Attributes | See Also

Name

SUNW.ldom, ldom– resource type implementation for failover guest domains.

Description

The LDoms Guest Domains data service for Sun Cluster 3.2 is configured as a resource managed by the Sun 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 entity that the logical domain manager migrates the guest domain when the resource is being switched over or a failover is triggered.

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 with in 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
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 thepmfadm(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

Note –

You should install the LDoms guest domain data service before performing the steps in the example.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscdns