Registering a Resource Type

A resource type provides specification of common properties and callback methods that apply to all of the resources of the given type. You must register a resource type before you create a resource of that type. For details about resource types, see Chapter 1, Planning for Sun Cluster Data Services.

An administrator can register a resource type for a zone cluster by specifying a resource type registration (RTR) file that resides inside the zone cluster. In other words, the file must be under the zone root path. The RTR file inside the zone cluster cannot have the Global_zone property set to TRUE. The RTR file inside the zone cluster cannot be of type RTR_LOGICAL_HOSTNAME or RTR_SHARED_ADDRESS.

The administrator can also register a resource type for a zone cluster from the location /usr/cluster/lib/rgm/rtreg. The administrator in the zone cluster cannot modify any RTR files in this directory. This enables registering system resource types for a zone cluster, even when the RTR file has one of the properties that cannot be set directly from the zone cluster. This process provides a secure way of delivering system resource types.

The resource types in the /usr/cluster/lib/rgm/rtreg directory are for the exclusive use of the global cluster.

How to Register a Resource Type

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the name for the resource type that you plan to register. The resource type name is an abbreviation for the data service name. For information about resource type names of data services that are supplied with Sun Cluster, see the release notes for your release of Sun Cluster.

1. On a cluster member, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.

2. Register the resource type.

   # clresourcetype register resource-type

   resource-type

   Specifies name of the resource type to add. See the release notes for your release of Sun Cluster to determine the predefined name to supply.

3. Verify that the resource type has been registered.

   # clresourcetype show

Example 2–1 Registering a Resource Type

The following example registers the SUNW.krb5 resource type, which represents the Sun Java System Web Server application in a Sun Cluster configuration.

# clresourcetype register SUNW.krb5
# clresourcetype show SUNW.krb5

Resource Type:                                  SUNW.krb5
RT_description:                                  HA-Kerberos KDC server for Sun Cluster
RT_version:                                      3.2
API_version:                                     6
RT_basedir:                                      /opt/SUNWsckrb5/bin
Single_instance:                                 False
Proxy:                                           False
Init_nodes:                                      All potential masters
Installed_nodes:                                 <All>
Failover:                                        True
Pkglist:                                         SUNWsckrb5
RT_system:                                       False

Next Steps

After registering resource types, you can create resource groups and add resources to the resource group. For details, see Creating a Resource Group.

See Also

The following man pages:

• clresourcetype(1CL)

• clresourcegroup(1CL)

• clresource(1CL)