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)