Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Cluster Data Service for Sun Java System Application Server Guide Oracle Solaris Cluster |
Oracle Solaris Cluster HA for Sun Java System Application Server Overview
Failover Configuration Overview
Multiple Masters Configuration Overview
Configuration Planning Questions
Installing and Configuring Application Server
How to Configure and Activate Network Resources for a Failover Configuration
How to Install and Configure the Application Server
Using the Application Server With HADB
Configuring the Sun Java System Web Server Plug-in
Installing the HA for Sun Java System Application Server Packages
Configuring the SUNW.HAStoragePlus Resource Type
Tuning the Fault Monitor for Oracle Solaris Cluster HA for Sun Java System Application Server
A. Extension Properties for HA for Sun Java System Application Server Supported Versions as of 9.1
B. Extension Properties for HA for Sun Java System Application Server Supported Versions Before 8.1
The following procedures explain how to use the Solaris Cluster maintenance commands to register and configure the Oracle Solaris Cluster HA for Sun Java System Application Server. These instructions explain how to set the extension properties described in Appendix A, Extension Properties for HA for Sun Java System Application Server Supported Versions as of 9.1.
Oracle Solaris 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.
Note - See Tools for Data Service Resource Administration in Oracle Solaris Cluster Data Services Planning and Administration Guide 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 Oracle Solaris Cluster HA for Sun Java System Application Server data service. In Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris Cluster HA for Sun Java System Application Server. Normally, you set up this network resource when you install the cluster.
The ports where the Application Server listens including HTTP and IIOP listeners.
The path to the server configuration data for the Application Server instance.
The sections that follow contain instructions for registering and configuring resources. These instructions explain how to set only extension properties that Oracle Solaris Cluster HA for Sun Java System Application Server requires you to set. For information about all Oracle Solaris Cluster HA for Sun Java System Application Server extension properties, see Appendix A, Extension Properties for 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 Oracle Solaris Cluster Data Services Planning and Administration Guide to configure resources after the resources are created.
Perform the following steps to complete a Oracle Solaris 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.
# clresourcetype register SUNW.s1as
# 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 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 Oracle Solaris 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 Application Server application resource name.
The resource is created in the enabled state.
# clresourcegroup status # ps -ef
Example 2-1 Registering and Configuring Oracle Solaris Cluster HA for Sun Java System Application Server as a Failover Data Service
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 (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 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
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 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 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 Oracle Solaris Cluster HA for Sun Java System Application Server installation. If you did not install the Application Server package as part of your initial installation, go to Installing the HA for Sun Java System Application Server Packages to install the data service package.
Before you begin to register and configure Oracle Solaris 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 Plug-in installed and configured. See Configuring the Sun Java System Web Server Plug-in.
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.
Note - Do not use the Application Server command-line or GUI administrative tools to start or stop the Application Server instances. The 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.
# clresourcegroup create [-n node-zone-list] \ -p Maximum_primaries=value \ -p Desired_primaries=value resource-group
# clresourcetype register SUNW.s1as
# 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 Application Server configuration directory. The Confdir_list extension property is required and must have exactly one entry.
Specifies URIs from which Oracle Solaris Cluster HA for Sun Java System Application Server makes requests. The Monitor_Uri_List extension property is required.
Specifies the Application Server application resource name.
The resource is created in the enabled state.
# clresourcegroup online resource-group
Example 2-3 Registering and Configuring Oracle Solaris Cluster HA for Sun Java System Application Server as a Service Mastered on Multiple Nodes
This example shows how to register Oracle Solaris 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 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