next up previous contents index
Next: wlstop Up: EJB Tasks Previous: iplanet-ejbc   Contents   Index

wlrun

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}"/>


next up previous contents index
Next: wlstop Up: EJB Tasks Previous: iplanet-ejbc   Contents   Index
Andrew Marlow 2003-07-08