sideBySideDeploy
- Karl Henselin
- Ben Hoffman
- Chandresh Patel
This operation is designed to allow for production redeployment (side by side deployment) to WebLogic servers. This operation deploys the application in versioned mode. Undeployment of all but one version is completed before the deployment commences. The Weblogic-Application-Version property is set in the manifest by the plugin. If you prefer to use your own Weblogic-Application-Version value, please create a workflow with the undeploy and deploy operations instead, and set Weblogic Deployment Max # of Versions to 1 and Weblogic Versioned Deployment to true.
Deploys 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.
FDWLS_SERVER_OR_CLUSTER_NAMESFDWLS_PARTITION,FDWLS_RESOURCE_GROUPFDWLS_RESOURCE_GROUP_TEMPLATE.
If all values are specified, they are used in the order listed above.
Prior to WebLogic 12.2.1, only FDWLS_SERVER_OR_CLUSTER_NAMES was used. Read about the deployment options of 12.2.1 at https://blogs.oracle.com/WebLogicServer/entry/domain_partitions_for_multi_tenancy.
Property Replacement on Deploy
Let's say you want to override adf connections.xml file for specific environment instance deployment.
- Create a file called something like
connections-overrides.xmland source control it along with your application. This file should be in same folder asconnections.xml. In this file you can use properties where you need to replace environment instance or project specific values. Enter properties in the following notation:${{PROPERTY_NAME}}. See Property Replacement Support. - Define the required properties on your deploy workflow, and set the scope to either Environment Instance or Project as appropriate.
- Edit your deploy instance and associate your deploy workflow to it, if not already done.
- Your workflow properties will now appear on either the environment instances or projects depending on the scope, and you can provide values for them.
- In your deploy workflow, edit the deploy step and set the
Override File Pattern(FDWLS_INP_OVERRIDE_FILE_PATTERN)property. The value is in formatactual_file=override_file. For example,connection.xml=connections-overrides.xml. - At deploy time, the WebLogic deploy step will run property replacement against the override file using the properties you have defined, and then replace the original file prior to deploying artifact to WebLogic domain.
This can be done for any other files as well. For example, you can override web.xml, weblogic.xml, weblogic-application.xml files similarly. Alternatively, you can create separate override files for each environment as well and define Override File Pattern as expression to control which override file is used based on current environment from workflow execution.
Blog Posts
Environment/Instance Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
| Oracle Weblogic Home (WL_HOME) |
| Yes | WebLogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver) |
| Weblogic Domain Name |
| Yes | WebLogic Domain Name. |
| Weblogic Admin Listen Address |
| Yes | The listener address of the WLS admin server. (e.g. localhost) |
| Weblogic Admin Listen Port |
| Yes | The port of the WLS admin server. (e.g. 7001) |
| Weblogic Admin SSL Connection |
| No | Indicates whether the admin server is using SSL. |
| Weblogic Admin User |
| Yes | The user name for the WLS admin server. |
| Weblogic Admin Password |
| Yes | The password for |
| Weblogic Application 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 |
| 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 |
| 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 |
|---|---|---|---|
| Weblogic Application Name |
| Yes | The name of the application (EAR or WAR) to be deployed. |
| Weblogic Server or Cluster Name(s) |
| Yes | WebLogic Server or Cluster name to deploy application. |
| Weblogic Partition |
| No | WLS Partition - used in WLS 12.2.1+ |
| Weblogic Resource Group |
| No | WLS Resource Group - used in WLS 12.2.1+ |
| Weblogic Resource Group Template |
| No | WLS Resource Group Template - used in WLS 12.2.1+ |
Inputs
| Input Name | Input Code | Required | Description |
|---|---|---|---|
| Server or Cluster Name(s) |
| No | WebLogic Server or Cluster name for deploy operation. Overrides the |
| 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. |
Outputs
Output Name | Required | Description |
|---|---|---|
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 Environment/Instance 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}.
Related content
- style