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)