Sun Cluster HA for BEA WebLogic Server Extension Properties

This section describes the extension properties for the resource type SUNW.wls. This resource type represents the Apache application in a Sun Cluster configuration.

For details about system-defined properties, see the r_properties(5) man page and the rg_properties(5) man page.

The extension properties of the SUNW.wls resource type are as follows:

Confdir_list

The complete path to the BEA WebLogic Server home directory, $WL_HOME.

---

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.

---

Data type

String array

Default

No default defined

Range

Not applicable

Tunable

At creation

DB_Probe_Script

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 Database 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 BEA WebLogic Server 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.

Data type

String

Default

Null

Range

Not applicable

Tunable

At any time

Monitor_Uri_List

A single URI, or a comma-separated list of URIs, 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 BEA WebLogic Server functionality by retrieving a Java servlet or making the BEA WebLogic Server 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.

Data type

String

Default

Null

Range

Not applicable

Tunable

At any time

Server_name

A single start script that 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.

Data type

String

Default

Null

Range

Not applicable

Tunable

At any time

Server_Url

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.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

At creation

Smooth_shutdown

Indication of whether 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 BEA WebLogic Server 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. This is applicable only for BEA WebLogic Server 7.x and earlier versions.

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.

Data type

Boolean

Default

FALSE

Range

Not applicable

Tunable

At any time

Start_Script

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.

Data type

String

Default

No default defined

Range

Not applicable

Tunable

At creation