Sun Cluster Data Service for Sun Java System Application Server Guide for Solaris OS

ProcedureHow to Register and Configure the Sun Cluster HA for Sun Java System Application Server as a Failover Data Service

Perform the following steps to complete a Sun Cluster HA for Sun Java System Application Server failover configuration. You can also use this procedure to configure a domains administrative server to be a failover resource.

Note that in How to Configure and Activate Network Resources for a Failover Configuration you created the failover resource group, added a logical hostname to the resource group, and brought the resource group online.

Steps
  1. Become superuser on a cluster member.

  2. Register the resource type for the data service.


    # scrgadm -a -t SUNW.s1as
    
    -a

    Adds the data service resource type

    -t SUNW.s1as

    Specifies the predefined resource type name

  3. Add the Sun Java System Application Server resource instance to the failover resource group that you created for your network resources.


    # scrgadm -a -j resource -g resource-group \
    -t SUNW.s1as \
    y Network_resources_used=network-resources \
    y Port_list=port/tcp,port/tcp \
    x Confdir_list=install-directory/domains/domain/server \
    x Monitor_Uri_List=http://logical-hostname[:port][/path]
    
    -j resource

    Specifies the Sun Java System Application Server application resource name.

    -g resource-group

    Specifies the resource group.

    -t SUNW.s1as

    Specifies the type of resource to add.

    -y Network_resources_used=network-resources

    Specifies a comma-separated list of network resources in resource-group.

    -y Port_list=port-number/protocol

    Specifies a comma-separated list of the port number and the protocol to be used, for example, 80/tcp. If the Monitor_Uri_List is set, the Port_list setting is optional.

    -x Confdir_list=install-directory/domains/domain/server

    Specifies a path for your Sun Java System Application Server configuration directory. The Confdir_list extension property is required and must have exactly one entry.

    -x Monitor_Uri_List=logical-hostname[:port][/path]

    Specifies a comma-separated list of URIs from which Sun Cluster HA for Sun Java System Application Server makes requests. The Monitor_Uri_List extension property is required if the Port_list property is not set.

  4. Verify that the resource group and application server resource is online.


    # scstat -g
    # ps -ef
    

Example 2–1 Registering and Configuring Sun Cluster HA for Sun Java System Application Server as a Failover Data Service

Cluster Information

  1. To create a failover resource group, the following command is run.


    # scrgadm -a -g appsrv-rg -h phys-schost-1,phys-schost-2
    
  2. To add a logical hostname resource to the resource group, the following command is run.


    # scrgadm -a -L -g appsrv-rg -l schost-1
    
  3. To register the SUNW.s1as resource type, the following command is run.


    # scrgadm -a -t SUNW.s1as
    
  4. To create a Sun Java System Application Server resource and add it to the resource group, the following command is run.


    # scrgadm -a -j appsrv-rs -g appsrv-rg \
    -t SUNW.s1as \
    -y Network_resources_used=schost-1 \
    -y Port_list=80/tcp,3700/tcp \
    -x Confdir_list=/global/appsrv/domains/scdomain/server1 \
    -x Monitor_Uri_List=http://schost-1:80/servlet/monitor
    
  5. To bring the application resource group online, the following command is run.


    # scswitch -Z -g appsrv-rg
    


Example 2–2 Registering and Configuring the admin-server as a Failover Data Service

This example shows how the admin-server can be configured as part of the failover resource group created in the above example.

Cluster Information

To create a Sun Java System Application Server resource and add it to the resource group, the following command is run.


# scrgadm -a -j admin-rs -g appsrv-rg \
-t SUNW.s1as \
-y Network_resources_used=schost-1 \
-y Port_list=4848/tcp \
-x Confdir_list=/global/appsrv/domains/scdomain/admin-server \
-x Monitor_Uri_List=http://schost-1:484