Declaring Resource Type Properties

The cluster administrator cannot configure the resource type properties you declare in the RTR file. They become part of the permanent configuration of the resource type.

One resource type property, Installed_nodes, is configurable by a system administrator. In fact, it is only configurable by a system administrator and you cannot declare it in the RTR file.

The syntax for resource type declarations is:

property_name = value;

The RGM treats property names as case insensitive. The convention for properties in Sun-supplied RTR files, with the exception of method names, is uppercase for the first letter of the name and lowercase for the rest of the name. Method names--as well as property attributes--contain all uppercase letters.

Following are the resource type declarations in the RTR file for a sample (smpl) data service:

# Sun Cluster Data Services Builder template version 1.0
# Registration information and resources for smpl
#
#NOTE: Keywords are case insensitive, i.e., you can use
#any capitalization style you prefer.
#
Resource_type = "smpl";
Vendor_id = SUNW;
RT_description = "Sample Service on Sun Cluster";

RT_version ="1.0"; 
API_version = 2;	 
Failover = TRUE;

Init_nodes = RG_PRIMARIES;

RT_basedir=/opt/SUNWsmpl/bin;

START						=		smpl_svc_start;
STOP						=		smpl_svc_stop;

VALIDATE 						=		smpl_validate;
UPDATE 						=		smpl_update;

MONITOR_START 							= 	smpl_monitor_start;
MONITOR_STOP 							= 	smpl_monitor_stop;
MONITOR_CHECK 						= 		smpl_monitor_check;

You must declare the Resource_type property as the first entry in the RTR file. Otherwise, registration of the resource type will fail.

The first set of resource type declarations provide basic information about the resource type, as follows:

• Resource_type and Vendor_id--Provide a name for the resource type. You can specify the resource type name with the Resource_type property alone (smpl) or using the Vendor_id as a prefix with a "." separating it from the resource type (SUNW.smpl), as in the sample. If you use Vendor_id, make it the stock symbol for the company defining the resource type. The resource type name must be unique in the cluster.

  ---

  Note -

  By convention, the resource type name (Resource_typeVendor_id) is used as the package name. Package names are limited to nine characters, so it is a good idea to limit the total number of characters in these two properties to nine or fewer characters, though the RGM does not enforce this limit. Agent Builder, on the other hand, explicitly generates the package name from the resource type name, so it does enforce the nine character limit.

  ---

• Rt_version--Identifies the version of the sample data service.

• API_version--Identifies the version of the API. API_version = 2, indicates that the data service runs under Sun Cluster version 3.0.

• Failover = TRUE--Indicates that the data service cannot run in a resource group that can be online on multiple nodes at once, that is, specifies a failover data service. See "Implementing a Failover Resource" for more information.

• START, STOP, VALIDATE, and so on--Provide the paths to the respective callback method programs called by the RGM. These paths are relative to the directory specified by RT_basedir.

The remaining resource type declarations provide configuration information, as follows:

• Init_nodes = RG_PRIMARIES--Specifies that the RGM call the INIT, BOOT, FINI, and VALIDATE methods only on nodes that can master the data service. The nodes specified by RG_PRIMARIES is a subset of all nodes on which the data service is installed. Set the value to RT_INSTALLED_NODES to specify that the RGM call these methods all nodes on which the data service is installed.

• RT_basedir--Points to /opt/SUNWsample/bin as the directory path to complete relative paths, such as callback method paths.

• START, STOP, VALIDATE, and so on--Provide the paths to the respective callback method programs called by the RGM. These paths are relative to the directory specified by RT_basedir.