Installing and Configuring Sun Java System Application Server

This section describes installation and configuration of the Sun Java System Application Server. Only the information that is specific to the Sun Cluster HA for Sun Java System Application Server is included here. See the Sun Java System Application Server documentation for detailed installation instructions, including patch requirements.

Before starting your installation, set the JMS-service entry in the domain.xml file to REMOTE.

How to Configure and Activate Network Resources

To enable the components in Sun Java System Application Server to run in Sun Cluster, you must set up the network resources for those components.

Steps

1. Become superuser on a cluster member.

2. Create a failover resource group to contain the Domain Administration Server (DAS) application resources and the network resource that DAS uses.

   The failover IP address is the network resource for the DAS resource.

   # scrgadm -a -g DAS-resource-group [-h nodelist]

   -g DAS-resource-group

   Specifies the name of the DAS resource group. This name can be your choice.

   [-h nodelist]

   Specifies an optional comma-separated list of physical node names that identify potential masters. The order here determines the order in which the nodes are considered primary during failover. If all of the nodes in the cluster are potential masters, you do not need to use the -h option.

3. Add the network resource to the DAS resource group.

   Use the following command to add the failover IP address to the DAS resource group.

   # scrgadm -a -L -g DAS-resource-group -l IP-address

   -L

   Specifies that a network resource is being added.

   -g DAS-resource-group

   Specifies the name of the DAS resource group.

   -l IP-address

   Specifies the failover IP address that is the network resource in this resource group.

4. Bring online the DAS resource group.

   Bringing online this resource group enables the failover IP address resource for DAS.

   # scswitch -Z -g DAS-resource-group

   -Z

   Moves the DAS resource group to the MANAGED state, and brings the resource group online. This command also enables the resources in the resource group.

   -g DAS-resource-group

   Specifies the name of the DAS resource group.

5. Create resource groups for the Node Agents and the network resources that the Node Agents use.

   To create a failover resource group for Node Agent, run the following command.

   # scrgadm -a -g NA-resource-group [-h nodelist]

6. Add the failover logical host name to the resource group.

   # scrgadm -a -L -g NA-resource-group -l logical-hostname

7. Bring online the Node Agents resource groups.

   Bringing online these resource groups enables the failover logical host resources for the Node Agents.

   # scswitch -Z -g NA-resource-group

How to Install and Configure the Sun Java System Application Server

Steps

1. Follow the instructions in the Sun Java System Application Server Installation and Administration Guide.

   The Sun Java System Application Server can be installed on the local file system or on the global file system.

2. When creating the domains, you must create the domain directory in the global file system.

   The extension property Domaindir for the SUNW.jsas resource type specifies the path to the domain directory. See SUNW.jsas Extension Properties.

3. When creating the Node Agents, you must create the Node Agents directory in the global file system.

4. After creating the domain, change all the DAS listener addresses to a failover IP address.

   In the server-config entry in the file domain.xml, change the Domain Administration Server HTTP, HTTPS, IIOP, and all other listener addresses to the failover IP address that you intend to use in the Sun Cluster DAS resource.

5. Configure the failover logical host names on which the server instances and Node Agents listen.

   When the Node Agents and Sun Java System Application Server instances are created, the physical node addresses are set by default in the file domain.xml. Therefore, you must change the physical addresses to the failover logical host names that you plan to use for the Node Agents.

   The file nodeagent.properties in the Node Agent configuration directory contains the entry agent.client.host=hostname, where hostname specifies the Sun Cluster node on which Node-Agent-name is configured to run, and where Node-Agent-name is the name of a particular Node Agent.