Description:
The wlrun task is used to start a weblogic server. The task runs a weblogic instance in a separate Java Virtual Machine. A number of parameters are used to control the operation of the weblogic instance. Note that the task, and hence ant, will not complete until the weblogic instance is stopped.
Parameters
Attribute | Description | Required for 4.5.1 and 5.1 | Required for 6.0
|
---|---|---|---|
BEA Home | The location of the BEA Home where the server's config is defined. If this attribute is present, wlrun assumes that the server will be running under Weblogic 6.0 | N/A | Yes |
home | The location of the weblogic home that is to be used. This is the location where weblogic is installed. | Yes | Yes. Note this is the absolute location, not relative to BEA home. |
Domain | The domain to which the server belongs. | N/A | Yes |
classpath | The classpath to be used with the Java Virtual Machine that runs the Weblogic Server. Prior to Weblogic 6.0, this is typically set to the Weblogic boot classpath. Under Weblogic 6.0 this should include all the weblogic jars | Yes | Yes |
wlclasspath | The weblogic classpath used by the Weblogic Server. | No | N/A |
properties | The name of the server's properties file within the weblogic home directory used to control the weblogic instance. | Yes | N/A |
name | The name of the weblogic server within the weblogic home which is to be run. This defaults to "myserver" | No | No |
policy | The name of the security policy file within the weblogic home directory that is to be used. If not specified, the default policy file weblogic.policy is used. | No | No |
username | The management username used to manage the server | N/A | No |
password | The server's management password | N/A | Yes |
pkPassword | The private key password so the server can decrypt the SSL private key file | N/A | No |
jvmargs | Additional argument string passed to the Java Virtual Machine used to run the Weblogic instance. | No | No |
weblogicMainClass | name of the main class for weblogic | No | No |
Nested Elements
The wlrun task supports nested <classpath> and <wlclasspath> elements to set the respective classpaths.
Examples
This example shows the use of wlrun to run a server under Weblogic 5.1
<wlrun taskname="myserver" classpath="${weblogic.boot.classpath}" wlclasspath="${weblogic.classes}:${code.jars}" name="myserver" home="${weblogic.home}" properties="myserver/myserver.properties"/>This example shows wlrun being used to run the petstore server under Weblogic 6.0
<wlrun taskname="petstore" classpath="${weblogic.classes}" name="petstoreServer" domain="petstore" home="${weblogic.home}" password="petstorePassword" beahome="${bea.home}"/>