Sun Cluster 3.0 5/02 Supplement

Using the SunPlex Agent Builder to Create a Service Using GDS

You can use the SunPlex Agent Builder to create the service that uses the GDS. See the Sun Cluster 3.0 12/01 Data Services Installation and Configuration Guide for information on the SunPlex Agent Builder as well as a definition of the fields.

Creating a Service Using GDS in the Agent Builder

Bring up the SunPlex Agent Builder.
# /usr/cluster/bin/scdsbuilder

The SunPlex Agent Builder panel appears.

Enter the Vendor Name.

Enter the Application Name.

only -
The combination of Vendor and Application Name may not contain more than nine characters. It will be used as the name of the package for the driving scripts.

Enter the Working Directory. You can use the Browse pulldown to select the directory rather than typing the path.

Select whether the data service is scalable or failover.

You do not need to select Network Aware since that is the default when creating the GDS.

Select GDS.

Click the Create button to create the driving scripts.

The SunPlex Agent Builder panel displays the results of the creation of the service. The Create button is grayed out and the Next button is now available.

Configuring the Driving Scripts

After creating the driving scripts, you need to use the SunPlex Agent Builder to configure the new service.

Click the Next button and the configuration panel appears.

Either enter the location of the Start command or use the browse button to locate the Start command.

(Optional) Enter the Stop command or use the browse button to locate the Stop command.

(Optional) Enter the Probe command or use the browse button to locate the Probe command.

(Optional) Specify the timeout values for the Start, Stop, and Probe commands.

Click Configure to start the configuration of the driving scripts.

A package for driving scripts will be created and placed in:
working-dir/<vendor_name><application>/pkg
For example, /export/wdir/NETapp/pkg.

only -
The package name consists of a concatenation of the Vendor Name and Application Name.

Install the completed package on all nodes of the cluster.
# cd /export/wdir/NETapp/pkg # pkgadd -d . NETapp

The following files will be installed during the pkgadd:

/opt/NETapp 
/opt/NETapp/README.app 
/opt/NETapp/man 
/opt/NETapp/man/man1m 
/opt/NETapp/man/man1m/removeapp.1m 
/opt/NETapp/man/man1m/startapp.1m 
/opt/NETapp/man/man1m/stopapp.1m 
/opt/NETapp/man/man1m/app_config.1m 
/opt/NETapp/util 
/opt/NETapp/util/removeapp 
/opt/NETapp/util/startapp 
/opt/NETapp/util/stopapp 
/opt/NETapp/util/app_config

only -

The man pages and script names will correspond to the Application Name you entered above preceded by the script name; for example, startapp.

To view the man pages, you need to specify the path to the man page. For example, to view the startapp man pages, use:

# man -M /opt/NETapp/man startapp

On one node of the cluster, configure the resources and start the application.

# /opt/NETapp/util/startapp -h <logichostname> -p <port and protocol list>

The arguments to the start script will vary according to the type of resource: failover or scalable. Check the customized man page or run the start script without any argument to get a usage statement.

# /opt/NETapp/util/startapp 
 The resource name of LogicalHostname or SharedAddress must be specified. 
 For failover services: 
 Usage: startapp -h <logical host name> 
           -p <port and protocol list> 
          [ -n <nafogroup/adapter list>] 
 For scalable services: 
 Usage: startapp 
          -h <shared address name> 
          -p <port and protocol list> 
          [ -l <load balancing policy>] 
          [-n <nafogroup/adapter list>] 
           [-w <load balancing weights>]

Output from SunPlex Agent Builder

The SunPlex Agent Builder generates three driving scripts and a configuration file based on input you provide. The configuration file specifies the names of the resource group and resource type.

The driving scripts are:

Start script: Used to configure the resources and start the application under RGM control.
Stop script: Used to stop the application and take down resources and resource groups.
Remove script: Used to remove the resources and resource groups created by the start script.

These driving scripts have the same interface and behavior as the utility scripts generated by the SunPlex Agent Builder for non-GDS-based agents. The scripts are packaged in a Solaris-installable package that can be reused across multiple clusters.

You can customize the configuration file to provide your own names for resource groups or other parameters that are normally given as inputs to the scrgadm command. If you do not customize the scripts, the SunPlex Agent Builder provides reasonable defaults for the scrgadm parameters.