The Generic Data Service (GDS) Version 2 is a mechanism that enables you to proxy the state of an application or resource from another cluster framework (for example, Oracle Grid Infrastructure). You can also proxy the state of an application within the same cluster or a different cluster.
The GDSv2 contains a fully functional Oracle Solaris Cluster resource type, complete with callback methods (rt_callbacks(1HA)) and a Resource Type Registration (RTR) file (rt_reg(4)).
Specifies the timeout value, in seconds, for the boot command.
Optional
60 seconds
300 seconds
Any time
Modifies the recovery actions that the RGM takes when a resource fails to start or stop successfully, and consequently requests a restart or failover.
For more information on the failover_mode property, see the r_properties(5) man page.
Optional
SOFT
Any time
Specifies the timeout value, in seconds, for the fini command.
Optional
60 seconds
300 seconds
Any time
Specifies the timeout value, in seconds, for the init command.
Optional
60 seconds
300 seconds
Any time
Specifies the timeout value, in seconds, for the postnet_stop command.
Optional
60 seconds
300 seconds
Any time
Specifies the timeout value, in seconds, for the prenet_start command.
Optional
60 seconds
300 seconds
Any time
Indicates whether the resource is scalable, which means that the resource uses the networking load balancing features of Oracle Solaris Cluster software.
If the scalable property is set to TRUE, then additional properties such as load_balancing_policy and load_balancing_weights are used to configure the load balancing behavior.
For more information on the scalable, load_balancing_policy, and load_balancing_weights properties, see the r_properties(5) man page.
Optional
FALSE
At creation
Specifies the timeout value, in seconds, for the validate command.
Optional
60 seconds
300 seconds
Any time
Specifies the command that is run when the node or zone has been booted or rebooted. This command must be a complete command line that can be passed directly to a shell. The command normally performs the same initialization as the init_command. You must ensure that the command is idempotent—even if the command has initialized the resource during a previous execution, subsequent calls to the command must exit successfully.
Optional
Null
When disabled
Provides control over the processes that are monitored through the Process Monitor Facility (PMF). This property denotes the level to which the forked children processes are monitored. Omitting this property or setting this property to the default value is the same as omitting the –C option for pmfadm(1M): all children (and their descendents) are monitored.
Optional
-1
At creation
Debug_gds is typically used by Oracle Solaris Cluster development and support. However, it can be useful to understand the various calls and sequences that occur within GDSv2.
If debug_gds=FALSE is set, no GDSv2 internal debug messages are sent to the system log.
If debug_gds=TRUE is set, all GDSv2 internal debug messages are sent to the system log.
Optional
TRUE
When disabled
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
2
0
Any time
Specifies the command that is run when the resource is no longer managed by the RGM. This command must be a complete command line that can be passed directly to a shell. The command normally performs some cleanup or undoes any initializations that were performed by the init_command. The command is run on the node or zone where the resource becomes unmanaged when the following situations occur:
The resource group that contains the resource is switched to an unmanaged state. In this case, the RGM executes the GDSv2 fini method which executes the fini_command on all nodes and zones in the node list.
The resource is deleted from a managed resource group. In this case, the RGM executes the GDSv2 fini method which executes the fini_command on all nodes and zones in the node list.
A node or zone is deleted from the node list of the resource group that contains the resource. In this case, the RGM executes the GDSv2 fini method which executes the fini_command on all nodes and zones in the node list.
Optional
Null
When disabled
Specifies the command that is run when the resource becomes managed by the RGM as a result of one of the following conditions. This command must be a complete command line that can be passed directly to a shell.
The resource group in which the resource is located is switched from the unmanaged to a managed state.
The resource is created in a resource group that is already managed.
Optional
Null
When disabled
Specifies the logical host name to interpose whenever a system call to retrieve the hostname is made. The logical host is interposed as long as the following has been done:
The clreslogicalhostname(1CL) command has created a resource for the logical host name.
Your resource has a dependency on the logical host resource, if the logical host is in a different resource group from your resource.
/usr/lib/secure/libschost.so.1 must be symbolically linked to /usr/cluster/lib/libschost.so.1.
/usr/lib/secure/64/libschost.so.1 must be symbolically linked to /usr/cluster/lib/[amd64|sparcv9]/libschost.so.1.
Optional
TRUE
Null
When disabled
Specifies the command that stops the prenet_start_command proxy daemon. This command must be a complete command line that can be passed directly to a shell to start the proxy daemon.
If postnet_stop_command is omitted, the stop_signal extension property value is sent to the proxy daemon processes running under the PMF flag.
Optional
Null
When disabled
Specifies the command that starts the proxy daemon. This command must be a complete command line that can be passed directly to a shell to start the proxy daemon.
The prenet_start_command (or one of its forked children) is expected to be a long-running daemon. The prenet_start_command process tree is monitored by the PMF as described under the child_mon_level extension property.
Required
1
No default
When disabled
Specifies the number of seconds between invocations of the prenet_start_command proxy daemon of the resource. This extension property can be used by your prenet_start_command proxy daemon.
Optional
2 seconds
30 seconds
Any time
Specifies the signal that stops the application if the application fails to stop with the postnet_stop_command. The values for this property are the same as those defined in the signal (3HEAD) man page.
Optional
1
37
15
When disabled
Specifies the absolute path to the command that validates the application. If you do not provide an absolute path, the application is not validated.
The exit status of the validate command is used to determine whether the creation or update of the GDSv2 resource should be permitted. Before creating or updating the resource, the specified validate command is executed on each node of the node list of the resource group that contains the resource. If the validate command exits nonzero, the requested resource creation or update is not permitted. Any output that is written to stdout or stderr by the validate command will be passed back to the user who issued the administrative command to create or update the resource. Such output can be used to explain why the resource validation failed.
The validate command is also executed before performing the GIVEOVER option of the scha_control command to relocate the resource group to a new node. If the command exits nonzero, the GIVEOVER is blocked and the resource group remains mastered on its current node.
Optional
Null
When disabled
The following example uses the supplied demo scripts that proxy the state of the Solaris Service Management Facility (SMF) system log. See Oracle Solaris Cluster Generic Data Service (GDS) Guide for more information about GDSv2 demo applications.
# clresourcegroup create -p pathprefix=/opt/ORCLscgds/demo -S mysrg # clresource create -g mysrg -t ORCL.gds_proxy \ # -p Prenet_start_command="%RG_PATHPREFIX/demo_proxy_prenet_start -R %RS_NAME -G %RG_NAME -T %RT_NAME" \ # -p Postnet_stop_command="%RG_PATHPREFIX/demo_proxy_postnet_stop -R %RS_NAME -G %RG_NAME -T %RT_NAME" \ # -p Validate_command="%RG_PATHPREFIX/demo_validate -R %RS_NAME -G %RG_NAME \ # -T %RT_NAME" -d mysrs # clresourcegroup online -eM mysrg # clresource status mysrs
See attributes (5) for descriptions of the following attributes:
|
ORCL.gds(5), clreslogicalhostname(1CL), clresource(1CL), clresourcegroup(1CL), clresourcetype(1CL), clressharedaddress(1CL), rt_callbacks(1HA), scdsbuilder(1HA), scha_control(1HA), scha_resource_get(1HA), hatimerun(1M), pmfadm(1M), signal (3HEAD) , rt_reg(4), attributes (5) , r_properties(5), scalable_service(5)