JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Service for Oracle WebLogic Server Guide     Oracle Solaris Cluster 4.1
search filter icon
search icon

Document Information

Preface

1.  Installing and Configuring Oracle Solaris Cluster HA for WebLogic Server

Oracle Solaris Cluster HA for WebLogic Server Overview

Overview of the Installation and Configuration Process for Oracle Solaris Cluster HA for WebLogic Server

Planning the Oracle Solaris Cluster HA for WebLogic Server Installation and Configuration

Configuration Restrictions

Configuration Requirements

Standard Data Service Configurations

WebLogic Server Configured as a Failover Resource

Simple Configuration

Configuration 1

Configuration 2

Configuration 3

WebLogic Servers Configured as a Multi-Master Resource

WebLogic Servers Configured as Multi-Instance

Preparing the Nodes and Disks

How to Prepare the Nodes for a Failover Configuration

How to Prepare the Nodes for a Multi-Master Configuration

How to Prepare the Nodes for a Multi-Instance Configuration

Installing and Configuring the WebLogic Server Application

How to Install WebLogic Server

Installing a Database

Installing a Web Server

Verifying the WebLogic Server Installation and Configuration

How to Verify the WebLogic Server Installation and Configuration for Failover Services

How to Verify the WebLogic Server Installation and Configuration for Multi-Master Services

Installing the HA for WebLogic Server Package

How to Install the HA for WebLogic Server Package

Registering and Configuring the Oracle Solaris Cluster HA for WebLogic Server

Tools for Registering and Configuring Oracle Solaris Cluster HA for WebLogic Server

Using the clsetup Utility to Register and Configure the WebLogic Server Data Service

How to Configure Logical Host Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

How to Configure Storage Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as an Administration Server (clsetup)

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers (clsetup)

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Reverse Proxy Servers (clsetup)

Setting Oracle Solaris Cluster HA for WebLogic Server Extension Properties

How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as a Reverse Proxy Server (CLI)

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Failover Data Service (CLI)

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Multi-Master Data Service (CLI)

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Multi-Instance Data Service (CLI)

Setting Up the WebLogic Server for HAStoragePlus Configuration

How to Set Up the WebLogic Server on Zone Clusters for HAStoragePlus Configuration

Verifying the Oracle Solaris Cluster HA for WebLogic Server Installation and Configuration

How to Verify the Oracle Solaris Cluster HA for WebLogic Server Installation and Configuration for Failover Services

How to Verify the Oracle Solaris Cluster HA for WebLogic Server Installation and Configuration in a Multi-Master or Multi-Instance Configuration

Alternate Oracle Solaris Cluster HA for WebLogic Server Configurations

Creating a Simple WebLogic Server Resource

Creating a Resource With a Server Name Argument

Creating a Resource That Shuts Down Smoothly

Creating a Resource That Probes the Database

Creating a Resource That Monitors URIs

Using a Non-Clustered Managed Server Instance as a Proxy Server

Operation of the Oracle Solaris Cluster HA for WebLogic Server Fault Monitor

Probing Algorithm and Functionality

START Method

STOP Method

A.  HA for WebLogic Server Extension Properties

Index

Registering and Configuring the Oracle Solaris Cluster HA for WebLogic Server

This section contains the procedures that you need to configure Oracle Solaris Cluster HA for WebLogic Server.

Tools for Registering and Configuring Oracle Solaris Cluster HA for WebLogic Server

Oracle Solaris Cluster software provides the following tools for registering and configuring HA for WebLogic Server in the global cluster or in a zone cluster:

The clsetup utility provides a wizard for configuring HA for WebLogic Server. This wizard reduces the possibility for configuration errors that might result from command syntax errors or omissions. This wizard also ensures that all required resources are created and that all required dependencies between resources are set. For more information, see Using the clsetup Utility to Register and Configure the WebLogic Server Data Service.

Using the clsetup Utility to Register and Configure the WebLogic Server Data Service

