Sun Cluster Data Service for WebLogic Server Guide for Solaris OS

Extension Properties

Sun Cluster HA for BEA WebLogic Server uses the following extension properties. You might be able to tune these extension properties. See Sun Cluster HA for BEA WebLogic Server Extension Properties for more information on how to review or set extension properties.

Table 1–3 Sun Cluster HA for BEA WebLogic Server Extension Properties

Name/Data Type 

Description 

Confdir_list(stringarray) 

The complete path to the BEA WebLogic Server home directory, $WL_HOME, is set in this extension property.


Note –

If setWLSEnv.sh and startWLS.sh are not in the standard $confdir_list/server/bin location, then you must create links to these files from $confdir_list/server/bin directory. If you do not create this link, the BEA WebLogic Server resource creation will fail.


Default: None

Tunable: At creation

Start_Script (string) 

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. For more information, see Configuration Requirements to

Default: None

Tunable: At creation

Server_Url (string) 

The complete URL of the BEA WebLogic Server, including the protocol 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 performing an HTTP GET 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

For more information about the Server_Url, see the relevant BEA WebLogic Server documentation for the version you are using. For example, for BEA WebLogic Server 7.0, the documentation is located at the following website.


http://e-docs.bea/com/wls/docs70/adminguide
/startstop.html#1161188

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 using DNS.

Default: None

Tunable: At creation

Monitor_Uri_List (string) 

Single URI or list of URIs, separated by a comma, which can be used by the fault monitor to test the functionality of the BEA WebLogic Server by doing an HTTP GET 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 connect fails, the probe will take 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 using DNS.

Default: Null

Tunable: Any time.

Server_name (string) 

A single start script can be used to start all the Managed Servers by passing the Managed Server name as an argument to the startup script. If Agent start methods have to pass the server name as an argument to the start script then, configure the Managed Server name in this extension property. 

Default: Null

Tunable: Any time.

DB_Probe_Script (string) 

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 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 will be 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 will take action only if the Database probe succeeds. Refer to Probing Algorithm and Functionality for more details.

Default: Null

Tunable: Any time.

Smooth_shutdown 

This is an extension property to enable smooth shutdown using 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, then 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

  • It is not a concern if the agent stop method reads the username and password from the start script and passes it to the java weblogic.Admin command

Default: False

Tunable: Any time.