start portlet menu bar end portlet menu bar
  • Overview
  • Documentation
  • Version history

Description

The wldeploy Ant task is used to complete weblogic.Deployer functions by using attributes that are specified in an Ant XML file. You can use the wldeploy Ant task with other WebLogic Server Ant tasks to create a single Ant build script.

With the Oracle WeblLogic WLDeploy plugin, you can run a wldeploy Ant task as part of a deployment process. This plug-in also provides steps for other deployment actions such as: undeploy, deploy, and redeploy. It also can be used to start and stop WebLogic servers and clusters.

Quick Info

Product icon

Product

HCL DevOps Deploy (HCL Launch)
Plugin type icon

Type

plugin
Compatibility icon

Compatibility

HCL Launch version 7.3.2.8 and later, HCL Deploy version 8.0.1.3 and later, Oracle WebLogic server version 10.3 and later.
created by icon

Created by

HCL Software
Website icon

Website

Oracle WebLogic WLDeploy

Published Date

Last Updated

Summary

The Oracle WLDeploy plugin automates managing and deploying applications to one or more WebLogic servers. You can complete the following tasks with the plugin:

  • Start and stop a WebLogic server
  • Check the status of an application
  • Determine the available applications on a WebLogic server
  • Deploy an application to a WebLogic server

This plugin includes one or more steps, click Steps for step details and properties.

Installation

See Installing plug-ins in HCL Deploy for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
27 Fixed hardcoded value to fix TS021381090.
26 Fixed issue with Groovy 3.x.
25 Fixing CVE:CVE-2019-4233
24 Fixed APAR PI93543 'List Applications on Target' step resulting in JSONException. Removed all unnecessary stream handling of input properties files.
23 Updated auto-discovery to search the 'MW_HOME' environment variable for a weblogic installation. Changed the 'wldeploy.path' and 'wldeploy.mwHome' Auto Discovery fields to derive from agent properties.
22 Fixed APAR 167684 UCD encrypted output properties requires decryption key.
21 Encrypt plugin properties APAR PI80318: Stop Target step now fails when given invalid target name. Run WLDeploy step will not throw error when given unexpected parameters. List Applications step now returns correct applications. Wait For Application step now avoids infinite loop.
20 Removed unused URL's from steps.
19 Added timeout property to Stop Targets step. Fixed Run WLDeploy step so System Properties can be passed in.
18 Fixed bug in start/stop steps involving starting and stopping clusters that are already in desired state.
17 Fixed infinite loop errors in starting/stopping clusters.
16 Support property file encryption. Added support for different inputs of JMX URL.
15 Fixed problem involving mismatched Groovy versions causing java errors.
14 Added auto-discovery of a WebLogic installation and auto-configuration of all domains, servers, and clusters managed by the administration server.
13 Added ability to fail or warn when Start Targets step fails to start one or more targets. Fixed bug in Stop Targets step; step no longer fails when trying to shut down a target that is already in SHUTDOWN state.
12 Resolves PI48310 - infinite retries when starting targets issue. A new input property on Start Targets step allows user to set timeout length for starting targets. A new output property in the form of state-$TARGET_NAME is set for each target in step and contains the value of the target's state. Added ability to pass in config and key files to Run Deploy step, allowing for encrypted user names and passwords. Added ability to set JAVA_HOME
11 Resolves PI25444 - an issue running steps while using impersonation.
10 Installing this plugin will give you access to the steps listed below. Added a new step to get all apps installed in targets and set as ouptut properties in the form of apps-$TARGET_NAME=app1Name,app2Name,app3Name...
9 Installing this plugin will give you access to the steps listed below. These steps can be used when designing a component process.

Steps

The following process steps are available in the Oracle WebLogic WLDeploy plugin.

Check Application on Targets

Check the status of an application on target servers and clusters

Input properties for the Check Application on Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
Application Name String The name of the application. Yes
Expected Status String The status string to check against. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The jmx administration URL of the WebLogic server. This is used when starting, stopping, and checking status of targets. No
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String A comma-separated list of target servers to deploy to. For example: target1,target2. Yes
User Config File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

Check Targets

Examine target servers for the RUNNING status. This step will only succeed if all specified servers are RUNNING.

Input properties for the Check Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String Specify a comma-separated list of servers to check for a RUNNING status. For example: target1,target2. Yes
User Configuration File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

List Applications on Targets

List all AppDeployments for each target and set as output properties.

Input properties for the List Applications on Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String A comma-separated list of target servers to deploy to. For example: target1,target2. Yes
User Configuration File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are< stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

Run WLDeploy

Run a WLDeploy Ant task.