The WebLogic Server data service configuration is a multiple step procedure, which the clsetup utility's WebLogic Server Configuration wizard enables you to perform by answering prompts. You do not need to run individual commands and set extension properties explicitly.

Use the clsetup utility's WebLogic Server Configuration wizards in the following order:

  1. How to Configure Logical Host Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

  2. How to Configure Storage Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

  3. How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as an Administration Server (clsetup)

  4. How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers (clsetup)

  5. How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Reverse Proxy Servers (clsetup)

How to Configure Logical Host Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

Use this procedure to configure logical hostname resources for Oracle Solaris Cluster HA for WebLogic Server.

Before You Begin

Before you run clsetup, ensure that the following tasks have been performed:

  1. Become root or a role with on any cluster node.
  2. Start the clsetup utility.
    # clsetup

    The clsetup main menu is displayed.

  3. Type the number for Data Services and press Return.

    The Data Services menu is displayed.

  4. Type the number for WebLogic Server and press Return.

    The clsetup utility displays a list of WebLogic server locations.

  5. Select the Global Cluster or Zone Cluster by typing the number that corresponds to the WebLogic Server location and press Return.

    If you specified a Zone Cluster, the clsetup utility displays a list of zone clusters.

    If you specified a Global Cluster, the clsetup utility displays a list of tasks you need to complete. Continue to Step 7.

  6. If you specified a Zone Cluster, type the number that corresponds to the zone cluster where you want to configure the WebLogic server and press Return.

    The WebLogic Server Configuration wizard displays a list of tasks you need to complete to create necessary resources.

  7. Type the number for Logical Hostnames, and press Return.

    The prerequisites for logical hostname configuration are displayed.

  8. Verify the prerequisites have been met and press Return.

    If you are configuring in a zone cluster, the zone cluster nodes are displayed.

    If you are configuring in a global cluster on Solaris 10, a list of global cluster nodes and zone nodes is displayed.

    If you are configuring on Solaris 11, the zone nodes are not supported and only the global cluster nodes are displayed.

  9. Select the nodes where you want Oracle Solaris Cluster HA for WebLogic Server to run.
    • To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
    • To select a subset of the listed nodes, type the numbers of the nodes with a space or comma between the numbers. Then press Return.

      Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.

    • To select all nodes in a particular order, type the numbers of the nodes in the order you want with a space or comma between the numbers. Then press Return.

      Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list.

  10. To confirm your selection of nodes, type d and press Return.

    The clsetup utility displays a screen where you can specify the logical hostname that the resource is to make available for the first node in the resource group.

  11. Type the logical hostname and press Return.

    The panel is re-displayed for each node that you added to the resource group, and you must type a unique name for each node.

    When you have provided each node with a logical hostname, the utility displays a review panel showing the resources and resource groups that are about to be created.

  12. In the review panel, do one of the following:
    • To confirm creation of the resource groups, type d and press Return.
    • To change the names of any resources or groups, type the number of the item in the list and press Return.

      The clsetup utility displays a new panel for changing the names. You can type the number for the name you want to change, and the utility prompts you to change the name.

      Type d and press Return to confirm the new names.

    The utility displays the Review Configuration of Logical Hostname Resources panel to display the resource name, resource group name, node list, and logical hostname that will be created.

  13. To create the configuration, type c and Press Return.

    When configuration is complete, the clsetup utility displays the commands that it ran to create the configuration.


    Note - The clsetup utility will roll back the changes if it fails to complete the logical host configuration process.


  14. Press Return to continue.

    The clsetup utility returns you to the list of options for configuring Oracle Solaris Cluster HA for WebLogic Server.

    Continue to the next task, How to Configure Storage Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup).

How to Configure Storage Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup)

These instructions assume that you are at the WebLogic Server Configuration list of options for configuring Oracle Solaris Cluster HA for WebLogic Server in the clsetup utility.

Before You Begin

