4 Deploy Oracle DMW on the WebLogic Server

By default Oracle Health Sciences Data Management Workbench (Oracle DMW) supports and requires HTTPS. If you prefer to use HTTP, you can follow instructions in Section 4.2 instead of Section 4.1 to enable the use of HTTP.

Follow instructions in one of the following sections:

Section 4.1, "Deploy with Default Support for HTTPS"
Section 4.2, "Alternative Oracle DMW Deployment Disabling HTTPS Support"

Note:

Before deploying Oracle DMW, make sure the WebLogic Server clock is synchronized with the InForm Adapter server clock by modifying the setDomainEnv.sh file. You should already have done this following instructions in Section 3.8, "Edit setDomainEnv.sh."

Then follow instructions in both of the following sections:

Section 4.3, "Apply the Latest Patch Set"
Section 4.4, "Check for and Install Oracle DMW Release 2.4.x Patches"

4.1 Deploy with Default Support for HTTPS

Deploy the Oracle DMW application tier on the WebLogic Server.

If necessary, copy the Oracle DMW 2.4 .zip file from your staging area to the WebLogic Server so that you can select it from the WebLogic Administration Console.
Unzip the file, creating the software directory containing the dmwapp.ear and plan.xml files.
Log in as the admin user to the WebLogic Administration Console. The URL is:

http(s)://host_name.company_domain.com:port/console/

for example:

http(s)://machine.example.com:1234/console
If you have an earlier version of Oracle DMW deployed, stop it and delete it before deploying the new version. If you are installing Oracle DMW for the first time, you do not need to do this step.

In the Weblogic Administration Console, select Deployments from Domain Structure. A list of all deployed applications appears.

If dmwapp is included in the list, select its check box and:
1. Stop it by selecting Force Stop Now from the Stop drop-down list.
2. Delete it by clicking Delete. dmwapp disappears from the list.
Click Install. The Install Application Assistant is displayed.
In the paragraph beginning Locate deployment to install and prepare for deployment, click the link upload your file(s).
In the Deployment Archive line, click Browse and select dmwapp.ear from your local computer and click Open. The system returns you to the Install Application Assistant.
In the Install Application Assistant click Next. This uploads dmwapp.ear to a server directory. This may take some time.

When the process is complete, the system displays the path to the server directory.
In the Install Application Assistant click Next.
Select Install this deployment as an application and click Next. The system displays a list of servers.
Select the managed server to which you are installing the applicationâ DMWServerâand click Next. Optional settings appear.
Under General, in the Name field, enter: dmwapp and click Finish. The system displays a summary of your selections.
Click Finish. The system deploys the Oracle DMW middle tier on the managed server. After a successful deployment ta new page called Settings for dmwapp appears with the Overview tab displayed.
Click Deployments under Domain Structure to verify that dmwapp is included in the Deployments list and its state is Active.
Go to the login screen to check that the application is running. The URL is:

http://host_name.company_domain.com:port/lsw/dme/faces/DmeLogin.jsf

For example:

http://srv123.example.com:1234/lsw/dme/faces/DmeLogin.jsf

4.2 Alternative Oracle DMW Deployment Disabling HTTPS Support

By default Oracle DMW is configured to use HTTPS. If you intend to use HTTP, you can deploy Oracle DMW Release 2.4 using the deployment plan (Plan.xml) that disables HTTPS for Oracle DMW.

For further information, see the OracleÂ® Fusion Middleware Deploying Applications to Oracle WebLogic Server11g Release 1 (10.3.6) at http://docs.oracle.com/cd/E23943_01/web.1111/e13702/intro.htm

Log in to the WebLogic Server and create a tmp directory.
Copy the latest Oracle DMW 2.4.x patch set to the WebLogic Server computer. Unzip the DMW file to the tmp directory, creating the software directory containing the dmwapp.ear and plan.xml files.
Open the software directory.
Copy the dmwapp.ear file and the plan.xml file to the tmp directory and delete the software directory. The tmp directory now contains only the dmwapp.ear and plan.xml files.
Open a shell window and set up the environment:

source WL_HOME/server/bin/setWLSEnv.sh

for example:
```
source /app/oracle/product/middleware/wlserver_10.3/server/bin/setWLSEnv.sh
```
Change directory to the tmp directory.
If you have an earlier version of Oracle DMW deployed, stop it and delete it before deploying the new version. If you are installing Oracle DMW for the first time, you do not need to do this step.

Enter the following commands. Or store the username and password in a WebLogic configuration file and omit the username and password parameters in the commands below. For information, see the WebLogic Scripting Tool Command-Line Reference in the OracleÂ® Fusion Middleware Deploying Applications to Oracle WebLogic Server 11g Release 1 (10.3.6) at http://docs.oracle.com/cd/E23943_01/web.1111/e13702/wldeployer.htm#DEPGD318.
```
java weblogic.Deployer -adminurl t3://host_name.your_company_domain.com:port_number  -username WLS_USER  -password WLS_PASSWORD  -stop  -targets  DMW_SERVER_NAME -name dmwapp

java weblogic.Deployer -adminurl t3://host_name.your_company_domain.com:port_number  -username WLS_USER  -password WLS_PASSWORD  -undeploy  -targets DMW_SERVER_NAME  -name dmwapp
```

Deploy the new Oracle DMW release. Enter the following command. If you are storing the username and password in a configuration file, omit the username and password parameters.

java weblogic.Deployer -adminurl t3://host_name.your_company_domain.com:port_number -username WLS_USER -password WLS_PASSWORD -targets DMW_SERVER_NAME -deploy dmwapp.ear -name dmwapp -upload -plan Plan.xml

Exit the WebLogic Scripting Tool by entering:
```
exit()
```
Exit the shell by entering:
```
exit
```
Go to the login screen to check that the application is running. The URL is:

http://host_name.company_domain.com:port/lsw/dme/faces/DmeLogin.jsf

For example:

http://srv123.example.com:1234/lsw/dme/faces/DmeLogin.jsf

4.3 Apply the Latest Patch Set

Note:

Oracle recommends that you install the latest Oracle DMW patch set for release 2.4.

Check My Oracle Support article 1558745.1, Oracle Health Sciences Data Management Workbench (DMW) Summary of Patches Available at https://support.oracle.com.
Download and install the latest patch set for Oracle DMW Release 2.4 (2.4.x; for example, 2.4.7), following instructions in the patch set release notes.

Note:
Be sure to follow all instructions, including applying any technology stack patches that may be required.

4.4 Check for and Install Oracle DMW Release 2.4.x Patches

Important:

Oracle strongly advises that any patches that have been released since the release or patch set should be installed immediately.

For example, if you installed patch set 2.4.7 and there are two 2.4.7 patches (2.4.7.1 and 2.4.7.2) install 2.4.7.1 first and then 2.4.7.2, following instructions in their release notes.

Check My Oracle Support article 1558745.1, Oracle Health Sciences Data Management Workbench (DMW) Summary of Patches Available at https://support.oracle.com.
If any patches have been released on top of the release you installed, download and install all of them, in order, following instructions in their release notes.