scdsconfig(1HA) Sun Cluster Commands scdsconfig(1HA)
NAME
scdsconfig - configure resource type template
SYNOPSIS
scdsconfig -s start_command [-u start_method_timeout]
[-e validate_command] [-y validate_method_timeout]
[-t stop_command] [-v stop_method_timeout] [-m probe_command]
[-n probe_timeout] [-d working_directory]
DESCRIPTION
The scdsconfig command configures the resource type template that you created with the scdscreate(1HA) command. The scdsconfig command
enables you to configure C, Generic Data Service (GDS), or Korn shell-based templates for both network aware (client-server model) and non-
network aware (clientless) applications.
The scdsconfig command configures application-specific commands to start, stop, validate, and probe the application. You can also use the
scdsconfig command to set timeout values for the start, stop, validate, and probe commands. The scdsconfig command supports both network
aware (client-server model) and non-network aware (clientless) applications. You can run the scdsconfig command from the same directory
where the scdscreate command was run. You can also specify that same directory by using the -d option. The scdsconfig command configures
the resource type template by placing the user-specified parameters at correct locations in the generated code. If C was the type of gener-
ated source code, this command also compiles the code. The scdsconfig command puts the output into a Solaris package that you can then
install. This command creates the package in the pkg subdirectory under the $vendor_id$resource_type_name directory created by the scdscre-
ate command.
OPTIONS
The following options are supported:
-d working_directory Specifies the directory where the scdscreate command was run.
You must specify this option if you run the scdsconfig command from a directory other than the directory where
the scdscreate command was run.
-e validate_command Specifies the absolute path to a command to invoke to validate the application. If you do not specify an abso-
lute path, the application is not validated. The validate_command returns with an exit status of 0 if the
application is running successfully. An exit status other than 0 indicates that the application is failing to
perform correctly. In this case, one of two results occur, depending on the failure history of the application
in the past:
o The resources of this resource type are either restarted on the same node or zone.
o The resource group that contains the resource has failed over to another healthy node or zone.
-m probe_command Specifies a command to periodically check the health of the network aware or non-network aware application. It
must be a complete command line that can be passed directly to a shell to probe the application. The probe_com-
mand returns with an exit status of 0 if the application is running successfully. An exit status other than 0
indicates that the application is failing to perform correctly. In this case, one of two results occur,
depending on the failure history of the application in the past:
o The resources of this resource type are either restarted on the same node or zone.
o The resource group that contains the resource is failed over to another healthy node or zone.
-n probe_timeout Specifies the timeout, in seconds, for the probe command. The timeout must take into account system overloads
to prevent false failures. The default value is 30 seconds.
-s start_command Specifies the command that starts the application. The start command must be a complete command line that can
be passed directly to a shell to start the application. You can include command-line arguments to specify host
names, port numbers, or other configuration data that is necessary to start the application. To create a
resource type with multiple independent process trees, you specify a text file that contains the list of com-
mands, one per line, to start the different process trees.
-t stop_command Specifies the stop command for the application. The stop command must be a complete command line that can be
passed directly to a shell to stop the application. If you omit this option, the generated code stops the
application by issuing signals. The stop command is allotted 80 percent of the timeout value to stop the appli-
cation. If the stop command fails to stop the application within this period, a SIGKILL is allotted 15 percent
of the timeout value to stop the application. If SIGKILL also fails to stop the application, the stop method
returns with an error.
-u start_method_timeout Specifies the timeout, in seconds, for the start command. The timeout must take into account system overloads
to prevent false failures. The default value is 300 seconds.
-v stop_method_timeout Specifies the timeout, in seconds, for the stop command. The timeout must take into account system overloads to
prevent false failures. The default value is 300 seconds.
-y validate_method_timeout Specifies the timeout, in seconds, for the validate command. The timeout must take into account system over-
loads to prevent false failures. The default value is 300 seconds.
EXIT STATUS
The following exit status codes are returned:
0 The command completed successfully.
nonzero An error occurred.
FILES
working_directory/rtconfig Contains information from the previous session. Facilitates the tool's quit and restart feature.
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), scdscreate(1HA), attributes(5)
Sun Cluster 3.2 27 Mar 2006 scdsconfig(1HA)