You must complete How to Configure Logical Host Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup) before configuring storage resources.

  1. In the WebLogic Server Configuration panel, type the number corresponding to Storage and press Return.

    The clsetup utility reminds you that before you continue, you must ensure that the required volumes, disk groups, and file systems were already created.

  2. Press Return to continue with configuring highly available storage.

    The clsetup utility displays the available nodes in the cluster, and shows all the nodes as selected in an arbitrary order. You can specify particular nodes in an order of preference.

  3. Select the nodes where you want Oracle Solaris Cluster HA for WebLogic Server to run.
    • To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
    • To select a subset of the listed nodes, type the numbers of the nodes with a space or comma between the numbers. Then press Return.

      Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.

    • To select all nodes in a particular order, type the numbers of the nodes in the order you want, with a space or comma between the numbers. Then press Return.

      Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list.

  4. Type d and press Return when you are done specifying the nodes.
  5. Type the number for the type of shared storage you want to configure.

    If you are not sure whether to use a shared file system or shared device, type ? and press Return for information about the storage options.

    After you make a selection, the utility discovers existing file system mount points or storage devices and displays them for you to select.

  6. Type the number of the shared file system mount point or shared device and press Return.

    If you are not sure whether to use a shared file system or shared device, type ? and press Return for information about the storage options.

  7. In the review panel, do one of the following:
    • To confirm creation of the resources and groups, type d and press Return.
    • To change the names of any resources or groups, type the number of the item in the list and press Return.

      The clsetup utility displays a new panel for changing the names. You can type the number for the name you want to change, and the utility prompts you to change the name.

      Type d and press Return to confirm the new names.

    The utility displays the Review Configuration of Highly Available Storage Resources panel to display the resource name, resource group name, node list, file system mount points, and storage device groups that will be created.

  8. To create the configuration, type c and Press Return.

    The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.


    Note - The clsetup utility will roll back the changes if it fails to complete the storage configuration process.


  9. Press Return to continue.

    The clsetup utility returns you to the list of options for configuring Oracle Solaris Cluster HA for WebLogic Server.

    Continue to How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as an Administration Server (clsetup).

How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as an Administration Server (clsetup)

Use this procedure to configure Oracle Solaris Cluster HA for WebLogic Server for an Administration Server.

These instructions assume that you are at the WebLogic Server Configuration list of options for configuring Oracle Solaris Cluster HA for WebLogic Server in the clsetup utility.


Note - Before you start Oracle Solaris Cluster HA for WebLogic Server, if you are using a database, check that your database is accessible.


Before You Begin

