6 Deploying the Mobile CRA Configuration Utility

This chapter details the deployment of the Mobile CRA Configuration Utility. It includes the following sections:

• Section 6.1, "Verifying the Installation Package"

• Section 6.2, "Configuring Data Sources for Mobile CRA Configuration Utility"

• Section 6.3, "Configuring Security for Mobile CRA Configuration Utility"

• Section 6.4, "Using Single Sign On and Lightweight Directory Access Protocol for Mobile Clinical Research Associate Server"

• Section 6.5, "Deploying Mobile CRA Server Configuration Utility"

• Section 6.6, "Customizing the Configuration File for Mobile CRA Configuration Utility"

• Section 6.7, "Verifying Deployment"

6.1 Verifying the Installation Package

You must validate the installation package before deploying. To validate, ensure that:

• The Install package is deployed as an Enterprise Archive file called Mobile CRA_AdminUI.ear.

• The EAR file contains ADF related application files.

• The EAR file also includes the WAR file, which contains the actual web application.

• The file name contains the build version as mentioned in the Release Notes.

Note:

For deploying the Mobile CRA Configuration Utility, see Oracle WebLogic Administration Guide.

6.2 Configuring Data Sources for Mobile CRA Configuration Utility

You need to configure the following data sources for the Mobile CRA Configuration Utility:

• jdbc/ae - Connects to the alerts schema and handles the alert generation.

• jdbc/mobileaq - Connects to the Oracle AQ schema and handles the asynchronous message handling of trip report.

• jdbc/mobilecda - Connects to the CDA schema and handles the CDA adapter related functionality.

• jdbc/mobilecra - Connects to the Mobile CRA server schema and handles the Mobile CRA server functionality.

• jdbc/mobilectms - Connects to the Mobile CRA Trip Report schema and handles the trip report configuration and other Mobile CRA Configuration Utility related functionality.

The following steps explain how to create jdbc/mobilecda data source:

1. Within the Server Administration Console, select Data Sources under Services.

   Figure 6-1 Server Administration Console

   
   Description of "Figure 6-1 Server Administration Console"
   
   

   The Summary of JDBC Data Sources screen is displayed.

2. Select New and then select Generic Data Source from the drop-down list.

   Figure 6-2 Summary of JDBC Data Sources Screen

   
   Description of "Figure 6-2 Summary of JDBC Data Sources Screen"
   
   

   The Create a New JDBC Data Source screen is displayed.

3. Enter jdbc/mobilecda as the name and JNDI name to connect to MCRE_ADMIN schema.

   Figure 6-3 Creating a New JDBC Data Source Screen

   
   Description of "Figure 6-3 Creating a New JDBC Data Source Screen"
   
   

4. Select database driver as Oracle Driver (Thin XA) (versions: 9.0.1 and later).

   Note:

   In case the WebLogic Server version is 10.3.6.0 (the default is 10.3.5.0), for jdbc/mobilecda, you should select Database Driver as Oracle's Driver (Thin) during the installation.

   Figure 6-4 Selecting Database Driver

   
   Description of "Figure 6-4 Selecting Database Driver"
   
   

5. Select default settings as displayed in Figure 6-5.

   Figure 6-5 Selecting Default Settings

   
   Description of "Figure 6-5 Selecting Default Settings"
   
   

6. Configure connection properties as displayed in Figure 6-6.

   Figure 6-6 Configuring Connection Properties

   
   Description of "Figure 6-6 Configuring Connection Properties"
   
   

7. Upon completion, select Test Configuration to validate the connection.

   Figure 6-7 Selecting Test Configuration

   
   Description of "Figure 6-7 Selecting Test Configuration"
   
   

   The Connection test succeeded message is displayed.

8. Repeat Step 3 to 7 to create jdbc/ae, jdbc/mobileaq, jdbc/mobilecra, and jdbc/mobilectms.

   Note:

   For jdbc/mobilectms, you should select Database Driver as Oracle's Driver (Thin) instead of (Thin XA) during the installation.

Note:

For information about the NS_ADMIN data source, see the Oracle Health Sciences Mobile Clinical Research Associate Health Sciences Push Notification Service Installation and Configuration Guide.

