Skip Headers
Oracle® Clinical Installation Guide
Release 5.1

E53553-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

1 Preparing to Install Oracle Clinical

This chapter includes:

Licenses for Remote Data Capture with Oracle Clinical

The installation of Oracle Clinical automatically includes the installation of Oracle Clinical Remote Data Capture Onsite (RDC). However, Oracle Clinical licenses do not cover entering data at remote sites. Separate Remote Data Capture Onsite licenses are required for remote site use. Your Oracle Clinical license includes a Restricted Use license for Remote Data Capture that permits the licensed Oracle Clinical user population to use Remote Data Capture at the sponsor's or CRO's location, but not at the clinical site.

OPA and OLSA Internal Names

The Oracle Clinical and Oracle Clinical Remote Data Capture (RDC) products are now part of the Oracle Health Sciences Global Business Unit (HSGBU). These products were formerly part of the Oracle Life Sciences Applications (OLSA) and the Oracle Pharmaceutical Applications (OPA) organizations. During the installation you will see references to OLSA and OPA in the software (such as in directory names, file names, and screen text) that have not been changed.

1.1 Installation and User Documentation

Be aware of these additional resources.

1.1.1 My Oracle Support Articles

Visit the My Oracle Support website for the most up-to-date installation information, including alerts, release notes, bulletins, White Papers, and patches; see "Finding Information and Patches on My Oracle Support".