You must complete How to Configure Storage Resources for Oracle Solaris Cluster HA for WebLogic Server (clsetup) before beginning this task.

  1. In the WebLogic Server Configuration panel, type the number for configuring the Administration Server and press Return.

    The utility displays information for you to verify the prerequisites that must be met before you try to configure the Administration Server.

  2. Press Return to continue.

    The utility prompts you to enter the location of the domain.

  3. Type the full path to the WebLogic domain directory and press Return.

    Type the complete path to the domain directory.

    The clsetup utility validates the path and then displays a panel for you to specify the WebLogic home directory location. The utility finds the home directory that is associated with the WebLogic domain that you entered, and displays this directory in the list.

  4. Specify the WebLogic home directory by doing one of the following:
    • Type the number of a directory in the list and press Return.
    • Type e and press Return, type the full path to the WebLogic home directory that you want to use, and press Return.

      The directory you specify must be accessible from each cluster node.

  5. Specify the full path to the start script for the WebLogic server and press Return.

    The clsetup utility supplies the default path to the script found in the WebLogic domain directory. You can press Return to accept this value or type a new path and press Return.

  6. Type the path to the WebLogic Server environment file and press Return.

    You can accept the default by pressing Return, or enter a new name. The environment file is typically $WEBLOGIC_HOME/server/bin/setWLSEnv.sh if WebLogic Server is configured through the installation wizard.

    The clsetup utility displays available logical host resources.

  7. Type the number of the logical hostname resource you want to use for the Administration Server and press Return.

    The logical hostname resource you choose is configured as the host for the administration server resource that is created. The administration server resource has a resource dependency on the logical hostname resource and an offline restart dependency on the storage resource. Both resources are configured in the same failover resource group.

    The clsetup utility prompts you to specify the optional monitoring URI. This URI can be used by the Fault Monitor to test the functionality of the Oracle WebLogic Server by doing an HTTP GET on the URI.

  8. Specify the optional monitoring URI as follows:
    • If you do not want to use a monitoring URI, press Return.
    • If you want to use a monitoring URI, type one or more URIs in the form http://path/to/monitor with commas separating multiple URIs, then press Return.

    The URIs will be validated against the configured logical host resources when the resource is created.

    The clsetup utility then displays highly available storage resources.

  9. Type the number of the storage resource to use for the Administration Server and press Return.

    The storage resources must contain the WebLogic home and domain directory.

    The storage resources displayed should be based on the WebLogic home directory value you specified earlier, but if clsetup cannot find any, all configured storage resources on the selected cluster are displayed instead.

    You can select one from the list, or proceed without selecting anything by typing d and pressing Return.

  10. Review the configuration information in the review panel for all the properties associated with the administration server.
    • Press Return to continue if the information is correct.
    • If necessary, you can edit the names of the administration server resources here by typing the numbers for these items from the list and pressing Return.
    • Type < to return to the wizard steps if you need to change any other information.

    After you press Return, the utility displays a summary of the information that will be used to create the configuration for the WebLogic Administration Server for your review. You cannot edit any of the values here except by typing < to return to the step where the value is specified.

  11. Type c and press Return to create the configuration.

    The utility displays the list of commands that are invoked on the cluster and also shows a status message indicating a success or failure. In the event that the configuration fails, a rollback is attempted.

  12. Press Return to exit the wizard for configuring the Administration Server.

    The clsetup utility returns to the WebLogic Server Configuration screen.

    Continue to How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers (clsetup) if you want to configure Managed Servers now.

  13. (Optional) Press Ctrl+D and type yes to exit the wizard, and then type q and press Return two times to quit the clsetup utility.

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers (clsetup)

These instructions assume that you are at the WebLogic Server Configuration list of options for configuring Oracle Solaris Cluster HA for WebLogic Server in the clsetup utility.

Use this procedure to configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers, using the clsetup utility. The utility starts a wizard to guide you through the creation of resource groups and resources for the managed server instances. The managed servers can be configured either in failover or multi-instance mode.


Note - If you want to configure the Managed Server instances in multi-master mode, you must use the procedure in How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Multi-Master Data Service (CLI). The clsetup wizards do not yet support multi-master configuration.


Before You Begin

