deploy (WebLogic)

Deploy an EAR or WAR file to Partition, Resource Group, Resource Group Template or WebLogic Cluster/Server. You must have built archive files as part of build workflow execution prior to running deploy.

The following properties are used to specify the location to deploy.

  1. FDWLS_SERVER_OR_CLUSTER_NAMES

  2. FDWLS_PARTITION, FDWLS_RESOURCE_GROUP

  3. FDWLS_RESOURCE_GROUP_TEMPLATE

If all values are specified, they are used in the order listed above.

Prior to WebLogic 12.2.1, only the FDWLS_SERVER_OR_CLUSTER_NAMES property was used. Read about the deployment options of 12.2.1 at https://blogs.oracle.com/WebLogicServer/entry/domain_partitions_for_multi_tenancy.

Blog Posts

Target Properties

Property Name

Property Code

Required

Description

Property Name

Property Code

Required

Description

Oracle Weblogic Home (WL_HOME)

FDWLS_WEBLOGIC_HOME

Yes

WebLogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver)

Weblogic Domain Name

FDWLS_DOMAIN_NAME

Yes

WebLogic Domain Name.

Weblogic Admin Listen Address

FDWLS_ADMIN_LISTEN_ADDRESS

Yes

The listener address of the WLS admin server. (e.g. localhost)

Weblogic Admin Listen Port

FDWLS_ADMIN_LISTEN_PORT

Yes

The port of the WLS admin server. (e.g. 7001)

Weblogic Admin SSL Connection

FDWLS_ADMIN_USE_SSL

No

Indicates whether the admin server is using SSL.

Weblogic Admin User

FDWLS_ADMIN_USER

Yes

The user name for the WLS admin server.

Weblogic Admin Password

FDWLS_ADMIN_PASSWORD

Yes

The password for Weblogic Admin User.

Weblogic Application Install Directory

FDWLS_BASE_INSTALL_DIRECTORY

No

Base directory to install the WebLogic deployments from.

Files will be copied here on Admin Server endpoint by WebLogic plugin prior to installation.

For example: /oracle/middleware/product/user_projects/applications

Weblogic Stage Mode

FDWLS_STAGE_MODE

Yes

Staging mode for the application you are deploying. Valid values are stage, nostage, and external_stage.

Recommended and default option is stage, in which case deployment archive files are only needed to be accessible by Admin Server and then Admin Server copies files to target managed server.

Weblogic Deployment Timeout

FDWLS_DEPLOY_TIMEOUT

No

Time in milliseconds that the plugin operation will wait for the server to respond. Plugin operation will return as soon as the server responds, but if the deploy doesn't complete before the timeout specified, the plugin operation will fail.

The default value is 300000 milliseconds.

Project Properties

Property Name

Property Code

Required

Description

Property Name

Property Code

Required

Description

Weblogic Application Name

FDWLS_APPLICATION_NAME

Yes

The name of the application (EAR or WAR) to be deployed.

Weblogic Server or Cluster Name(s)

FDWLS_SERVER_OR_CLUSTER_NAMES

Yes

WebLogic Server or Cluster name to deploy application.
It is assumed that you are using managed server or cluster of same name in various environments.

Weblogic Partition

FDWLS_PARTITION

No

WLS Partition - used in WLS 12.2.1+

Weblogic Resource Group

FDWLS_RESOURCE_GROUP

No

WLS Resource Group - used in WLS 12.2.1+

Weblogic Resource Group Template

FDWLS_RESOURCE_GROUP_TEMPLATE

No

WLS Resource Group Template - used in WLS 12.2.1+

Weblogic Versioned Deployment

FDWLS_USE_VERSIONS

No

Determines whether the plugin will deploy the artifact with a version label.

If Weblogic Versioned Deployment is true, then FD_PROJECT_VERSION will be used as the version. This allows multiple archives to be deployed at the same time.

Plugin will modify MANIFEST.MF file if necessary.

Inputs

Input Name

Input Code

Required

Description

Input Name

Input Code

Required

Description

Server or Cluster Name(s)

FDWLS_INP_SERVER_OR_CLUSTER_NAMES

No

WebLogic Server or Cluster name for deploy operation. Overrides the Weblogic Server or Cluster Name(s) project property.

Override File Pattern

FDWLS_INP_OVERRIDE_FILE_PATTERN

No

Specify FileName=OverrideFileName pattern. Matching files will be replaced by override files and Property replacement logic will be executed. For example, web.xml=fd-web.xml.

Redeploy

FDWLS_INP_REDEPLOY_OPTION

No

Automatically redeploy the application if it is already deployed. If you set FDWLS_USE_VERSIONS to true, then this operation will deploy regardless of if redeploy is set to true. Defaults to false.

Artifacts

This operation consumes an EAR or WAR file artifact from the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the Target which have a resource type of WLS Admin Server. Since the admin server only runs on one server, it is expected that for a given domain, there will only be one endpoint with a resource type set to WLS Admin Server.

Endpoint Execution

This operation will execute on the Admin Server endpoint selected using the WLS Admin Server resource type.

Special Considerations

Locking occurs on the endpoint to ensure multiple configuration changes are not concurrently being deployed at the same time for a domain. The lock files are located in {Base Working Directory for the endpoint}/locks with a file name of {Environment Code}_{WebLogic Domain Name}.

 

The following macros are not currently supported in the footer:
  • style