Input properties for the Run WLDeploy step
Name Type Description Required
Additional Properties String A new-line separated list of additional properties to be used as part of the wldeploy Ant task. Use this format: property_name=value\nname=value\n. No
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property_name=value. The property is added to the command line as follows: -Dproperty_name=value. No
Administration URL String The administration URL of the WebLogic server. Yes
Alternate Application Descriptor String The alternate application descriptor file name. No
Alternate WLS Application Descriptor String The alternate WebLogic server application descriptor file name. No
Application Name String The name of the application. Yes
Application Version String The version of the application that is specified in the Alternate WLS Application Description property. No
Deployment Plan String The name of the deployment plan. No
Deployment Plan Version String The version of the deployment plan that is specified in the Deployment Plan property. No
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
Operation Enumeration The wldeploy Ant task action to perform. Valid values are deploy, undeploy, distribute, redeploy, start, and stop. Yes
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Remote Boolean Enable this property if you are deploying to a remote computer that is not the same computer that this agent runs on. No
Retire Timeout String The timeout value that specifies when to retire the currently running version. Specify this property if the wldeploy task is start, redeploy, or deploy. No
Source to deploy String The fully qualified path of the source to deploy. No
Targets String A comma-separated list of the names of target servers to deploy to. For example: target1,target2. Yes
Task ID String The id for looking up the task. No
User Config File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start and stop the WebLogic server. Yes

Start Targets

Start the target server and clusters

Input properties for the Start Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
On Failure Enumeration Choice of action when any of the targets fail to start. Valid values are fail and warn. Fail: Step will attempt to start all targets, and will fail at the end if any of the targets failed to start. Warn: Step will continue on if an override failure occurs, and print a warning declaring the target that failed to start. Yes
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String A comma-separated list of the names of the target servers to deploy to. For example: target1,target2. Yes
Timeout String The time after which the attempt to start the targets times out. Specify the value in seconds. The default value is 2 minutes. Yes
User Configuration File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

Stop Targets

Stop the target server and clusters

Input properties for the Stop Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
Force Boolean Use the force shutdown command instead of a simple shutdown command. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String A comma-separated list of target servers to deploy to. For example: target1,target2. Yes
User Configuration File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

Wait for Application on Targets

Wait for the status of application on target servers and clusters to be running

Input properties for the Wait for Application on Targets step
Name Type Description Required
Additional System Properties String A new-line separated list of Java system properties to be added on the command line. Specify each property in this format: property=value. The property is added to the command line as follows: -Dprop=value. No
Administration URL String The administration URL of the WebLogic server. Yes
Application Name String The name of the application. Yes
Expected Status String The status string to should check against. Yes
JAVA_HOME String The fully qualified path to the Java installation. Provide a value to overwrite the JAVA_HOME environment variable. If this property is not specified, the default value is the system environment variable. No
JMX Administration URL String The JMX administration URL of the WebLogic server. This URL is used when you start, stop, and check the status of targets. No
Password Password The password to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
Targets String A comma-separated list of target servers to deploy to. For example: target1,target2. Yes
User Configuration File String The path to the configuration file where the encrypted user name and password are stored. No
User Key File String The path to the key file where the decryption key for the user name and password are stored. No
User Name String The user name to use to connect to the WebLogic server. If the user name and password are encrypted, leave this property blank and specify the User Configuration File and User Key File properties. No
WLDeploy Ant Task JAR String The fully-qualified path to the WebLogic WLDeploy Ant Task JAR file or full client JAR file. This property is required when you start, stop, and check the status of targets. Yes

Usage

Use the WLDeploy plugin to deploy, remove, or redeploy Java applications on a WebLogic server or cluster as a step in your deployment process. You can design your process to start and stop WebLogic servers or clusters and query the server about the status of an application.

With the Run WLDeploy step, you can run the Oracle wldeploy Ant Task, and you can specify wldeploy attributes in the step. For available attribute details, see the Oracle Help Center wldeploy Ant Task Reference topic.

Before you begin verify that a Java SDK is installed.

Step palette

To access this plugin in the palette, click Application Server > Java > WebLogic WLDeploy.

devops-deploy-WLDeploy-27.1185983.zip

Uploaded: 10-Feb-2026

Release Notes

  • Fixed hardcoded value to fix TS021381090.
Download Icon DOWNLOAD

launch-wl-25.1103454.zip

Uploaded: 14-Apr-2021 08:53

Download Icon DOWNLOAD

launch-wl-25.1100712.zip

Uploaded: 16-Mar-2021 11:54

Download Icon DOWNLOAD

Related Plugins