You must perform the steps in How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as an Administration Server (clsetup) before configuring managed servers.

  1. In the WebLogic Server Configuration panel, type the number for the Managed Servers option, and press Return.

    The Verify Prerequisites screen lists the tasks that you should have already performed before you continue.

  2. Press Return to continue if all the prerequisites have been met.

    The utility prompts you to enter the location of the domain.

  3. Type the full path to the WebLogic domain directory and press Return.

    Type the complete path to the domain directory.

    The utility prompts you to enter the location of the WebLogic home directory.

  4. Specify the WebLogic home directory by doing one of the following:
    • Type the number of a directory in the list and press Return.
    • Type e and press Return, type the full path to the WebLogic home directory that you want to use, and press Return.

      The directory you specify must be accessible from each cluster node.

  5. Specify the full path to the start script for the WebLogic server and press Return.

    The clsetup utility supplies the default path to the script found in the WebLogic domain directory. You can press Return to accept this value or type a new path and press Return.

    The clsetup utility prompts for the path to the WebLogic Server environment file.

  6. Type the path to the WebLogic Server environment file and press Return.

    You can accept the default by pressing Return, or enter a new name. The environment file is typically $WEBLOGIC_HOME/server/bin/setWLSEnv.sh if WebLogic Server is configured through the installation wizard.

    The clsetup utility validates the environment file, then prompts you to specify a configuration mode.

  7. Type the number that corresponds to the configuration mode for the Managed Servers and press Return.
    • Failover mode

      In failover mode, the WebLogic Server managed server instance runs on only a single node. If the fault monitor detects an error, it restarts the instance on the same node or starts an instance on another cluster node that is configured to master the WebLogic data service.

    • Multi-instance mode

      In multi-instance mode, one WebLogic Managed Server instance runs on the cluster node that is the primary node of the Managed Server's logical host. With this type of configuration there could be any number of Managed Server instances.

    See Standard Data Service Configurations for more information about configuration modes.

    The clsetup utility displays a list of Managed Servers that you can configure.

  8. Type the numbers for the Managed Servers you want to configure and press Return.
    • For failover mode, you can specify one number.
    • For multi-instance mode, you can specify multiple numbers separated with spaces or commas.

    The clsetup utility displays logical hostname resources that are available for the specified Managed Server.

  9. Type the number of the logical hostname resource you want to use for the Managed Server and press Return.

    The logical host name resource you choose is configured as the host for the managed server resource that is created. The managed server resource has a resource dependency on the logical hostname resource. The managed server selected will be configured on the same resource group where the selected logical host exists, in failover mode.

    In multi-instance mode, for each selected instance one logical hostname resource should be selected. You can select the same logical hostname resource for multiple managed server instances. A new resource and resource group will be created for each managed server instance.

    The clsetup utility prompts you to specify the optional monitoring URI. This URI can be used by the Fault Monitor to test the functionality of the Oracle WebLogic Server by doing an HTTP GET on the URI.

  10. Specify the optional monitoring URI as follows:
    • If you do not want to use a monitoring URI, press Return.
    • If you want to use a monitoring URI, type one or more URIs in the form http://path/to/monitor with commas separating multiple URIs, then press Return.

    The URIs will be validated against the configured logical host resources when the resource is created.

    The utility displays the highly available storage resources, if any.

  11. Type the number of the storage resource to use for the Managed Server and press Return.

    The storage resources must contain the WebLogic home and domain directory.

    The storage resources displayed should be based on the WebLogic home directory value you specified earlier, but if clsetup cannot find any, all configured storage resources on the selected cluster are displayed instead.

    You can select one from the list, or proceed without selecting anything by typing d and pressing Return.

  12. Specify the highly available storage resources:
    • Type the number of the storage resource you want to use and press Return.
    • Press Return if no highly available storage resources are present.
    • Press d without making a selection to skip the storage resource selection.
  13. Review the configuration information in the review panel.

    The review panel shows the values for all the properties associated with the managed servers.

    • If the configuration information is correct and you do not want to change anything, type c to create the configuration.
    • Optionally, to edit the names of the managed server resources, type the number for Managed Server Resource and press Return.

      A new panel is displayed where you can then edit the managed server resource names one at a time, then type d when you are done.

      The utility displays a summary of the information that will be used to create the configuration for the WebLogic Managed Server instance for your review. You cannot edit any of the values here.

  14. Press Return to create the configuration.

    The clsetup utility displays the list of commands that are invoked on the cluster and also shows a status message indicating a success or failure. In the event that the configuration fails, a rollback is attempted.

  15. Press Return to exit the wizard for configuring the Managed Server.

    The clsetup utility returns to the WebLogic Server Configuration screen.

    Continue to the next procedure for Reverse Proxy Server configuration.

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Reverse Proxy Servers (clsetup)

Use this procedure to configure Reverse Proxy Servers for Oracle Solaris Cluster HA for WebLogic Serverusing the clsetup utility. The utility starts a wizard to guide you through the creation of resource groups and resources for the reverse proxy server instance.

These instructions assume that you are at the WebLogic Server Configuration list of options for configuring Oracle Solaris Cluster HA for WebLogic Server in the clsetup utility.

Before You Begin

