Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### scdscreate

- create an Oracle Solaris 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 (clientless) 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 an Oracle Solaris 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 directory. 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 `scdscreate`.

## Attributes

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

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | `ha-cluster/developer/api`
Interface Stability | Evolving

## See Also

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

Oracle Solaris Cluster Data Services Developer’s Guide

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |