APPLIES TO:

Solaris Cluster - Version 3.0 and later

All Platforms

GOAL

The Generic Data Service (GDS) is a mechanism for making simple applications highly
available or scalable by plugging them into the Solaris Cluster Resource Group
Management framework. Prior to Solaris Cluster 3.1 update 3 (9/04), the GDS model
assumed that all applications would be network aware. This document shows how to
register GDS for non-network aware applications pre Solaris Cluster 3.1 update 3 and
also covers a new property available since this release.

FIX

1. Introduction

There are two required properties for GDS resource type at resource creation:

 Start_command
 Port_list

However non-network-aware application does not have a listening port, which means
no port can be filled in for the "Port_list" property.
For Solaris Cluster version prior to 3.1u3 workaround is to leverage some well-known
ports of solaris, such as 7/tcp, 23/tcp. Use of Port 7/tcp is highly recommended, as port
7/tcp has been tested.

2. Register non network aware GDS on pre Solaris Cluster 3.1u3

Register the resource type SUNW.gds:

# scrgadm -a -t SUNW.gds

Create the resource group:

# scrgadm -a -g test-rg -h node1,node2

Create the resource:

# scrgadm -a -j test-res -g test-rg -t SUNW.gds \
-y Port_list=7/tcp\
-x Start_command=/App/appscripts/start.sh \
-x Stop_command=/App/appscripts/stop.sh

Bring the resource group online:

# scswitch -Z -g test-rg

If security reason require to harden systems and close some well-known ports such as
7/tcp, 23/tcp, another choice is to disable port monitoring by using an alternate probe
script.

Register the resource type SUNW.gds:

# scrgadm -a -t SUNW.gds

Create the resource group:

# scrgadm -a -g test-rg -h node1,node2

Create the resource for the failover service itself:

# scrgadm -a -j test-res -g test-rg -t SUNW.gds \
-y Port_list=7/tcp\
-x Start_command=/App/appscripts/start.sh \
-x Stop_command=/App/appscripts/stop.sh \
-x Probe_command=/usr/bin/true

Bring the resource group online:

# scswitch -Z -g test-r

3. Register non network aware GDS starting Solaris Cluster 3.1u3

Starting Cluster 3.1 update 3, there is a new property available for SUNW.gds resource
type:

 Network_aware=<boolean>

Setting this property equal to 'false' (default is 'true') means Port_List property does not
have to be set.

Below example will shows both Solaris Cluster pre 3.2 (sc* command) and post 3.2 (cl*
command) command.
Register the resource type SUNW.gds:
# scrgadm -a -t SUNW.gds
or
# clrt register SUNW.gds

Create the resource group:

# scrgadm -a -g test-rg -h node1,node2
or
# clrg create -n node1,node2 test-rg

Create the resource:

# scrgadm -a -j test-res -g test-rg -t SUNW.gds \
-x Start_command=/App/appscripts/start.sh \
-x Stop_command=/App/appscripts/stop.sh \
-x Probe_command=/usr/bin/true \
-x Network_aware=false
or
# clrs create -t SUNW.gds -g test-rg \
-p Start_command=/App/appscripts/start.sh \
-p Stop_command=/App/appscripts/stop.sh \
-p Probe_command=/usr/bin/true \
-p Network_aware=false

Notice that the setting Port_List does not have to be set.

Bring the resource group online:

# scswitch -Z -g test-rg
or
# clrg online test-rg

Product
Sun Cluster 3.1
Sun Cluster 3.0
Sun Cluster 3.0 7/01
Sun Cluster 3.0 5/02
Sun Cluster 3.0 12/01
Solaris Cluster 3.2