The following procedures explain how to use the Sun Cluster maintenance commands to register and configure the Sun Cluster HA for Sun Java System Application Server. These instructions explain how to set the extension properties described in Appendix A, Extension Properties for Sun Cluster HA for Sun Java System Application Server Supported Versions as of 9.1.
Sun Cluster HA for Sun Java System Application Server supported versions before 8.1, the data service can be configured in the following ways.
The data service is configured as a failover data service.
The data service is configured as a service that is mastered by multiple nodes or zones at the same time.
See Tools for Data Service Resource Administration in Sun Cluster Data Services Planning and Administration Guide for Solaris OS for general information about registering and configuring data services.
To perform these procedures, you need the following information about your configuration.
The resource type name for the Sun Cluster HA for Sun Java System Application Server data service. In Sun Cluster HA for Sun Java System Application Server supported versions before 8.1, the resource type is SUNW.s1as.
The names of the cluster nodes or zones that can master the data service.
If you configure Sun Cluster HA for Sun Java System Application Server as a failover data service, you must know the network resource that clients use to access the Sun Cluster HA for Sun Java System Application Server. Normally, you set up this network resource when you install the cluster.
The ports where the Sun Java System Application Server listens including HTTP and IIOP listeners.
The path to the server configuration data for the Sun Java System Application Server instance.
The sections that follow contain instructions for registering and configuring resources. These instructions explain how to set only extension properties that Sun Cluster HA for Sun Java System Application Server requires you to set. For information about all Sun Cluster HA for Sun Java System Application Server extension properties, see Appendix A, Extension Properties for Sun Cluster HA for Sun Java System Application Server Supported Versions as of 9.1. You can update some extension properties dynamically. You can update other properties, however, only when you create or disable a resource. The Tunable entry indicates when you can update a property.
To set an extension property of a resource, include the following option in the clresource(1CL) command that creates or modifies the resource:
-p property=value |
Identifies the extension property that you are setting
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.
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.
On a cluster member, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.
Register the resource type for the data service.
# clresourcetype register SUNW.s1as |
Add the Sun Java System Application Server resource instance to the failover resource group that you created for your network resources.
# clresource create -g resource-group \ -t SUNW.s1as \ -p Network_resources_used=network-resources \ -p Port_list=port/tcp,port/tcp \ -p Confdir_list=install-directory/domains/domain/server \ -p Monitor_Uri_List=http://logical-hostname[:port][/path] resource |
Specifies the resource group.
Specifies the type of resource to add.
Specifies a comma-separated list of network resources in resource-group.
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.
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.
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.
Specifies the Sun Java System Application Server application resource name.
The resource is created in the enabled state.
Verify that the resource group and application server resource is online.
# clresourcegroup status # ps -ef |
Cluster Information
Node names: phys-schost-1, phys-schost-2
Logical hostname: schost-1
Resource group: appsrv-rg (for all resources)
Resources: schost-1 (logical hostname) , appsrv-rs (Sun Java System Application Server application resource)
To create a failover resource group, the following command is run.
# clresourcegroup create -n phys-schost-1,phys-schost-2 appsrv-rg |
To add a logical hostname resource to the resource group, the following command is run.
# clreslogicalhostname create -g appsrv-rg -h schost-1 schost-1 |
To register the SUNW.s1as resource type, the following command is run.
# clresourcetype register SUNW.s1as |
To create a Sun Java System Application Server resource and add it to the resource group, the following command is run.
# clresource create -g appsrv-rg \ -t SUNW.s1as \ -p Network_resources_used=schost-1 \ -p Port_list=80/tcp,3700/tcp \ -p Confdir_list=/global/appsrv/domains/scdomain/server1 \ -p Monitor_Uri_List=http://schost-1:80/servlet/monitor appsrv-rs |
To bring the application resource group online, the following command is run.
# clresourcegroup online appsrv-rg |
This example shows how the admin-server can be configured as part of the failover resource group created in the previous example.
Cluster Information
Logical hostname: schost-1
Resource group: appsrv-rg (for all resources)
Resources: schost-1 (logical hostname), admin-rs
To create a Sun Java System Application Server resource and add it to the resource group, the following command is run.
# clresource create -g appsrv-rg \ -t SUNW.s1as \ -p Network_resources_used=schost-1 \ -p Port_list=4848/tcp \ -p Confdir_list=/global/appsrv/domains/scdomain/admin-server \ -p Monitor_Uri_List=http://schost-1:484 admin-rs |
This procedure assumes that you installed the data service package during your initial Sun Cluster HA for Sun Java System Application Server installation. If you did not install the Sun Java System Application Server package as part of your initial installation, go to Installing the Sun Cluster HA for Sun Java System Application Server Packages to install the data service package.
Before you begin to register and configure Sun Cluster HA for Sun Java System Application Server as a service mastered on multiple nodes at the same time, consider the following requirements.
You must have the Sun Java System Web Server Plugin installed and configured. See Configuring the Sun Java System Web Server Plugin.
You must specify at least one entry for the Monitor_URI_List extension property. If there are no deployed applications that need to be monitored, use a simple Uniform Resource Identifier (URI) such as http://localhost/.
See Multiple Masters Configuration Overview for conceptual information related to this procedure.
Do not use the Sun Java System Application Server command-line or GUI administrative tools to start or stop the Sun Java System Application Server instances. The Sun Java System Application Server administrative server might not display the correct status of an application server instance that is configured as a service mastered on multiple nodes.
On one of the nodes in the cluster that hosts the application server, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization.
Add a scalable resource group for the Sun Java System Application Server.
# clresourcegroup create [-n node-zone-list] \ -p Maximum_primaries=value \ -p Desired_primaries=value resource-group |
Register the resource type for the Sun Java System Application Server.
# clresourcetype register SUNW.s1as |
Add the Sun Java System Application Server resource instance to the resource group.
# clresource create -g resource-group -t SUNW.s1as \ -p Confdir_list=install-directory/domains/domain/server \ -p Monitor_Uri_List=http://localhost[:port][/path] resource |
Specifies the type of resource to add.
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.
Specifies URIs from which Sun Cluster HA for Sun Java System Application Server makes requests. The Monitor_Uri_List extension property is required.
Specifies the Sun Java System Application Server application resource name.
The resource is created in the enabled state.
Bring the scalable resource group online.
# clresourcegroup online resource-group |
This example shows how to register Sun Cluster HA for Sun Java System Application Server as a service mastered on two nodes at the same time.
Cluster Information
Node names: phys-schost-1, phys-schost-2
Resource group: appsrv-rg (for all resources)
To create a scalable resource group, the following command is run.
# clresourcegroup create -n phys-schost-1,phys-schost-2 \ -p Maximum_primaries=2 \ -p Desired_primaries=2 appserv-rg |
To register the SUNW.s1as resource type, the following command is run.
# clresourcetype register SUNW.s1as |
To create a Sun Java System Application Server resource and add it to the resource group, the following command is run.
# clresource create -g appsrv-rg -t SUNW.s1as \ -p Confdir_list=/global/appserver/domains/scdomain/server1 \ -p Monitor_Uri_List=http://localhost:8000/servlet/monitor appsrv-rs |
The resource is created in the enabled state.
To bring online the application resource group, the following command is run.
# clresourcegroup online appsrv-rg |