test

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

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.

Note –

The Sun Java System Application Server can be configured to run in a whole root or a sparse root non-global zone, if required.

Note –

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

ProcedureHow 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.

  1. On a cluster member, become superuser or assume a role that provides solaris.cluster.modify and solaris.cluster.admin RBAC authorization.

  2. Create a failover resource group to contain the DAS application resources and the network resource that DAS uses.

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


    # clresourcegroup create [-n node-zone-list] DAS-resource-group
    DAS-resource-group

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

    [-n node-zone-list]

    Specifies a comma-separated, ordered list of zones that can master this resource group. The format of each entry in the list is node. In this format, node specifies the node name and zone specifies the name of a non-global Solaris zone. To specify the global zone, or to specify a node without non-global zones, specify only node.

    This list is optional. If you omit this list, the global zone of each cluster node can master the resource group.

  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.


    # clreslogicalhostname create -g DAS-resource-group -h IP-address IP-address
    -g DAS-resource-group

    Specifies the name of the DAS resource group.

    -h IP-address

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

    Note –

    If you require a fully qualified hostname, you must specify the fully qualified name with the -h option and you cannot use the fully qualified form in the resource name.

  4. Bring online the DAS resource group.

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


    # clresourcegroup online DAS-resource-group
    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.


    # clresourcegroup create [-n node-zone-list NA-resource-group]

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


    # clreslogicalhostname create -g NA-resource-group -h logical-hostname logical-hostname
    Note –

    If you require a fully qualified hostname, you must specify the fully qualified name with the -h option and you cannot use the fully qualified form in the resource name.

  7. Bring online the Node Agents resource groups.

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


    # clresourcegroup online NA-resource-group

ProcedureHow to Install and Configure the Sun Java System Application Server

  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 DAS HTTP, HTTPS, IIOP, and all other listener addresses to the failover IP address that you intend to use in the Sun Cluster DAS resource.

    Note –

    Before you modify the file domain.xml, remember to stop all the instances of DAS and Node Agents.

  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.