You must perform the steps in How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server Managed Servers (clsetup) before configuring proxy servers.

  1. In the WebLogic Server Configuration panel, type the number for the Reverse Proxy Server option, and press Return.

    If you are configuring in a zone cluster, the zone cluster nodes are displayed.

    If you are configuring in a global cluster on Solaris 10, a list of global cluster nodes and zone nodes is displayed.

    If you are configuring on Solaris 11, the zone nodes are not supported and only the global cluster nodes are displayed.

  2. Press Return to continue.

    The utility prompts you to enter the location of the domain.

  3. Type the full path to the WebLogic domain directory and press Return.

    The default path to the domain directory is typically similar to /WebLogic-installation-dir/Oracle/Middleware/user_projects/domains/domain-name where the WebLogic-installation-dir and the domain-name are specific to your installation.

    The utility prompts you to enter the location of the WebLogic home directory.

  4. Specify the WebLogic home directory by doing one of the following:
    • Type the number of a directory in the list and press Return.
    • Type e and press Return, type the full path to the WebLogic home directory that you want to use, and press Return.

      The directory you specify must be accessible from each cluster node.

  5. Specify the full path to the start script for the reverse proxy server and press Return.

    The clsetup utility supplies the default path to the script found in the WebLogic domain directory. You can press Return to accept this value or type a new path and press Return.

    The clsetup utility prompts for the path to the WebLogic Server environment file.

  6. Type the path to the WebLogic Server environment file and press Return.

    You can accept the default by pressing Return, or enter a new name. The environment file is typically $WEBLOGIC_HOME/server/bin/setWLSEnv.sh if WebLogic Server is configured through the installation wizard.

    The clsetup utility finds the names of reverse proxy instances and prompts you to specify one to configure.

  7. Type the number that corresponds to the reverse proxy server instance to configure, and press Return.

    The utility prompts you to specify the logical hostname resource for the reverse proxy server.

  8. Type the number of the logical hostname resource you want to use for the reverse proxy server and press Return.

    The logical hostname resource you choose is configured as the host for the reverse proxy server resource that is created.

    A single failover resource group will be created for the reverse proxy server instance. The reverse proxy server resource will be configured in the resource group of the selected logical hostname resource. The reverse proxy server resource will have a strong dependency on the logical host resource and an offline restart dependency on the storage resource. The failover resource group will be created with a strong positive affinity on the storage resource group.

    The clsetup utility prompts you to specify the optional monitoring URI. This URI can be used by the Fault Monitor to test the functionality of the Oracle WebLogic Server by doing an HTTP GET on the URI.

  9. Specify the optional monitoring URI as follows:
    • If you do not want to use a monitoring URI, press Return.
    • If you want to use a monitoring URI, type one or more URIs in the form http://path/to/monitor with commas separating multiple URIs, then press Return.

    The URIs will be validated against the configured logical host resources when the resource is created.

  10. Type the number of the storage resource to use for the reverse proxy server and press Return.

    The storage resources must contain the WebLogic home and domain directory.

    The storage resources displayed should be based on the WebLogic home directory value you specified earlier, but if clsetup cannot find any, all configured storage resources on the selected cluster are displayed instead.

    You can select one from the list, or proceed without selecting anything by typing d and pressing Return.

  11. Review the configuration information in the review panel for all the properties associated with the reverse proxy server.
    • If the configuration information is correct and you do not want to change anything, type d to indicate your are done.
    • Optionally, to edit the name of the managed server resources, type the number for Reverse Proxy Server Resource and press Return.

      A new panel is displayed where you can then edit the reverse proxy server resource name, then type d when you are done.

      The utility displays a summary of the information that will be used to create the configuration for the WebLogic Reverse Proxy Server instance for your review. You cannot edit any of the values here except by typing < to go back to the step where the value is specified.

  12. Type c and press Return to create the configuration.

    The utility displays the list of commands that are invoked on the cluster and also shows a status message indicating a success or failure. In the event that the configuration fails, a rollback is attempted.

  13. (Optional) Type q and press Return repeatedly until you quit the clsetup utility.

    If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again.

Setting Oracle Solaris Cluster HA for WebLogic Server Extension Properties

