Sun Cluster 3.0 5/02 Supplement

Registering and Configuring Sun Cluster HA for Sybase ASE

The following change was introduced in the Sun Cluster 3.0 5/02 update release and applies to this update and all subsequent updates to Sun Cluster 3.0 software.Use the procedures in this section to register and configure the Sun Cluster HA for Sybase ASE data service. Register and configure Sun Cluster HA for Sybase ASE as a failover data service.

How to Register and Configure Sun Cluster HA for Sybase ASE (5/02)

The following change was introduced in the Sun Cluster 3.0 5/02 update release and applies to this update and all subsequent updates to Sun Cluster 3.0 software.This procedure describes how to use the scrgadm(1M) command to register and configure Sun Cluster HA for Sybase ASE.

This procedure includes creating the HAStoragePlus resource type. This resource type synchronizes actions between HAStorage and Sun Cluster HA for Sybase ASE and enables you to use a highly available local file system. Sun Cluster HA for Sybase ASE is disk-intensive, and therefore you should configure the HAStoragePlus resource type.

See the SUNW.HAStoragePlus(5) man page and "Relationship Between Resource Groups and Disk Device Groups" on page 5 for more information about the HAStoragePlus resource type.

only -

Other options also enable you to register and configure the data service. See "Tools for Data Service Resource Administration" on page 10 for details about these options.

To perform this procedure, you must have the following information.

The names of the cluster nodes that master the data service.
The network resource that clients use to access the data service. You typically configure the IP address when you install the cluster. See the sections in the Sun Cluster 3.0 12/01 Software Installation Guide on planning the Sun Cluster environment and on how to install the Solaris operating environment for details.
The path to the Sybase ASE application installation.

only -

Perform the following steps on one cluster member.

Become superuser on a cluster member.

Run the scrgadm command to register resource types for Sun Cluster HA for Sybase ASE.
# scrgadm -a -t SUNW.sybase
-a

Adds the resource type for the data service.

-t SUNW.sybase

Specifies the resource type name that is predefined for your data service.

Create a failover resource group to hold the network and application resources.

You can optionally select the set of nodes on which the data service can run with the -h option, as follows.
# scrgadm -a -g resource-group [-h nodelist]
-g resource-group

Specifies the name of the resource group. This name can be your choice but must be unique for resource groups within the cluster.

-h nodelist

Specifies an optional comma-separated list of physical node names or IDs that identify potential masters. The order here determines the order in which the nodes are considered as primary during failover.

only -
Use the -h option to specify the order of the node list. If all of the nodes that are in the cluster are potential masters, you do not need to use the -h option.

Verify that all of the network resources that you use have been added to your name service database.

You should have performed this verification during the Sun Cluster installation.

only -
Ensure that all of the network resources are present in the server's and client's /etc/hosts file to avoid any failures because of name service lookup.

Add a network resource to the failover resource group.
# scrgadm -a -L -g resource-group -l logical-hostname [-n netiflist]
-l logical-hostname

Specifies a network resource. The network resource is the logical hostname or shared address (IP address) that clients use to access Sun Cluster HA for Oracle.

[-n netiflist]

Specifies an optional, comma-separated list that identifies the NAFO groups on each node. All of the nodes in nodelist of the resource group must be represented in the netiflist. If you do not specify this option, scrgadm(1M) attempts to discover a net adapter on the subnet that the hostname list identifies for each node in nodelist. For example, -n nafo0@nodename, nafo0@nodename2.

Create the resource sybase-hastp-rs of type HAStoragePlus.

# scrgadm -a -j sybase-hastp-rs -g sybase-rg \
-t SUNW.HAStoragePlus \
-x GlobalDevicePaths=sybase-set1,/dev/global/dsk/dl \
-x FilesystemMountPoints=/global/sybase-inst \
-x AffinityOn=TRUE

only -

AffinityOn must be set to TRUE and the local file system must reside on global disk groups to be failover.

Run the scrgadm command to complete the following tasks and bring the resource group sybase-rg online on a cluster node.
- Move the resource group into a managed state.
- Bring the resource group online
This node will be made the primary for device group sybase-set1 and raw device /dev/global/dsk/d1. Device groups associated with file systems such as /global/sybase-inst will also be made primaries on this node.
# scrgadm -Z -g sybase-rg

Create Sybase ASE application resources in the failover resource group.

# scrgadm -a -j resource -g resource-group \
-t SUNW.sybase \ 
-x Environment_File=environment-file-path \
-x Adaptive_Server_Name=adaptive-server-name \
-x Backup_Server_Name=backup-server-name \
-x Text_Server_Name=text-server-name \
-x Monitor_Server_Name=monitor-server-name \
-x Adaptive_Server_Log_File=log-file-path \
-x Stop_File=stop-file-path \
-x Connect_string=user/passwd \
-y resource_dependencies=storageplus-resource

-j resource: Specifies the resource name to add.
-g resource-group: Specifies the name of the resource group into which the RGM places the resources.
-t SUNW.sybase: Specifies the resource type to add.
-x Environment_File=environment-file: Sets the name of the environment file.
-x Adaptive_Server_Name=adaptive-server-name: Sets the name of the adaptive server.
-x Backup_Server_Name=backup-server-name: Sets the name of the backup server.
-x Text_Server_Name=text-server-name: Sets the name of the text server.
-x Monitor_Server_Name=monitor-server-name: Sets the name of the monitor server.
-x Adaptive_Server_Log_File=monitor-server-name: Sets the path to the log file for the adaptive server.
-x Stop_File=stop-file-path: Sets the path to the stop file.
-x Connect_string=user/passwd: Specifies the user and password that the fault monitor uses to connect to the database.

You do not have to specify extension properties that have default values. See "Configuring Sun Cluster HA for Sybase ASE Extension Properties" in the Sun Cluster 3.0 12/01 Data Services Installation and Configuration Guide for more information.

Run the scswitch(1M) command to complete the following task.
- Enable the resource and fault monitoring.
# scswitch -Z -g resource-group
.

Where to Go From Here

After you register and configure Sun Cluster HA for Sybase ASE, go to "How to Verify the Sun Cluster HA for Sybase ASE Installation" in the Sun Cluster 3.0 12/01 Data Services Installation and Configuration Guide.