7 Installing the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical

This chapter describes the steps for installing the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical, which includes:

1. Section 7.1, "Installing the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical"

2. Section 7.2, "Configuring the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical"

3. Section 7.3, "Configuring the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical Using Response File"

4. Section 7.4, "Deploying the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical"

Note:

Install AIA Foundation Pack before you install the PIP. Search for Oracle Fusion Middleware Installation and Upgrade Guide for Oracle Application Integration Architecture Foundation Pack 11g Release 1 (11.1.1.5.0) in My Oracle Support and download the latest version. This guide is constantly updated and bug fixed.

7.1 Installing the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical

When you use the installer, the following takes place:

• You see a welcome screen that lists prerequisites and information about how to begin the installation process.

• The following prerequisite system checks are performed:

  • Operating system certification

  • Recommended operating system packages

  • Kernal parameters

  • Recommended gilbc version

  • Physical memory

• You are prompted to enter the installation location.

• You see an installation summary, which includes directory details, disk space required and available, and a list of the applications that are installed.

• You can choose to save the Response file, which stores the values that you have input and are displayed on the installation summary page.

To install the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical:

1. Download Oracle Study, Subject, and Visit Synchronization Integration Pack for Siebel Clinical and Oracle Clinical V11.1 from edelivery.

2. Unzip aia-sc_oc-pip.zip to any location on the server.

3. Navigate to sc_oc-pip > Disk1.

4. Follow the launch instructions for your platform. Table 7-1 lists the commands that you must use based on your platform. Installer launches the Welcome screen.

   Table 7-1 Launching the PIP Installer

   Platform	To launch the Oracle AIA Installer:
   Linux x86 Linux x86 (64-bit) Solaris SPARC (64-bit)	At the command line prompt, enter: ./runInstaller -invPtrLoc <SOA_HOME>/oraInst.loc -jreloc <location of the jre specific to your operating system. This directory should have /bin/java>
   Microsoft Windows 2008 (32-bit or 64-bit)	Double-click setup.exe.

   
   

5. Click Next.

6. Select AIA Home where Foundation Pack is installed.

7. Click Next.

8. Review the installation summary. To save the response file, click Save.

   The response file stores the values that you previously entered and are on the summary page. If you want to do the reinstall, you can run a command and the installer performs a silent install with inputs from response file instead of using the wizard.

   This is an example of the command. Observe the -silent and -response arguments.

   ./runInstaller -invPtrLoc <SOA_Home>/oraInst.loc -jreLoc <location of the jre specific to your operating system> -silent -response <full path to response file>

9. Click Install. A warning message is displayed.

   The warning message: This installation will overwrite your AIAHOME with new content. Should your AIAHOME have customizations that you wish to preserve, please make a backup before you proceed. Are you sure you are ready to continue with the current installation? is displayed.

   Click Yes to proceed with the installation.

   Or

   Click No to go back to the previous screen. For backing up the AIAHOME and preserving customizations, see Section 5.1.

10. Click Next.

11. Click Finish.

12. Verify that the PIPManifest.xml file exists under <AIA_HOME>/pips/StudySubjectVisitSyncSCandOC/config. Also review the install log files located in the <AIA_HOME>/cfgtoollogs/oui directory.

7.2 Configuring the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical

The screens that are displayed prompt you to enter the data that is required for successful configuration of the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical. Keep the completed worksheets of the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical screens ready before you launch the configuration wizard. For more information, see Chapter 6.

To configure the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical:

1. Navigate to <AIA_Instance>/bin and run the following command as per your platform to configure the installation environment:

   • On Linux: aiaenv.bat

   • On Windows: source aiaenv.sh

2. Navigate to <AIA_HOME>/bin and run the following command as per your platform

   • On Linux: ./aiaconfig.sh

   • On Windows: aiaconfig.bat

   This launches the AIA Configuration Wizard.

3. Click Next.

4. Select Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical.

5. Click Next.

   The PIP Server Details screen is displayed.

Specifying the PIP Server Details

To specify the PIP Server details:

1. In the PIP Server Details screen, enter information related to your PIP server.

2. Click Next.

   The Siebel Life Sciences Server Details screen is displayed.

Specifying the Siebel Life Sciences Server Details

To specify the Siebel Life Sciences Server details:

1. In the Siebel Life Sciences Server Details screen, enter information about your Siebel Life Sciences Server instance.

2. Click Next.

Specifying Oracle Clinical Server Details

To specify Oracle Clinical Server details:

1. In the Oracle Clinical Server Details screen, enter information about your Oracle Clinical environment.

   Note:

   Oracle Clinical web services hostname and Oracle Clinical Http port fields, in the Oracle Clinical Server Details screen; refer to the SOA FMW hostname and the SOA port respectively.

2. Click Next.

Specifying Oracle Clinical Remote Data Capture Database Details

