Name | Description | Examples | Attributes | See Also
The Resource Group Manager (RGM) manages Sun Cluster HA for BEA WebLogic Server for Sun Cluster. Use the clresource(1CL) command or a resource configuration GUI to set the following properties on BEA WebLogic Server resources.
Type string array. No default value exists. Use this property to set the complete path to the BEA WebLogic Server home directory, $WL_HOME.
You can modify this property only when you create the resource.
Type string. Default is null. This extension property can be used to set the complete path to a database probe script. The HA-WLS probe method probes only the WLS instances. The database probe script can be provided by using this extension property if the administrators want the HA_WLS to probe the DB also. This probe script must return 0 for success. The BEA WebLogic Servers are started only if this database probe returns success. If an HA-WLS probe detects a failure in a WLS instance and if this extension property is set, the HA-WLS probe takes action only if the database probe succeeds.
You can modify this property at any time.
Type string. Default is null. This property indicates the URI or list of URIs, separated by a comma, that can be used by the fault monitor to test the functionality of the BEA WebLogic Server by running an HTTP GET command on the URI. The Server_Url extension property is for simple probes on the hostname and port. This extension property can be used to probe the WLS functionality by retrieving a Java servlet or making the WLS run an application and return an HTTP server code. If the HTTP server return code is 500 (Internal Server Error) or if the connection fails, the probe takes action. See the probe method for more details.
Make sure that the hostnames used in the server_url and monitor_uri_list are resolvable. If you use Fully Qualified Domain Names (FQDNs), then DNS must be enabled and /etc/nsswitch.conf must have the correct entries to resolve the hostnames by using DNS.
You can modify this property at any time.
Type string. Default is null. A single start script can be used to start all the Managed Servers by passing the Managed Server name as an argument to the START script. If Agent START methods have to pass the server name as an argument to the START script, configure the Managed Server name in this extension property.
You can modify this property at any time.
Type string. No default value exists. This property indicates the URL of the BEA WebLogic Server. The URL includes the protocol that is used to connect to the server, that this resource is configured to start. The probe method uses this URL to check the health of the server by running an HTTP GET command on the URL. The protocol in the URL must be set to http. The complete URL should be in the following form.
http://host:port |
Make sure that the hostnames used in the server_url and monitor_uri_list are resolvable. If you use Fully Qualified Domain Names (FQDNs), then DNS must be enabled and /etc/nsswitch.conf must have the correct entries to resolve the hostnames by using DNS.
You can modify this property only when you create the resource.
Type Boolean. Default is False. This extension property can be used to enable smooth shutdown by using the WebLogic.Admin class. This extension property must be set to TRUE if a smooth shutdown is desired before trying to kill the WLS process. If this extension property is TRUE, the WLS_USER and WLS_PW must be set in the start_script and not in boot.properties.
Set this extension property to TRUE if all of the following apply.
Setting the username and password in the start_script is not a concern.
A smooth shutdown is desirable instead of the default, killing the process.
You are not concerned if the agent STOP method reads the user name and password from the START script and passes it to the java weblogic.Admin command.
You can modify this property at any time.
Type string. No default value exists. Use this property to set the complete path to the script that should be used to start the BEA WebLogic Server instance (either Administration or Managed). This script is typically present under the domain name directory along with the config.xml file. A separate script or a single script can be configured for starting each BEA WebLogic Server.
You can modify this property only when you create the resource.
This example assumes that the START script, startWebLogic.sh, can start the BEA WebLogic Server without any arguments to the script. The username and password needed to start the BEA WebLogic Server can be configured within this START script or in the boot.properties file.
clresource create -g bea-rg -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/ha-wls/startWebLogic.sh bea-rs |
For this example to work, the Admin_URL must be set within the Start_script startManagedWebLogic.sh.
clresource create -g bea-rg -t SUNW.wls \ -p Confdir_list=/global/bea/beahome/weblogic700 \ -p Server_url=http://logical-host-1:7004 \\ -p Start_script=/global/bea/beahome/user_projects/ha-wls/startManagedWebLogic.sh \ -p Server_name=test1 bea-rs1 |
This example creates a resource that has the extension property Smooth_shutdown set to TRUE. Setting this extension property to TRUE specifies that BEA WebLogic Server will shut down the resource smoothly. If this extension property is not set to TRUE, the STOP method sends sigkill to the BEA WebLogic Server. For the resource created in this example, the BEA WebLogic Server first tries a smooth shutdown by using the Weblogic.Admin class. If this attempt is not successful, BEA WebLogic Server uses sigkill. The WLS_PW and WLS_USER must be set in the START script startManagedWeblogic.sh. If these two parameters are not set in the START script, the resource creation fails.
clresource create -g bea-rg -t SUNW.wls \ -p Confdir_list=/global/bea/beahome/weblogic700 \ -p Server_url=http://logical-host-1:7008 \ -p Start_script=/global/bea/beahome/user_projects/ha-wls/startManagedWebLogic.sh \ -p Server_name=text2 -p smooth_shutdown=true bea-rs2 |
This example creates a BEA WebLogic Server resource that should probe the database before taking any action on the BEA WebLogic Server. If the db_probe script is set, the BEA WebLogic Server will not be started if the script returns a failure. When the BEA WebLogic Server probe fails, action is taken only if the db_probe_script returns 0. This user-supplied database probe script must return 0 for success and non zero for failure.
clresource create -g bea-rg -t SUNW.wls \ -p Confdir_list=/global/bea/beahome/weblogic700 \ -p Server_url=http://logical-host-1:710 \ -p Start_script=/global/bea/beahome/user_projects/ha-wls/startManagedWebLogic.sh \ -p Server_name=test3 \ -p db_probe_script=/global/phys-pale-1/bea-db_probe_script bea-rs3 |
This example creates a BEA WebLogic Server resource that monitors URIs by using the Monitor_uri_list extension property. Action is taken only if the URI returns an http error 500 or if the connection to the BEA WebLogic Server fails.
clresource create -g bea-rg -t SUNW.wls \ -p Confdir_list=/global/bea/beahome/weblogic700 \ -p Server_url=http://logical-host-1:7012 \ -p Start_script=/global/bea/beahome/user_projects/ha-wls/startManagedWebLogic.sh \ -p Server_name=test5 \ -p db_probe_script=/global/bea/db_probe_script \ -p monitor_uri_list=http://logical-host-1:7001/sctest bea-rs5 |
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWwls |
Sun Cluster Data Service for WebLogic Server Guide for Solaris OS
Name | Description | Examples | Attributes | See Also