6.3 Configuring Security for Mobile CRA Configuration Utility

For information about configuring security for Mobile CRA Server, see Oracle Health Sciences Mobile Clinical Research Associate Server Security Guide.

6.4 Using Single Sign On and Lightweight Directory Access Protocol for Mobile Clinical Research Associate Server

To use Single Sign On (SSO) and Lightweight Directory Access Protocol (LDAP), see the following documents:

• http://docs.oracle.com/cd/E29306_01/index.htm

• http://docs.oracle.com/cd/E27559_01/index.htm

6.5 Deploying Mobile CRA Server Configuration Utility

To deploy Mobile CRA Server Configuration Utility, perform the following:

1. Log in to the Oracle WebLogic Server Administration Console.

2. Within Server Administration, select Deployments.

   Figure 6-8 Selecting Deployments

   
   Description of "Figure 6-8 Selecting Deployments"
   
   

   The Summary of Deployments screen is displayed.

3. Select Install to deploy application.

   Figure 6-9 Summary of Deployments Screen

   
   Description of "Figure 6-9 Summary of Deployments Screen"
   
   

4. Browse the directory where the install package is located.

   Figure 6-10 Browsing the Directory

   
   Description of "Figure 6-10 Browsing the Directory"
   
   

5. Select the Mobile CRA_AdminUI_v1.3.ear file.

   Figure 6-11 Selecting the Default File

   
   Description of "Figure 6-11 Selecting the Default File"
   
   

6. Select the Install this deployment as an application option.

   Figure 6-12 Choosing the Targeting Style

   
   Description of "Figure 6-12 Choosing the Targeting Style"
   
   

7. Select default settings as displayed in Figure 6-13.

   Figure 6-13 Selecting the Default Settings

   
   Description of "Figure 6-13 Selecting the Default Settings"
   
   

8. Select Finish to complete installation.

   Figure 6-14 Selecting Finish

   
   Description of "Figure 6-14 Selecting Finish"
   
   

9. Validate that the installed application is listed on the Deployments screen.

   Figure 6-15 Validating the Application

   
   Description of "Figure 6-15 Validating the Application "
   
   

6.6 Customizing the Configuration File for Mobile CRA Configuration Utility

To customize the configuration file config_adminui.xml for Mobile CRA Configuration Utility, perform the following:

1. From the Config folder of the media pack, select config_adminui.xml.

   This is a template file where you have to update values for customization.

2. Create a copy of config_adminui.xml and save it as adminui_plan.xml.

   For an example of config_adminui.xml, see Appendix B.

3. Modify configuration values for your environment.

   The adminui_plan.xml file lets you configure your Mobile CRA Configuration Application to point to the right CTMS and ASAAG servers.

4. Change the following basic settings in the adminui_plan.xml file:

   Note:

   The ctmsAdapter.hostname, ctmsAdapter.port, and adaptiveSaag.url properties in the adminui_plan.xml file should match the respective values defined in the plan.xml file for MobileCRA Server Application. For more information, see Section 5.1.5.

   • ctmsAdapter.hostname - The name of the CTMS host to which the mobile instance should connect for accessing and manipulating data. For example, server.domain.com.

     Note:

     If you use CTMS IP 2015, enter the IP address instead of host name.

   • ctmsAdapter.port - The CTMS port host. For example, 8080. If the default port is used, enter a value 0 instead of null.

   • adaptiveSaag.url - Host name of the ASAAG server. For example, server.domain.com.

6.7 Verifying Deployment

To verify deployment, perform the following:

1. Enter the following URL for the Mobile CRAConfiguration Utility:

   http://<server:port>/MobileAdminCRA/faces/login.jspx?

   The Login page is displayed.

2. Figure 6-16 Login Page

   
   Description of "Figure 6-16 Login Page"
   
   

3. Enter the user name and password.

   The Mobile CRA Configutation Utility Home Page is displayed.

   Figure 6-17 The Mobile CRA Configuration Utility Home Page

   
   Description of "Figure 6-17 The Mobile CRA Configuration Utility Home Page"