Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Services Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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 the`pmfadm`(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 | `ha-cluster/data-service/dns`

## 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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |