SUNW.ldom, ldom - resource type implementation for failover logical domains.
The Oracle Solaris Cluster data service for Oracle VM Server for SPARC (HA for Oracle VM Server) is configured as a resource managed by the Oracle Solaris Cluster Resource Group Manager (RGM).
You must set the following properties on an HA for Oracle VM Server resource by using clresource(8CL) man page.
The standard resource property Failover is set for all failover resource types.
SOFT
Any time
Allows the cluster framework to move excess workload off of the target node before the switchover begins. This allows the live migration to succeed more often and hence makes the process of switchover seamless.
For more information, see Pre_evict Resource Property in Developing Data Services and SCHA_TARGET_NODES Query in Developing Data Services.
Optional
True
When disabled
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(7) man page.
Optional
The empty list
Any time
2
When disabled
370
When disabled
60
Any time
This property determines the behavior of clresourcegroup switchover -n ldom-rg for a resource group that contains a SUNW.ldom resource. You can set this property value as either TRUE or FALSE.
Live migration of a guest domain managed by the SUNW.ldom resource can be achieved by setting the Migration_type property value to MIGRATE and then executing the clresourcegroup switchover -n ldom-rg command.
When you set this property value as FALSE, then in a scenario where live migration of guest domain managed by the SUNW.ldom resource fails, HA for Oracle VM Server will stop the guest domain on source node, and then start it on the target node. When you set this property value as TRUE, then in a scenario where an attempt to live migrate the guest domain is not successful, then the guest domain remains on the source system.
Optional
FALSE
Any time
Specifies the command that sets up trace and debug messages. Increasing the debug_level allows more messages to be written to the system-log. You can set debug_level as a per-node extension property by setting it for one node or different values for each node.
Optional
True
Integer
0
3
0
Any time
Setting Debug_level=0 does not produce any trace output or debug messages.
Setting Debug_level=1 does not produce any trace output; however, reduced debug messages are written to the system-log.
Setting Debug_level=2 produces trace output and all debug messages are written to the system-log.
Setting Debug_level=3 produces all debug messages that are written to the DEBUG_LOGFILE, /var/cluster/logs/DS/SUNW.ldom/message_log.${RESOURCE}.
Indicates the name of the logical domain.
Required
No default
When disabled
Specifies the level, or type of diagnostic messages that are logged by HA for Oracle VM Server. You can specify None, Info, or Err for this property. When you specify None, diagnostic messages are not logged by the data service. When you specify Info, both information and error messages are logged. When you specify Err, only error messages are logged.
Optional
Info
Any time
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.
Even if the Migration_type property is set to MIGRATE, there may be cases where the cluster cannot determine the target node to which the resource group is migrating. In such cases, the cluster reverts to an ordinary resource group switchover in which it shuts down the logical domain on its current node before booting it on the new node. To achieve live migration, relocate the HA for Oracle VM Server resource group by using the clresourcegroup switch command explicitly on the resource group, rather than depending on node evacuation or strong resource group affinities to move the resource group.
Optional
MIGRATE
Any time
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(8) 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 logical domains. The restarts of the logical domain resources are controlled by the system-defined properties Thorough_Probe_Interval, Retry_Interval, and Retry_Count, as specified in their descriptions. See clresource(8CL). You can modify the value for this property at any time.
4
Any time
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(8) 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.
2
Any time
This property determines whether to use the public network or privateinterconnect for live migration of guest domain. Possible values are PRIVATE and PUBLIC.
Even if the Network_type extension property is set as PUBLIC, there might be a case when public network interface is not in healthy state just before live migration is triggered. In such a case, private interconnects are instead used for live migration.
Optional.
PRIVATE
Any time
This property specifies the complete path to the file containing the target host password required for logical domain migration.
This property is obsolete as of version 6 of the SUNW.ldom resource type. Instead, use the rg-name_rs-name_ldompasswd private string, to store the password needed for live migration. For more information, see the clpstring(8CL) man page.
Required if the Migration_type property is set to MIGRATE.
No default
Any time
This property specifies the command that checks the status of the logical domain. This should return with an exit status of 0 if the logical domain is running properly. The probe status is used within the HA for Oracle VM Server probing algorithm to determine whether to restart the logical domain locally or to failover the logical domain to another node.
Optional
Null
Any time
Indicates the time-out value (in seconds) used by the fault monitor to probe a logical domain instance. You can modify the value for this property at any time.
30
Any time
This property specifies whether or not to use configured SSL Certificates for live migration as an authentication mechanism between source and target cluster nodes. You can set this property value as either TRUE or FALSE.
When you set this property value as TRUE, then authentication between source and target cluster nodes for live migration is done through configured SSL certificates. When you set this property value as FALSE, then password authentication is done between source and target cluster nodes for live migration through private string.
If you have configured both SSL certificates and private string on the cluster nodes, the value of property Use_SSL_Certificate determines the authentication mechanism for live migration. For more information, see Oracle VM Server for SPARC 3.4 Administration Guide.
Optional
FALSE
Any time
The following example registers version 9 of the SUNW.ldom resource type, which represents HA for Oracle VM for SPARC in an Oracle Solaris Cluster configuration.
# clresourcetype register SUNW.ldom:9 # clresourcetype show SUNW.ldom === Registered Resource Types === Resource Type: SUNW.ldom:9 RT_description: Oracle Solaris Cluster Data Service for Oracle VM Server for SPARC RT_version: 9 API_version: 13 RT_basedir: /opt/SUNWscgds/bin Single_instance: False Proxy: False Init_nodes: All potential masters Installed_nodes: <All> Failover: False Pkglist: <NULL> RT_system: False Global_zone: FalseExample 2 Creating a Failover Logical Domain Resource
The following example creates a failover logical 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 logical domain resource uses the plugin_probe script to check the status of the logical domain.
Since, the property value Use_SSL_Certificate is not explicitly specified in the below example, the default value FALSE is considered for the property Use_SSL_Certificate.
This example uses private string ldom-rg_ldom-rs_passwd for secured live migration during switchover of resource group ldom-rg that contains the SUNW.ldom:9 resource named ldom-rs.
# clresourcetype register SUNW.ldom # clpstring create -t resource -b ldom-rs ldom-rg_ldom-rs_passwd Enter string value: Enter string value again: # clresource create -g ldom-rg -t SUNW.ldom:9 \ -p Domain_name=ldg1 \ -p Plugin_probe="/opt/SUNWscxvm/bin/ppkssh -P \ fmuser:/export/fmuser/.ssh/id_dsa:ldg1:multi-user-server:online" \ -p Resource_dependencies_offline_restart=ldg1-hasp-rs \ ldom-rsExample 3 Using SSL Certificates for Live migration of Guest Domain Managed by Resource of Type SUNW.ldom:9
The following example creates a failover logical 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. As Use_SSL_Certificate has been set to TRUE explicitly, the live migration of the guest domain ldg1 will be done through SSL certificate authentication between the source and target hosts.
Configure the SSL certificates on all the potential primary nodes for the resource group that will contain resource of type SUNW.ldom:9. For more information, see the Oracle VM Server for SPARC 3.4 Administration Guide.
# clresourcetype register SUNW.ldom # clresource create -g ldom-rg -t SUNW.ldom:9 \ -p Domain_name=ldg1 \ -p Use_SSL_Certificate=TRUE \ -p Migration_type=MIGRATE \ -p Resource_dependencies_offline_restart=ldg1-hasp-rs \ ldom-rs
See attributes(7) for descriptions of the following attributes:
|
scha_resource_open(3HA), attributes(7), r_properties(7), clresourcegroup(8CL), clresourcetype(8CL), pmfadm(8)
Planning and Administering Data Services for Oracle Solaris Cluster 4.4