Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Service for Oracle WebLogic Server Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

## 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`(1CL)utility.

- Oracle Solaris Cluster maintenance commands.

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:

- WebLogic server software and agent packages are installed on the nodes of the cluster as mentioned in Installing and Configuring the WebLogic Server Application

- Volumes, disk groups, and file systems are created

- The WebLogic domain, the Administration Server, and Managed Server instances are created with the WebLogic `config.sh` script

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:

- You are using one of the configurations described in Standard Data Service Configurations.

- You have configured the WebLogic Servers as described in Installing and Configuring the WebLogic Server Application.

- You have created a resource group for running WebLogic Server as a proxy server.

- You have started an administration server and a managed server either inside or outside the agent's control.

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

Copyright © 2010, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |