D Deploying Customizations

This chapter describes how you can deploy customizations you perform on any file.

After you customize a file, you may need to redeploy the EAR file for your changes to become available. Do so by following the steps below:

Section D.1, "Locating the olsardc.ear File"
Section D.2, "Manually Extracting and Repacking the olsardc.ear File"
Section D.3, "Deleting the Existing Deployment"
Section D.4, "Redeploying RDC with Customizations"
Section D.5, "Restarting the OPA Server"

Note:

These processes cause downtime of the application.

D.1 Locating the olsardc.ear File

Log in to the administrator server console for OPADomain using a URL of the form http://machinename:port/console.

For example, http://pharma.company.com:7101/console.
Click on Deployments and select the checkbox for olsardc.
Make a copy of olsardc.ear from the upload folder or equivalent path: middleware_home\user_projects\domains\OPADomain\servers\AdminServer\upload\olsardc.ear.

Note:
To find the upload path, go to the administrator server console for the OPA domain. Click on Deployments, then select the checkbox for olsardc and click Update. The Source path will display the current upload location.

D.2 Manually Extracting and Repacking the olsardc.ear File

If you do not have an unzip utility installed, you can manually extract and then repack the EAR file by following the steps below.

To extract the olsardc.ear file:

Open a DOS Command window and navigate to the upload directory.

See Section D.1, "Locating the olsardc.ear File" for information on how to find the upload directory.
Back up the olsardc.ear file.
Create a new temporary directory called mycustomloc and then copy the olsardc.ear file to that directory as shown in the below example:
```
C:\mycustomloc>copy C:\app\oracle\middleware\user_projects\domains\OPADomain\servers\AdminServer\upload\olsardc.ear
```

Extract olsardc.ear using the jar utility command:

middleware_home\Oracle_FRHome1\jdk\bin\jar -xvf olsardc.ear

For example:

C:\mycustomloc>C:\app\oracle\middleware\Oracle_FRHome1\jdk\bin\jar -xvf olsardc.ear

The file RdcSurroundAdfWebUIWebApp.war is in the extracted directory.

Create another temporary directory called RdcSurroundAdfWebUIWebApp and move the RdcSurroundAdfWebUIWebApp.war to this new directory.
Extract the RdcSurroundAdfWebUIWebApp.war file using the jar utility command
```
middleware_home\Oracle_FRHome1\jdk\bin\jar -xvf RdcSurroundAdfWebUIWebApp.war
```
For example: C:\mycustomloc\RdcSurroundAdfWebUIWebApp>C:\app\oracle\middleware\Oracle_FRHome1\jdk\bin\jar -xvf RdcSurroundAdfWebUIWebApp.war

After extracting the file, you can access the RDC application WEB-INF directory and all files under it from within the newly extracted directory.
Make changes to the files as necessary.
Save your changes.

To repack the olsardc.ear file:

Open a DOS Command window and navigate to the temporary directory RdcSurroundAdfWebUIWebApp.
If present, remove the RdcSurroundAdfWebUIWebApp.war file from this directory.
Rebuild the RdcSurroundAdfWebUIWebApp.war file using the jar command
```
middleware_home\Oracle_FRHome1\jdk\bin\jar -cvf RdcSurroundAdfWebUIWebApp.war *
```
For example: C:\mycustomloc\RdcSurroundAdfWebUIWebApp>C:\app\oracle\middleware\Oracle_FRHome1\jdk\bin\jar -cvf RdcSurroundAdfWebUIWebApp.war *

The process created the RdcSurroundAdfWebUIWebApp.war file.
Move RdcSurroundAdfWebUIWebApp.war to the temporary directory mycustomloc.
Navigate to the temporary directory mycustomloc.
Delete the RdcSurroundAdfWebUIWebApp directory using the command:
```
rd /S /Q RdcSurroundAdfWebUIWebApp
```
If present, remove the olsardc.ear file from the mycustomloc directory.
Rebuild the olsardc.ear using the jar command:
```
middleware_home\Oracle_FRHome1\jdk\bin\jar -cvf olsardc.ear *
```
For example:

C:\mycustomloc>C:\app\oracle\middleware\Oracle_FRHome1\jdk\bin\jar -cvf olsardc.ear *
Copy the new olsardc.ear file to the upload directory middleware_home\user_projects\domains\OPADomain\servers\AdminServer\upload.

For example:

C:\mycustomloc>copy /Y olsardc.ear C:\app\oracle\middleware\user_projects\domains\OPADomain\servers\AdminServer\upload

Note:
Copy the new olsardc.ear file to the same location as the one entered in the Source path field.
To find the source path, go to the administration server console for the OPA domain. Click Deployments. Select the checkbox for olsardc and then click Update. After confirming the source path, click Cancel to exit the Update Application Assistant screen.

D.3 Deleting the Existing Deployment

Log in to the administrator server console for the OPA domain using a URL of the form http://machinename:port/console.

For example, http://phrama.company.com:7101/console
Click on Deployments.
Select the checkbox for olsardc, select it and click Stop, then click Force Stop Now.
Select the checkbox for olsardc one more time and click Delete.

If you are prompted to proceed with the deletion, click OK to confirm.

Note:

This removes olsardc.ear from the application server.

D.4 Redeploying RDC with Customizations

RDC application files are inside the olsardc.ear archive, so whenever you make changes to a file, you need to redeploy RDC for these changes to take effect.

Redeploy RDC if you have applied any of the following customizations:

Setting Web Command Access
Customizing the Electronic Signature (Approval) Warning Message
Customizing Online Help
Made changes to the bc4j.xcfg file for performance customizations, as described in the section ”Updating the bc4j.xcfg Settings” in the Oracle Clinical Remote Data Capture Onsite and Oracle Thesaurus Management System Browser Infrastructure Tuning Tips for Releases 5.0.1 and 5.1, available on My Oracle Support (Article ID 1965232.1).

To redeploy RDC:

Log in to the administrator server console for the OPA domain using a URL of the form http://machinename:port/console. For example, http://pharma.company.com:7101/console.
Click on Deployments and select the olsardc checkbox.
Click Update.
Click Next.
Click Finish to complete the deployment.
Restart the OPA server.

D.5 Restarting the OPA Server

Upon redeployment, you need to restart the OPA server so that any changes.

Log in to the administrator server console for the OPA domain using a URL of the form http://machinename:port/console.
Click on Environments and then Servers.
Select the Control tab.
Select the checkbox for OpaServer1.
Click on Shutdown and then Force Shutdown Now.
Refresh the screen by clicking on the auto refresh icon.
Once the status of OpaServer1 changes to SHUTDOWN, click on the auto refresh icon again to turn it off.
Select the checkbox for OpaServer1 and click Start.
Turn auto refresh on again to verify that the server status changes to RUNNING.

Once the OPA server is restarted, you can verify your customizations.