The sections that follow contain instructions for registering and configuring Oracle Solaris Cluster HA for WebLogic Server resources using commands. For information about the extension properties, see Appendix A, HA for WebLogic Server Extension Properties. The Tunable entry indicates when you can update a property.

For details about all the Oracle Solaris Cluster properties, see the following man pages: cluster(1CL), rt_properties(5), r_properties(5), and rg_properties(5).

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 
-p property

Identifies the extension property that you are setting.

value

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.

How to Register and Configure the Oracle Solaris Cluster HA for WebLogic Server as a Reverse Proxy Server (CLI)

You can configure your WebLogic Server running as a proxy server in a failover configuration. The procedure below assumes that you have completed the following steps:

This configuration does not enable a smooth shutdown. The Oracle Solaris Cluster HA for WebLogic Server stop method forces the shutdown of the WebLogic Server, and kills the process. See Creating a Resource That Shuts Down Smoothly for instructions on enabling a smooth shut down. For more information, see STOP Method.

  1. Install and configure the Oracle Solaris Cluster HA for WebLogic Server as a proxy server.

    Follow the instructions on the WebLogic Server documentation.

  2. Add the WebLogic Server resource type.
    # clresourcetype register SUNW.wls
  3. Create a proxy server resource for starting the WebLogic Server as a proxy server.
    # clresource create -g wls-proxy-rg -t SUNW.wls \
    -p Confdir_list=/global/bea/beahome/weblogic103 \
    -p Server_url=http://logical-host-2:portnumber \
    -p Start_script=/global/bea/beahome/user_projects/petstore/startManagedWebLogic.sh \
    -p resource_dependencies=wls-mgd1-rs,wls-mgd2-rs.... 
    wls-proxy-rs

    Note - If you are running managed server instances outside agent control, ensure that the managed server instances are running. If you are running the managed server instances under the agent control, add the managed server resources that are configured in the proxy server configuration under the resource_dependencies property. This ensures that the managed server resources are online before bringing the proxy server resource online.


How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Failover Data Service (CLI)

Use this procedure to configure Oracle Solaris Cluster HA for WebLogic Server as a failover data service. The following steps assume that you are using the failover configuration that is described in Standard Data Service Configurations and have configured the WebLogic Servers as mentioned in Installing and Configuring the WebLogic Server Application. These steps assume that you have already created resource groups RG1 and RG2 and have also created logical-host-1 and logical-host-2 resources in these resource groups. Refer to How to Prepare the Nodes for a Failover Configuration for procedures to create logical hostname resources. If you are planning a different configuration, you must configure the WebLogic Server resources accordingly.


Note - Before you start Oracle Solaris Cluster HA for WebLogic Server, if you are using a database, check that your database is accessible.


  1. Add the WebLogic Server resource type.
    # clresourcetype register SUNW.wls
  2. Create a WebLogic Administration Server resource in the RG1 resource group.
    # clresource create -g RG1 -t SUNW.wls \
    -p Confdir_list=/global/bea/beahome/weblogic700 \
    -p Server_url=http://logical-host-1:7001 \
    -p Start_script=/global/bea/beahome/user_projects/petstore/startWebLogic.sh admin-rs

    The resource is created in the enabled state.


    Note - This configuration does not enable smooth shutdown. The Oracle Solaris Cluster HA for WebLogic Server stop method forces the shutdown of the WebLogic Administration Server (kills the process). Refer to Creating a Resource That Shuts Down Smoothly for the configuration to enable smooth shutdown. For more information, see STOP Method.


  3. Create a WebLogic Managed Server resource in the RG2 resource group.
    # clresource create -g RG2 -t SUNW.wls \
    -p Confdir_list=/global/bea/beahome/weblogic700 \
    -p Server_url=http://logical-host-2:7004 \
    -p Start_script=/global/bea/beahome/user_projects/petstore/startManagedWebLogic.sh managed-rs

    The resource is created in the enabled state.

How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Multi-Master Data Service (CLI)

