Sun Cluster Data Service for Sun Java System Application Server EE (HADB) Guide for Solaris OS

Registering and Configuring the Sun Cluster HA for Sun Java System Application Server EE (HADB)

This procedure describes how to use the scrgadm command to register and configure Sun Cluster HA for Sun Java System Application Server EE (HADB) as a resource mastered on multiple nodes at one time.


Note –

See Tools for Data Service Resource Administration in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for details about additional options that enable you to register and configure the data service.


To perform this procedure, you need the following information about your configuration.

Setting Extension Properties for Sun Cluster HA for Sun Java System Application Server EE (HADB)

The sections that follow contain instructions for registering and configuring Sun Cluster HA for Sun Java System Application Server EE (HADB) resources. For information about the extension properties, see Appendix A, Properties for Sun Cluster HA for Sun Java System Application Server EE (Supporting HADB Versions as of 4.4). The Tunable entry indicates when you can update a property.

See Appendix A, Standard Properties, in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for details about all of the Sun Cluster properties.

To set an extension property of a resource, include the following option in the scrgadm(1M) command that creates or modifies the resource:


-x property=value 
-x property

Identifies the extension property that you are setting

value

Specifies the value to which you are setting the extension property

You can also use the procedures in Chapter 2, Administering Data Service Resources, in Sun Cluster Data Services Planning and Administration Guide for Solaris OS to configure resources after the resources are created.

ProcedureHow to Register and Configure Sun Cluster HA for Sun Java System Application Server EE (HADB)

Perform the following steps to complete your configuration.

Steps
  1. Become superuser on a cluster member.

  2. Register the resource type for Sun Java System Application Server EE (HADB).


    # scrgadm -a -t SUNW.hadb_ma
    
  3. Create the resource group for the Sun Java System Application Server EE (HADB) software.

    This resource group is configured to be mastered by multiple nodes at the same time.


    # scrgadm -a -g resource_group \
    -y Maximum_primaries=nodes_in_rg \
    -y Desired_primaries=nodes_in_rg \
    -h nodelist
    
    -a

    Specifies that a resource group is to be created.

    -g resource_group

    Specifies the name of the resource group that is to be created.

    -y Maximum_primaries=nodes_in_rg

    Specifies the maximum number of nodes on which the resource can start. You must specify the same number as the value of the Desired_primaries property.

    -y Desired_primaries=nodes_in_rg

    Specifies the desired number of nodes on which the resource can start. You must specify the same number as the value of the Maximum_primaries property.

    -h nodelist

    Specifies a comma-separated subset of cluster nodes to run the Sun Java System Application Server EE (HADB) software. If this option is omitted, all cluster nodes run Sun Java System Application Server EE (HADB). Use the scconf -p | less command to find the node list names.

  4. Create a resource for Sun Java System Application Server EE (HADB).

    See Appendix A, Properties for Sun Cluster HA for Sun Java System Application Server EE (Supporting HADB Versions as of 4.4) for a detailed description of the extension properties for this resource type.


    # scrgadm -a -j resource -g resource_group  -t SUNW.hadb_ma \
    -x HADBM_PASSWORDFILE=path_to_pw_file
    
    -a

    Specifies that a data service resource is to be created

    -j resource

    Specifies the name of the resource that you are creating

    -g resource_group

    Specifies the name of the resource group to which the resource is to be added

    -t SUNW.hadb_ma

    Specifies the predefined resource type name

    -x HADBM_PASSWORDFILE=path_to_pw_file

    Specifies the full path to the file containing the HADBM administrative password

    For details about the contents of the password file, see the Sun Java System Application Server documentation.

  5. Bring the resource group online.


    # scswitch -Z -g resource_group
    
    -Z

    Enables the resource and its monitor

    -g resource_group

    Specifies the name of the resource group that is to be brought online

  6. Verify that the resource group and HADB resource are online.


    # scstat -g
    # ps -ef
    
  7. To verify that you have correctly installed and configured Sun Cluster HA for HADB, run the following command.


    # hadbm status database_name --nodes
    

    The output should indicate that the database that you specified is running.


Example 1–1 Creating a SUNW.hadb_ma Resource

This example shows the creation of a SUNW.hadb_ma resource.

In this example the default values for the extension properties are used. The resource has the following characteristics:


scrgadm -a -j hadb-rs -g hadb-rg -t SUNW.hadb_ma \
-x HADBM_PASSWORDFILE=/global/disk1/hadbm-pwfile