scdscreate(1HA) 					       Sun Cluster Commands						   scdscreate(1HA)

NAME

       scdscreate - create a Sun Cluster resource type template

SYNOPSIS

       scdscreate  -V vendor_id -T resource_type_name -a [-s]
       [-n RT_version] [-d working_directory] [-k |  -g]

DESCRIPTION

       The  scdscreate	command creates a template for making an application highly available (HA) or scalable. This command enables you to create
       C-, Generic Data Service (GDS)-, or Korn shell-based templates for both network aware (client-server model) and non-network aware  (client-
       less) applications.

       You can create the template in one of two fundamentally different ways:

       GDS			   scdscreate creates a set of three driving scripts that work from a single resource type SUNW.gds, which is pre-
				   installed on the cluster. These scripts are named startRT_Name,  stopRT_Name,  and  removeRT_Name  and  starts,
				   stops,  and removes an instance of that application. In this model, the implementation of the SUNW.gds resource
				   type that is pre-installed on the cluster is immutable.

       Generated Source Code	   scdscreate creates a template for a Sun Cluster resource type, whose instantiations run under  the  control	of
				   the Resource Group Manager (RGM) to make the given application highly available and scalable.

       Either model can create templates for network aware (client-server model) and non-network aware (client-less) applications.

       scdscreate  creates  a  directory  of  the  form $vendor_id$resource_type_name under working_directory. This directory contains the driving
       scripts, or the generated source, binary, and package files for the resource type. scdscreate also creates a configuration file,  rtconfig,
       in  which  you can store configuration information for the resource type. scdscreate allows you to create only one resource type per direc-
       tory. You must create different resource types in different directories.

OPTIONS

       The following options are supported:

       -a			   This parameter specifies that the resource type that is being created is not network aware. scdscreate disables
				   all the networking related code in the template that is created.

       -n RT_version		   This optional parameter specifies the version of the generated resource's type. If you omit this parameter, and
				   you're creating a C- or Korn shell-based application, the text string 1.0 is used by default. If you omit  this
				   parameter,  and  you're  creating a GDS-based application, the RT_version string of the GDS is used by default.
				   The RT_version distinguishes between multiple registered versions, or upgrades, of the same base resource type.

				   You cannot include the following characters in RT_version: blank, tab, slash (/), backslash (), asterisk  (*),
				   question mark (?), comma (,), semicolon (;), left square bracket ([), or right square bracket (]).

       -d working_directory	   Creates  the  template  for the resource type in a directory other than the current directory. If you omit this
				   argument, scdscreate creates the template in the current directory.

       -g			   This optional parameter generates the GDS-based form of the template to make an application highly available or
				   scalable.

       -k			   This optional parameter generates source code in Korn shell command syntax rather than in C. See ksh(1).

       -s			   This  optional parameter indicates that the resource type is scalable. You can configure an instance (resource)
				   of a scalable resource type into a failover resource group, and hence, turn off the scalability feature. If you
				   omit this argument, scdscreate creates the template for a failover resource type.

       -T resource_type_name	   The	resource  type	name and resource type version, in conjunction with the vendor ID, uniquely identifies the
				   resource type that is being created.

       -V vendor_id		   The vendor ID is typically the stock symbol, or some other identifier  of  the  vendor  that  is  creating  the
				   resource type. scdscreate affixes the vendor ID, followed by a period (.) to the beginning of the resource type
				   name. This syntax ensures that the resource type name remains unique if more than  one  vendor  uses  the  same
				   resource type name.

EXIT STATUS

       0		   The command completed successfully.

       nonzero		   An error occurred.

FILES

       working_directory/rtconfig	   Contains information from the previous session and facilitates the quit and restart feature of scdscre-
					   ate.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ksh(1), scdsbuilder(1HA), scdsconfig(1HA), attributes(5), rt_properties(5)

       Sun Cluster Data Services Developer's Guide for Solaris OS

Sun Cluster 3.2 						    26 May 2004 						   scdscreate(1HA)