Use this procedure to configure Oracle Solaris Cluster HA for WebLogic Server in a multi-master configuration. The following steps assume that you are using the configuration that is described in WebLogic Servers Configured as a Multi-Master Resource and have configured the WebLogic Servers as mentioned in Installing and Configuring the WebLogic Server Application. These steps assume that you have already created a resource group and started the administration server either outside or inside the agent control. If you are planning a different configuration, you must configure the WebLogic Server resources accordingly.


Note - This configuration does not enable smooth shutdown. The Oracle Solaris Cluster HA for WebLogic Server stop method forces the shutdown of the WebLogic Server (kills the process). Refer to Creating a Resource That Shuts Down Smoothly for the configuration to enable smooth shutdown in a multi-master configuration. For more information, see STOP Method.


  1. Add the WebLogic Server resource type.
    # clresourcetype register SUNW.wls
  2. Create a scalable resource group for managed servers.
    # clresourcegroup create -p Maximum_primaries=m \
    -p Desired_primaries=n managed-server-rg

    Use the following information:

    • -p Maximum_primaries=m specifies the maximum number of active primary nodes permitted for this resource group. The default is 1.

    • -p Desired_primaries=n specifies the desired number of active primary nodes for this resource group. The default is 1.

    • managed-server-rg is the resource group name.

  3. Bring the resource group online
    # clresourceoup online -M managed-server-rg
  4. Create a multi-master resource for starting the managed server instances simultaneously.

    The following example starts the WebLogic Server managed server instances mgd1 on node1 and mgd2 on node2.

    # clresource create -t SUNW.wls -g managed-server-rg \ 
    -p Confdir_list=/local/bea/beahome/wlserver_10.3 \
    -p Server_url{node1}=http://logical-host-1:portnumber \
    -p Server_url{node2}=http://logical-host-2:portnumber \
    -p Start_script=/global/bea/beahome/user_projects/domains/
    base_domain_mgd1/bin/startManagedWebLogic.sh \
    -p "Server_name{node1}"=mgd1 \
    -p "Server_name{node2}"=mgd2 \
    -p resource_dependencies=logical-host-1@node1,logical-host-2@node2
     managed-server-rs

    Tip - You can create the resource in the global cluster or in a zone cluster. To create a resource in the specific zone cluster from the global cluster, use the -Z option to specify the name of the zone cluster.


How to Register and Configure Oracle Solaris Cluster HA for WebLogic Server as a Multi-Instance Data Service (CLI)

Use this procedure to configure Oracle Solaris Cluster HA for WebLogic Server in a multi-instance configuration. The following steps assume that you are using the configuration that is described in WebLogic Servers Configured as Multi-Instance and have configured the WebLogic Servers as mentioned in Installing and Configuring the WebLogic Server Application. These steps assume that you have already created a resource group and started the administration server either outside or inside the agent control. If you are planning a different configuration, you must configure the WebLogic Server resources accordingly.


Note - This configuration does not enable smooth shutdown. The Oracle Solaris Cluster HA for WebLogic Server stop method forces the shutdown of the WebLogic Server (kills the process). Refer to Creating a Resource That Shuts Down Smoothly for the configuration to enable smooth shutdown in a multi-instance configuration. For more information, see STOP Method.


  1. Create a single-node resource group for a managed server, with strong positive affinities for the logical host resource group and the storage resource group.
    # clresourcegroup create -p nodelist=node1 \
    -p "RG_affinities=++logicalhost-rg,++scalmnt-rg \
    managed-server-rg
  2. Create the managed server resource and set its properties.
    # clresource create -t SUNW.wls -g managed-server-rg \
    -p Confdir_list=/path/to/weblogic/config/dir \
    -p Resource_dependencies=logicalhost-rg,proxy-rs \
    -p Resource_dependencies_offline_restart=storage1-rs,storage2-rs,... \
    -p Server_url=http://localhost:port-number \
    -p Start_script=/path/to/weblogic/start-script \
    -p Server_name=managed-server \
    -p smooth_shutdown=true \
    managed-server-rs