To specify Oracle Clinical Remote Data Capture Database details:

1. In the Oracle Clinical Remote Data Capture Database Details screen, enter information about your Oracle Clinical environment.

2. Click Next.

Specifying Session Pool Manager Details

To specify Session Pool Manager details:

1. In the Session Pool Manager Details screen, enter information related to your Session Pool Manager installation.

2. Click Next.

Completing Configuration

To complete configuration:

1. In the Configuration Summary screen, review the configuration information.

   Note:

   If you want to make changes to the configuration before starting the installation, use the navigation pane on the left and select the topic you want to edit. You can also create a response file based on the input provided and use it for future installations and deployments.

2. Click Configure to accept this configuration and begin the installation.

   The system displays progress of the configuration in the Configuration Progress screen.

   The system displays any warnings or errors as necessary. You can review the configuration log for additional details. The configuration log location is displayed in the Configuration Progress screen.

3. When the configuration process completes without errors, the AIA Configuration Wizard displays the Configuration Progress screen.

4. Click Next.

5. Click Finish to close the configuration wizard.

7.3 Configuring the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical Using Response File

To configure the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical using response file, perform the following:

1. Open the Response file.

   When you create a response file through Oracle Universal Installer (OUI), passwords get stored as <SECURE>.

2. Replace the password fields with actual passwords in the response file.

3. Navigate to <AIA_Instance>/bin and run the following command to configure the environment:

   • On Linux: source aiaenv.sh

   • On Windows: aiaenv.bat

4. Navigate to <AIA_HOME>/bin and run the following command:

   • On Linux: ./aiaconfig.sh <Response File Location and Name>

   • On Windows: aiaconfig.bat <Response File Location and Name>

5. Remove the passwords from the response files.

7.4 Deploying the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical

To deploy the Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical to Fusion Middleware server:

1. Navigate to <AIA_Instance>/bin and run the following command as per your platform to configure the installation environment:

   • On Linux: source aiaenv.sh

   • On Windows: aiaenv.bat

2. Run the command for your platform.

   Note:

   When you copy and paste the command in the command line, ensure that there is space between .xml and -. Ensure that there is space between these two when you run undeployment command too.

Table 7-2 Deployment commands for Study, Subject, and Visit Synch: Siebel Clinical - Oracle Clinical

Platform	Deployment Command
Linux x86 Linux x86 (64-bit) Solaris SPARC (64-bit)	ant -f <AIA_HOME>/Infrastructure/Install/AID/AIAInstallDriver.xml -DDeploymentPlan=<AIA_HOME>/pips/StudySubjectVisitSyncSCandOC/DeploymentPlans/StudySubjectVisitSyncSCandOCDP.xml -DPropertiesFile=<AIA_HOME>/aia_instances/<aia_instance>/config/AIAInstallProperties.xml -DSupplementaryDeploymentPlan=<AIA_HOME>/pips/StudySubjectVisitSyncSCandOC/DeploymentPlans/StudySubjectVisitSyncSCandOCSupplementaryDP.xml -l <AIA_HOME>/pips/StudySubjectVisitSyncSCandOC/DeploymentPlans/StudySubjectVisitSyncSCandOC.log
Microsoft Windows 2008 (32-bit or 64-bit)	ant -f <AIA_HOME>\Infrastructure\Install\AID\AIAInstallDriver.xml -DDeploymentPlan=<AIA_HOME>\pips\StudySubjectVisitSyncSCandOC\DeploymentPlans\StudySubjectVisitSyncSCandOCDP.xml -DPropertiesFile=<AIA_HOME>\aia_instances\<aia_instance>\config\AIAInstallProperties.xml -DSupplementaryDeploymentPlan=<AIA_HOME>\pips\StudySubjectVisitSyncSCandOC\DeploymentPlans\StudySubjectVisitSyncSCandOCSupplementaryDP.xml -l <AIA_HOME>\pips\StudySubjectVisitSyncSCandOC\DeploymentPlans\StudySubjectVisitSyncSCandOCDP.log

To verify successful deployment, review the log file in the location specified in the command.

AIA ships a few artifacts in AIA Lifecycle Workbench which can be used in your integrations. You can modify these native artifacts or add new natively supported artifacts using AIA Lifecycle Workbench and generate a BOM.xml file.

AIA Foundation Pack also supports the deployment of custom artifacts. These artifact types are beyond what is natively supported by Project Lifecycle Workbench and AIA Harvester. For example, you can now deploy third party technology artifacts which constitute part of integration landscape in addition to those provided by AIA.

For more information about generating deployment plans and deploying artifacts, see Oracle® Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack 11g Release 1 (11.1.1.5.0).

7.5 Securing SOA Server and Siebel Web Services

For information on securing SOA server and Siebel web services, see Oracle® Study, Subject, and Visit Synchronization Integration Pack for Siebel Clinical and Oracle Clinical Security Guide.