The My Oracle Support website includes these important installation topics:

  • Oracle Clinical 5.1 Release Notes (Article ID 1931214.1) The latest version of these release notes are on My Oracle Support.

  • Installation Verification Test (Article ID 329494.1

  • OLSA Known Installation and Configuration Issues (Article ID 1572864.1)

  • Oracle Clinical, Oracle Clinical Remote Data Capture, and Oracle Thesaurus Management System Security Configuration Guide available with the user documentation; see Section 1.1.2, "User Documentation."

  • Oracle Health Sciences (Life Sciences/ Pharmaceutical/ Healthcare) Supported Technology Stacks (Article ID 180430.1)

  • Oracle Clinical Summary of Patches Available (Article ID 121863.1)

  • Oracle Clinical/RDC Product Information Center (Article ID 1331795.1): Check here for new notes and White Papers, including the performance White Paper and the Installation Verification Test, which are not available at the time of publication of this document.

1.1.2 User Documentation

The most current Oracle Clinical and Oracle Clinical Remote Data Capture (RDC) Onsite user documentation is located on oracle.com at:

http://www.oracle.com/technetwork/documentation/hsgbu-clinical-407519.html

Oracle Clinical and RDC Onsite user documentation includes the following guides.

  • Oracle Clinical Installation Guide

  • Oracle Clinical Administrator's Guide

  • Oracle Clinical Getting Started

  • Oracle Clinical Creating a Study

  • Oracle Clinical Conducting a Study

  • Oracle Clinical Application Programming Interface Guide

  • Oracle Clinical Remote Data Capture Onsite Administrator's Guide

  • Oracle Clinical Remote Data Capture Onsite User's Guide

  • Oracle Clinical, Oracle Clinical Remote Data Capture, and Oracle Thesaurus Management System Security Configuration Guide

In addition, Oracle Clinical customers can request a copy of the Oracle Clinical Stable Interface Technical Reference Manual from Oracle Support.

1.2 Architecture

The architecture for Oracle Clinical consists of three tiers: the database tier, the application tier, and the client tier.

Figure 1-1 illustrates the architecture and technology stack for Oracle Clinical.

Figure 1-1 Oracle Clinical and RDC Onsite Logical Architecture

Surrounding text describes Figure 1-1 .

The database tier in an Oracle Clinical environment includes Oracle Database, the Oracle Clinical database server, one or more Oracle Clinical databases, and the Oracle Clinical parameterized submission (PSUB) process, which is the batch processor for Oracle Clinical. Optionally, the database tier can include SAS. The database tier can run on UNIX or Windows. (However, a Real Application Clusters (RAC) installation is supported only on UNIX.)

The application tier must be installed on Windows. It has three parts:

  • Oracle Application Server, which includes Oracle Forms Server and servlet, Oracle Reports Server and servlet, Oracle HTTP Server, and Oracle JVM (Java Virtual Machine) and supports the following Oracle Clinical components:

    • Oracle Clinical Forms Server — performs all forms processing, communicates the display changes to the client, and calls forms to query, update, select, and delete data from the database for the Oracle Forms-based applications: Oracle Clinical and the RDC Administration module.

    • Oracle Clinical Reports Server — runs most batch reports, schedules all jobs, including PSUB jobs, and runs job sets. In addition, it creates PDF output for Patient Data Reports, Blank Casebook Reports, and Audit Reports.

    • Oracle Clinical Graphic Layout Editor — supports creating CRF layouts from Oracle Clinical DCIs.

    • Oracle Clinical Servlet — supports file viewing

    • DLLs — used for data entry in both Oracle Clinical and RDC Onsite

  • Oracle WebLogic Server and Oracle Application Developer's Runtime, also known as Oracle Application Developer's Framework (ADF) — support Oracle Clinical Remote Data Capture Onsite.

  • Oracle Business Intelligence (BI) Publisher — runs the Patient Data Report and the Blank Casebook Report.

The client tier communicates users' input to the application tier. It must run on Windows through a browser, using native Oracle JVM. Both the RDC Onsite data entry Java script and the Oracle Clinical PDF Plug-In, which is required for graphic layout design, run on the client tier. See Section 6.5, "Make the Oracle Clinical PDF Plug-in Available to Users".

The Oracle HTTP Server (OHS) handles the communication between clients and the application tier.

Figure 1-2 Oracle Clinical Network Topology

Diagram is described in the surrounding text.

Figure 1-2 shows how the Oracle Clinical and RDC Onsite components and technology stack are related and provides an example of how the product can be installed. The left side of the Application Tier—APPHOST1—is a standard installation, while the whole—with APPHOST2—shows a multi-node middle tier installation using Oracle Clusterware.

In the client tier, end users' browsers communicate via HTTPS with the Oracle HTTP Server (OHS), which is located inside a firewall. When users log in, OHS detects the product they logged in to and consults formsweb.cfg to connect them to the appropriate application tier service.

The application tier comprises Oracle Application Server and Oracle WebLogic Server. The integrated tier has two domains:

  • FRDomain includes the Oracle Forms runtime service and Forms Server, and the Oracle Reports Server and engine. It also includes the WebLogic Server Admin Server and Oracle Enterprise Manager.

    The Oracle Application Server domain must be named FRDomain and must use port number 7001.

  • OPADomain includes the WebLogic Server Administration Console, WebLogic Server Java, and OpaServer1, which are required to run RDC Onsite and, if you have Oracle Thesaurus Management System (TMS) installed, the TMS Browser and TMS reports. It also contains the database connections. Note that when you install the Oracle Enterprise Manager in the FRDomain, it serves for monitoring the OPADomain as well.

    The Oracle Clinical Installer automatically creates the OPADomain. OPADomain must use port number 7101.

You can distribute the application tier over multiple nodes in a network using Oracle Clusterware. The Admin Server is required only on the primary node.

The WebLogic Server Node Manager exists outside the domains on the host. The Oracle Clinical Installer automatically stops the Node Manager before each Java deployment and starts the Node Manager afterward so you do not need to do that.

The database tier includes Oracle Database with Oracle Clinical and (optionally) Oracle Thesaurus Management System. Remote Data Capture Onsite uses the Oracle Clinical database. The diagram shows a distributed installation using Oracle Real Application Clusters (RAC); this is one example of how it can be installed.

1.3 Technology Stack

The following tables list technology stack requirements for the database tier, the application tier, and the client tier:

The following sections following the tables provide additional information about requirements:

For updates to the technology stack, see Oracle Health Sciences (Life Sciences/ Pharmaceutical/ Healthcare) Supported Technology Stacks (Article ID 180430.1) on My Oracle Support; see "Finding Information on My Oracle Support".

Table 1-1 Oracle Clinical Database Tier Technology Stack

Component Supported Version

Operating System

Oracle Linux 6.4 with Unbreakable Enterprise Kernel (UEK), 64 bit (US English)

Oracle Solaris SPARC 10 and 11, 64-bit architecture (US English)

HP Itanium 11.31; 64-bit architecture (US English)

Windows Server 2008 Release 2, Service Pack 1; 64-bit architecture (US English)

Oracle Database

12c Release 1 (12.1.0.1) Enterprise Edition, 64-bit

Compiler

For Oracle Linux x86-64: GNU GCC-4.4.6

For Oracle Solaris SPARC 10 and 11: Sun Studio 12

For HP Itanium: HP C/aC++ for Integrity Servers B3910B A.06.27

Optional Software

SAS 9.3—Note that if you install the Oracle Clinical database tier on Windows, you must install SAS on Windows.

Oracle Real Application Clusters (RAC) on Sun, HP, and Linux, including Exadata

Oracle Virtual Machine (OVM) 3.2

Pro*C/C++ Release 12.1.0.1

Visual C++ in Microsoft Visual Studio 2010—Optional. Can be used to invoke Data Capture API methods from custom clients.


Table 1-2 Oracle Clinical and RDC Onsite Application Tier Technology Stack

Component Supported Version

Operating System

Microsoft Windows Server 2008 Release 2; Service Pack 1 or 2; 64-bit architecture

Oracle Application Server

Oracle Application Server 11g Release 2 (11.1.2.1.0); 64-bit architecture

Oracle WebLogic Server

Oracle WebLogic Server 11g R1 (10.3.6)

Oracle ADF

Oracle Applicaton Developer's Framework 11g R2 (11.1.2.4)

Oracle Java Development Kit (JDK)

Oracle Java Development Kit 1.6.0_65, also known as JDK 6 Update 65.


Table 1-3 Oracle Clinical and RDC Onsite Client Tier Technology Stack

Component Supported Version

Operating Systems

Microsoft Windows 7; Service Pack 1; 32-bit or 64-bit architecture (US English)

Microsoft Windows Server 2008; Release 2; Service Pack 1; 64-bit architecture (US English)

Microsoft Windows 8/8.1; 64-bit architecture

Mobile Operating Systems

iOS 7.1.2—iPad and OS X 10.7.5—for RDC Onsite only

Supported Browsers

Microsoft Internet Explorer versions depend on the operating system:

  • Microsoft Windows 7 (32-bit): Internet Explorer 9

  • Microsoft Windows 7 (64-bit): Internet Explorer 9, 10, or 11

  • Microsoft Windows Server 2008; Release 2; Service Pack 1 (64-bit): Internet Explorer 9, 10, or 11

  • Microsoft Windows 8/81 (64-bit): Internet Explorer 10 or 11

Safari 7.0.3 on iOS 7.1.2, for Oracle RDC Onsite only

Adobe Reader

Releases 8x, 9.x, 10.x, 11.x (US English)
Required for viewing reports, including Patient Data Reports (PDRs)

Adobe Acrobat

Releases 8x, 9.x, 10.x, 11x (US English)
Required for creating annotated layouts

Oracle Java Runtime Environment (JRE)

Java SE 7 Update 65 (Standard Edition, Version 1.7.0.65


1.3.1 Planning an Oracle Clinical Database Tier Installation

This section provides additional information about installation requirements.

1.3.1.1 Character Set Requirements

For information about the guidelines and requirements for character sets, see Section 1.8, "Choosing a Character Set."

1.3.1.2 Critical Patch Update

You must obtain the latest Critical Patch Update (CPU) certified by Oracle Health Sciences from My Oracle Support and install it on each database and application tier server computer; see Section 1.9, "Applying Oracle Critical Patch Updates.".

1.3.1.3 Database Tier Operating System Requirements

See Table 1-1, "Oracle Clinical Database Tier Technology Stack" for basic information.

To verify that your system fits the requirements listed in Table 1-1, "Oracle Clinical Database Tier Technology Stack" do the following in UNIX or Windows:

UNIX To verify UNIX operating system details, enter the following command:

uname -a

In addition, to verify the update version for Linux, enter the following command:

cat /etc/issue

Windows To verify Windows operating system details, navigate to the Control Panel, then System and Security, then System.

1.3.1.4 Oracle Database Requirements and Options

Oracle Clinical has the following database options:

1.3.1.4.1 Oracle Database Partitioning Option

Oracle Clinical supports partitioning, but this feature is disabled by default. To use it, buy and install the Partitioning Option. See the Oracle Clinical Administrator's Guide for information about partitioning.

1.3.1.4.2 Distributed Database Option and Advanced Replication Option

are required if and only if you are using Oracle Clinical Distributed Study Conduct (Replication).

See the Oracle Clinical Administrator's Guide to configure the proper codelists and database links to support replication, and for setup instructions.

1.3.1.5 Global Library Location

You must choose a database and a location for Oracle Clinical's Global Library — a definition object repository — for your installation or distributed environment. When you create a new Oracle Clinical database, you must enter the Source Location Code for the Global Library. In a distributed environment (using the replication feature), you must arrange to share the Global Library with the other databases at other locations.

1.3.1.6 Database Seed Numbers in a Replicated Environment

When you create an Oracle Clinical database, the Installer prompts you to allocate a seed number. The system uses the seed number to generate unique primary keys and allows data replication among databases without triggering unique key violations. Seed numbers for the databases within a particular replicated environment must be unique. See the section on reseeding sequences in the Oracle Clinical Administrator's Guide for more information.

1.3.2 Planning an Oracle Clinical Application Tier Installation

See Table 1-2, "Oracle Clinical and RDC Onsite Application Tier Technology Stack" for basic information.

Note:

The default application tier installation uses HTTPS.

1.3.2.1 Character Set Requirements

For information about the guidelines and requirements for character sets, see Section 1.8, "Choosing a Character Set."

1.3.2.2 Critical Patch Update

You must obtain the latest Critical Patch Update (CPU) certified by Oracle Health Sciences from My Oracle Support and install it on each database and application tier server computer; see Section 1.9, "Applying Oracle Critical Patch Updates.".

1.3.2.3 Oracle Clinical Forms and Reports Servers

The Oracle Clinical Forms Server is part of the Front End Installer. The Oracle Clinical Reports Server has its own Installer. You can install both on the same server computer or install them on different computers.

To ensure high availability of the Reports Server, you can set up and use more than one Reports Server on a subnet and they can access each other. For more information see the Oracle Clinical Administrator's Guide.

You must install the full application tier technology stack on each server computer.

1.3.2.3.1 Shared Directory

If you have multiple Oracle Clinical Forms and/or Reports Server computers, you must select a shared directory to be accessible from all servers for storing report output and logs.

1.3.2.3.2 Permanent IP Address

Every computer on which either the Oracle Clinical Forms or Reports Server is installed must have a permanent IP address.

1.3.3 Planning an Oracle Clinical Client Installation

In addition to the software noted in Table 1-3, "Oracle Clinical and RDC Onsite Client Tier Technology Stack", a client requires an intranet or internet connection to the application tier. In addition, see Chapter 10, "Setting Up Clients."

1.4 Supported Configurations with Oracle Data Guard and RAC

Oracle Clinical 5.1 supports a distributed environment over a network or within an Exadata machine without using Oracle Clinicalreplication.

This section contains:

For more information, see:

1.4.1 Supported Configurations with Oracle Real Application Clusters (RAC)

Oracle Clinical was re-architected in Release 5.0 to support Oracle Real Application Clusters (RAC). The Parameterized Submission process (PSUB), which runs and schedules most jobs in Oracle Clinical, no longer uses DBMS pipes, which can only be used within a single database instance, for communication between the user session and the PSUB service. It now uses Oracle Advanced Queuing.

Because databases have traditionally been constrained to run only on a single server, customers have typically followed a hardware "scale-up" strategy for the database tier: Whenever the database server becomes a bottleneck to overall application performance, the server is replaced with a larger, faster machine. While this approach is well understood, it can be highly disruptive to ongoing business.

Oracle Real Application Clusters (RAC) provides an alternative approach for scaling database performance. It is designed to tolerate server failures with little impact to mission-critical applications and users. As workloads and user connections are increased, additional nodes (servers) can be easily added to the cluster. Each server runs against the same database simultaneously. This approach is less disruptive to ongoing business operations, more reliable, and less expensive to implement.

RAC nodes can be individual computers in a network or nodes on an Oracle Exadata machine. RAC shares the database internally among all nodes so that even if the node where the database was originally installed goes down, the other nodes can still access the database. You can configure RAC nodes as follows:

Node 1: Install and Set Up Everything Required for Oracle Clinical including:

  • Oracle Real Application Clusters (RAC)—installed with Oracle Database

  • Oracle Clinical database server code

  • Oracle Clinical database(s)

  • Run the Oracle Clinical PSUB service on this node (one per database)

  • Create user-specific PSUB log file directories for randomization, batch data load, and labs batch jobs that require input files

  • Enter PSUB-related values in local reference codelist OCL_STATE

  • Install SAS 9.3 (Optional)

Node 2: Install the Minimum Required as a RAC Node Install Oracle Database with Oracle Real Application Clusters (RAC).

You can have multiple nodes set up this way, each accessing the same database(s). Additional nodes set up this way improve database performance.

Node 3: Install Everything Required for Oracle Clinical as Backup In case either the PSUB service or Node 1 itself fails, install all required software on another node so that you can start the PSUB service as quickly as possible to continue normal operation. PSUB can run on only one server at a time.

A node set up this way also improves performance but requires additional maintenance; any Oracle Clinical database server patches you install on the primary node (Node 1 in this example) must also be installed on this node.

  • Install Oracle Real Application Clusters (RAC) and Oracle Database

  • Install Oracle Clinical database server code (includes PSUB server code)

  • Create the same PSUB directory structure as on Node 1 so that the OCL_STATE reference codelist values on the middle tier still work. If you use NFS to share the files, users will still be able to access files for jobs performed on the other node unless the node itself fails; see Section 8.5, "Running PSUB in a RAC Environment" for more information.

Note:

You do not need to reinstall the Oracle Clinical database.

You can have multiple nodes set up this way, each accessing the same database(s).

1.4.2 Supported Configurations with Oracle Data Guard

The following Oracle Data Guard configurations are supported. All Oracle Clinical components (database server, database) must be installed on each node.

  • Standalone server with Oracle Data Guard failover

  • Oracle Clusterware for One Node with Oracle Data Guard failover

  • Oracle RAC One Node with Oracle Data Guard failover

  • Multi-node RAC with Oracle Data Guard failover

1.5 Downloading and Extracting the Software

1.5.1 Creating Staging Areas

Oracle recommends creating one staging area on the database server and another on the application server. In each staging area, create one directory for each media pack disk, patch, or other software unit that needs to be downloaded to that server, as shown in Table 1-4, "Software to Download to the Database Server Staging Area" and Table 1-5, "Software to Download to the Application Server Staging Area".

Give each directory a logical name such as the media pack disk or patch name (not part or patch number) to make instructions later in this guide easier to follow.

1.5.1.1 Database Server Staging Area

Table 1-4, "Software to Download to the Database Server Staging Area" shows which software to download to the database server staging area.

Table 1-4 Software to Download to the Database Server Staging Area

Disk or Patch Name Source

Oracle Clinical 5.1.0.0 Documentation—The latest versions are posted at http://www.oracle.com/technetwork/documentation/hsgbu-clinical-407519.html.

Media pack or www.oracle.com

Oracle Clinical 5.1.0.0

Media pack

Oracle Database 12c Release 1 (12.1.0.1) — Linux x86-64

Media pack

Oracle Database 12c Release 1 (12.1.0.1) — Solaris Sparc 64

Media pack

Oracle Database 12c Release 1 (12.1.0.1) — HP IA

Media pack

Oracle Database 12c Release 1 (12.1.0.1) — Windows x64

Media pack


1.5.1.2 Application Server Staging Area

Table 1-5, "Software to Download to the Application Server Staging Area" shows which software to download to the application server staging area.

Table 1-5 Software to Download to the Application Server Staging Area

Disk or Patch Name Source

Oracle Clinical 5.1.0.0 Documentation—The latest versions are posted at http://www.oracle.com/technetwork/documentation/hsgbu-clinical-407519.html.

Most recent version is on www.oracle.com

Oracle Clinical 5.1.0.0

Media pack

Oracle WebLogic Server 11gR1 (10.3.6) Generic and Coherence

Media pack

Oracle Application Development Runtime 11g Patch Set 5 (11.1.1.6.0) (also known as Application Developer's Framework or ADF)

Media pack

ADF 11.1.2.4 patches 16546129 and 16546157

My Oracle Support

Internet Explorer 11 compatibility patch for ADF 11.1.2.4 (patch 18277436) or its successor; consult My Oracle Support document Supportability on Internet Explorer 11 (IE11) with Oracle ADF (ID 1599898.1).

My Oracle Support

Oracle Forms and Reports 11gR2 (11.1.2.1.0) for Microsoft Windows x64 (64-bit)

Media pack

Oracle Clinical PDF Plug-In (patch 12733341)

My Oracle Support

Oracle Java Development Kit 1.6.0_65, also known as JDK 6 Update 65 (patch 17046855); see Section 1.5.4, "Downloading Oracle Java Development Kit"

My Oracle Support

Java Runtime Environment (JRE) 1.7.0_65; see Section 1.5.5, "Downloading the Java Runtime Environment"

www.oracle.com

Adobe Reader; see Section 1.5.6, "Downloading Adobe Reader"

http://www.adobe.com

JSpell Spell Checker SDK for J2EE; see Section 1.5.7, "Downloading JSpell (Optional)"

http://www.jspell.com


1.5.2 Downloading and Extracting the Oracle Clinical 5.1.0.0.x and Oracle Thesaurus Management System 5.1.0.0.x Media Pack

Note:

To receive a physical media pack with all the required DVDs, contact Oracle Support. To expedite your request you can either call Oracle Support directly or open a Service Request (SR) selecting problem category: Version Update Request.

To download the software:

  1. Go to http://edelivery.oracle.com and log on.

  2. From the Select a Product Pack drop-down list, select Health Sciences.

  3. From the Platform drop-down list, select your database tier operating system.

  4. Click Go.

  5. Select Oracle Clinical 5.1.0.0.x and Oracle Thesaurus Management System 5.1.0.0.x Media Pack for Your_Operating_System and click Continue.

  6. Download each disk into a recognizably named directory in the appropriate staging area as shown in Table 1-4, "Software to Download to the Database Server Staging Area" or Table 1-5, "Software to Download to the Application Server Staging Area". Each download consists of a single file named part_number.zip.

  7. Extract each part_number.zip file into a meaningfully named directory.

  8. For the Oracle Clinical software, extract the appropriate .zip file for the server:

    • On the database server, extract server_code_platform.zip.

    • On the application server, extract application_server.zip.

1.5.3 Downloading and Extracting Patches from My Oracle Support

To download a patch from My Oracle Support:

  1. Go to My Oracle Support at https://support.oracle.com and sign in.

  2. Click the Patches & Updates tab, then enter the patch number in the Patch Name or Number is field and click Search.

  3. Click the link for your operating system and download the patch file to a recognizably named directory in the appropriate staging area.

  4. Extract the .zip file.

1.5.4 Downloading Oracle Java Development Kit

To download and install JDK:

  1. Go to My Oracle Support at https://support.oracle.com and sign in.

  2. In the Search Knowledge Base field in the upper right, enter: 1439822.1

    A page appears with a list of documents.

  3. Click the link All Java SE Downloads on MOS [Article ID 1439822.1].

  4. Scroll down the list of JDK versions to Oracle JDK 6 Update 65 (Patch 17046855).

    Note:

    Check Oracle Clinical Summary of Patches Available (Article ID 121863.1) on My Oracle Support to see if a more recent version is supported; see "Finding Information on My Oracle Support".
  5. Click the patch number link.

  6. Select Microsoft Windows x64 (64-bit) and click ReadMe to read the release notes and Download to download the patch to the staging area in a recognizably named directory.

Installation instructions are in Section 5.3, "Install Oracle Java Development Kit".

1.5.5 Downloading the Java Runtime Environment

Oracle Clinical and the RDC Administration application require that Java Standard Edition (SE) Runtime Environment (JRE) 1.7.0.65—also known as JRE 7 Update 65—exist on the user's computer.

The Launch page is configured to prompt users to install JRE if it does not exist on their computer. To make this work, you need to download JRE into the OPA_HOME\html directory and rename it; see Section 6.4, "Make the Java Runtime Environment Available for Download."

To download JRE:

  1. On the application server, go to the following Oracle Web site:

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

  2. Under Java SE 7u65, click the Download button for JRE.

  3. Select the Windows x86 Offline version.

    Note:

    This is the version for 32-bit browsers (not operating systems). The default browser for Windows machines is 32-bit, but Windows machines also come with a 64-bit version. To support the 64-bit version, you must either customize your Launch page to point to sunjpi64.exe or instruct users with 64-bit browsers to download the 64-bit version of JRE from the link in Step 1.
  4. Download it to the staging area in a recognizably named directory.

1.5.6 Downloading Adobe Reader

Adobe Reader is required on the Reports Server and on client computers. Download it from http://www.adobe.com. At this time no particular version is required.

1.5.7 Downloading JSpell (Optional)

The Oracle Clinical Graphic Layout Editor supports the JSpell Spell Checker SDK for Java J2EE for use in checking the spelling of text objects in graphic layouts.

The JSpell Spell Checker SDK is a third-party product from Page Scholar Inc. You must purchase the product separately.

  1. Download JSpell SDK for Java J2EE from http://www.jspell.com/java-spell-checker.html to the staging area in a recognizably named directory.

  2. Extract jspellsdk.zip.

Additional instructions are in Section 6.7, "Install and Configure JSpell Spell Checker SDK (Optional)."

1.6 Using the Silent Installer

You can run any of the Oracle Universal Installers—including the Oracle Clinical Database Server, Database, Front End, or Reports Server Installers—in silent mode. This may be useful to promote uniform installations in multiple sites or computers.

Oracle Clinical ships with .rsp (response) files that include parameter prompts and sample parameter values for each component. They are located on the Oracle Clinical and Oracle Thesaurus Management System 5.1 media pack disk under Disk1\stage\ Response in the .zip file for the application server or for the appropriate database operating system.

Table 1-6 lists each Oracle Clinical component, the response file name for each, and the section of this guide with information on the Installer parameters for each.

Table 1-6 Response Files and Parameter Information

Component Installed Reponse File Parameter Information

Oracle Clinical Database Server for Linux

oracle.pharma.oc.server.unix.Complete.rsp

Section 2.5.1

Oracle Clinical Database Server for Solaris

oracle.pharma.oc.server.unix.Complete.rsp

Section 2.5.1

Oracle Clinical Database Server for HP

oracle.pharma.oc.server.unix.Complete.rsp

Section 2.5.1

Oracle Clinical Database Server for Windows

oracle.pharma.oc.server.windows.Complete.rsp

Section 3.4.1

Oracle Clinical Database—fresh installation

oracle.pharma.oc.db.install.Complete.rsp

Section 4.2.2

Oracle Clinical Database—upgrade and configure

oracle.pharma.db.upgrade.install_type_1.rsp

Section 4.2.2

Oracle Clinical Database—reruns all the re-createable object scripts (views, packages, functions etc) against the database

oracle.pharma.db.upgrade.install_type_2.rsp

Section 4.2.2

Oracle Clinical Front End

oracle.pharma.oc.frontend.Custom.rsp

Section 6.1

Oracle Clinical Reports Server

oracle.pharma.oc.reportserver.Complete.rsp

Section 7.1


  1. Open the file in a text editor and enter values directly

  2. Run the file.

    In UNIX:

    ./runInstaller
    

    Or, if the database server has multiple Oracle Homes, then enter:

    ./runInstaller -invPtrLoc ORACLE_HOME/oraInst.loc
    

    For example:

    ./runInstaller -invPtrLoc /u01/app/oracle/product/121010_qa/oraInst.loc
    

    In Windows (as an administrator):

    setup.exe -responseFile response_file_name
    
  3. When you run the file at each location, edit the local parameters as required.

Alternatively, you can run the Installer once, entering values on screen, and record the process to create a response file.

In UNIX:

./runInstaller

Or, if the database server has multiple Oracle Homes, then enter:

./runInstaller -invPtrLoc ORACLE_HOME/oraInst.loc

In Windows (as an administrator):

setup.exe -record -destinationFile complete_path_to_response_file_name

For more information about using response files see the 12.1.0.1 Oracle Database Installation Guide for your operating system:

1.7 Reviewing the Installation Log Files

During the installation of an Oracle Health Sciences component, the Oracle Universal Installer generates the following log file:

installActions.log

This log file records the actions of the Installer — such as loading information from the CD to the Forms Server or Database Server — and is useful for diagnosing problems with the Installer. You should include the log file if you report any problems that occur when installing an Oracle Health Sciences component.

On a Windows installation, the log files are located at:

\Oracle\Inventory\logs

For example:

C:\Program Files\Oracle\Inventory\logs

On a UNIX installation, the log files are located at:

$ORACLE_BASE/oraInventory/logs

For example:

/u01/app/oraInventory/logs

The current log file is installActions.log. All previous log generations have a timestamp appended to the name. For example:

installActions2013-04-30_11-22-52AM.log

1.8 Choosing a Character Set

Oracle Health Sciences supports certain character sets for each product or each combination of integrated products. For Oracle Clinical and RDC, Oracle strongly recommends that you use the AL32UTF8 character set. These applications also support UTF8, US7ASCII, WE8ISO8859P1, or any single byte character set.

Oracle Clinical and RDC use the NLS_LANG environment variable in the opasettings/opasetting.bat file to control the language, territory, and character set used for database connections. The NLS_LANG variable concatenates the three components as LANGUAGE_TERRITORY.CHARSET.

  • You must set the LANGUAGE_TERRITORY components of the NLS_LANG variable to american_america.

  • You must set the CHARSET component of the NLS_LANG variable to match the character set of the database.

  • You must use the same character set on the database tier and the application tier. If you select US7ASCII for the database tier and AL32UTF8 or UTF8 for the application tier, for example, Oracle Clinical stores some special characters incorrectly in the database.

For more information, see Section 2.6.2, "Review the opa_settings File" for UNIX and Section 3.5.2, "Review the opa_settings.bat File" for Windows.

1.9 Applying Oracle Critical Patch Updates

Every quarter, Oracle provides Critical Patch Updates (CPUs) to address security vulnerabilities. These patches are cumulative: each one contains all the fixes contained in the previous patch.

At the time of publication the current CPU for Oracle Clinical is the October 2014 CPU. For more information, see My Oracle Support article ID 1930332.1.

Check My Oracle Support article ID 180430.1, Oracle Health Sciences (Life Sciences/Pharmaceutical/Healthcare) Supported Technology Stacks, for the latest CPU patch tested with Oracle Health Sciences applications, with a link to the separate article about each one. Install these patches on every computer with an Oracle Home.

1.10 Applying the Latest Oracle Clinical Patch Set

Check My Oracle Support article Oracle Clinical Summary of Patches Available (Article ID 121863.1) for the latest patch set and apply it. This will provide you with the latest bug fixes. See the patch set release notes for more information.

1.11 Integrating Oracle Clinical with Other Products and Options

You can integrate Oracle Clinical with some other products and options and develop applications that read data from Oracle Clinical. Each product listed below must be purchased separately from Oracle Clinical.

1.11.1 Oracle Clinical Remote Data Capture Onsite

Oracle Clinical Remote Data Capture Onsite (RDC Onsite) is an electronic data capture (EDC) Web application that works with studies that are defined and designed using Oracle Clinical. You can use RDC Onsite to collect, perform immediate validation on, review, verify, approve, and report clinical data collected during a patient visit in a clinical study. Patient data is stored in the Oracle Clinical database. You can use Oracle Clinical features including batch validation, discrepancy management, mass changes, and data extract with data collected using RDC Onsite.

Installing Oracle Clinical also installs Oracle Remote Data Capture (RDC) Onsite. For information about using RDC, see the Oracle Clinical Remote Data Capture Onsite User's Guide. For license information, see "Licenses for Remote Data Capture with Oracle Clinical".

1.11.2 Oracle Thesaurus Management System

Oracle Thesaurus Management System (TMS) allows you to code specified patient data to standard terminologies such as MedDRA and WHO-Drug so that the data can be accurately analyzed. When fully integrated with Oracle Clinical, TMS processes new and updated patient data during each Oracle Clinical batch validation and either automatically codes incoming data—those that match standard terms exactly or match previously manually coded terms exactly—or creates an omission that must be manually coded in TMS. TMS can return to Oracle Clinical related terms from one or more levels of the standard terminology—for example the preferred term and system organ class in MedDRA, or the preferred name and Anatomical-Therapeutic-Chemical Level 1 term in WHO-Drug—for each coded term, associated with the correct RDCI (collected CRF).

You can install TMS and Oracle Clinical on the same application tier or on different application tiers. You must install both products on the same database if you want integrate the two systems. Oracle recommends installing Oracle Clinical before TMS.

For more information, see the Oracle Thesaurus Management System Installation Guide and the Oracle Thesaurus Management System User's Guide.

1.11.3 Siebel Clinical

Siebel Clinical is a clinical trial management system that uses a customer relationship management (CRM) software paradigm. The approach focuses on strengthening relationships with trial participants, especially investigators and patients, enhancing collaboration and information sharing across the many different teams involved in clinical trials. CRM solutions also gather and maintain a wealth of valuable data that can be leveraged for a variety of other purposes, such as marketing, sales, and pharmacovigilance.

  • You can create Oracle Clinical Sites, Investigators and Study Sites based on protocol site information sent from Siebel Clinical.

  • You can use the Oracle Clinical user interface to define Oracle Clinical/Remote Data Capture (RDC) data collection events that should be treated as visits/activities in Siebel Clinical.

  • Oracle Clinical passes information to Siebel Clinical to signal the completion of these visits/activities for patients.

For more information, see the chapter on clinical trial management system integration in Oracle Clinical Creating a Study.

In addition, you must configure new Web services. For details, see the Oracle Clinical Application Programming Interface Guide chapter on web services.

1.11.4 Oracle Life Sciences Data Hub

Oracle Life Sciences Data Hub (Oracle LSH) is a powerful data warehouse and transformation tool with built-in version control, data auditing, lifecycle management, and validation tools. Oracle LSH includes adapters specifically designed to load most metadata and patient data from Oracle Clinical into Oracle LSH. In Oracle LSH you can then, for example, create your own reports on study patient data, merge data from multiple trials and create reports on cross-study data, and view data using state-of-the-art visualization tools.

You can load Oracle Clinical metadata and Oracle LSH converts it to appropriate LSH objects, for example:

  • Oracle LSH loads all Oracle Clinical Questions and converts them to Oracle LSH Variables.

  • If a Question is associated with a Discrete Value Group (DVG) in Oracle Clinical, Oracle LSH converts the Question to a Parameter and converts its DVG values to a list of allowable values for the Parameter.

  • Oracle LSH loads all Oracle Clinical Question Groups and converts them to Oracle LSH Table definitions with Columns based on the Variables corresponding to each Question in the Question Group.

Other Oracle Clinical adapters include:

  • Oracle Clinical SAS and Oracle Data Extract Views—load patient data from views you create in Oracle Clinical

  • Oracle Clinical Stable Interface—loads the metadata of all Oracle Clinical tables that are part of Oracle Clinical's stable interface.

  • Oracle Clinical Design and Definition—loads DCMs, DCIs, Procedures, Copy Groups, and Data Extract queries and templates.

  • Oracle Clinical Labs—load lab reference ranges and associated information from Oracle Clinical Labs-related tables.

  • Oracle Clinical Randomization—loads real or dummy treatment pattern information for Oracle Clinical studies.

  • Oracle Clinical Study Data—loads study-specific non-patient data into LSH, including discrepancies, data clarification forms, patient status information, and page tracking information.

In addition, other non-Oracle Clinical-specific adapters allow you to load data from any Oracle table or view, text file, SAS data set, or SAS CPORT or XPORT file.

1.11.5 SAS

Oracle Clinical supports integration with the statistical software application SAS 9.3. For more information, see Chapter 9, "  Setting Up SAS."

1.11.6 Custom Applications for Oracle Clinical

You can build custom applications for Oracle Clinical:

  • See the Oracle Clinical Stable Interface Technical Reference Manual for proprietary information about data access, internal tables, and APIs. The Oracle Clinical Stable Interface provides access to data and a smooth transition between Oracle Clinical versions. Contact Oracle Support to obtain a free electronic copy of the manual. You must be a licensed customer.

  • See the Oracle Clinical Application Programming Interface Guide for information about using Oracle Clinical's Data Capture API.