Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for scdscreate (opensolaris section 1ha)

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

scdscreate - create a Sun Cluster resource type template
scdscreate -V vendor_id -T resource_type_name -a [-s] [-n RT_version] [-d working_directory] [-k | -g]
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.
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.
0 The command completed successfully. nonzero An error occurred.
working_directory/rtconfig Contains information from the previous session and facilitates the quit and restart feature of scdscre- ate.
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWscdev | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+
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)