Oracle® Healthcare Master Person Index

Installation Guide

Release 2.0.3

E25243-03

November 2012

Oracle Healthcare Master Person Index Installation Guide, Release 2.0.3

E25243-03

Copyright © 2010, 2012, Oracle and/or its affiliates. All rights reserved.

Primary Author:

Contributing Author:

Contributor:

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Contents

List of Tables

Preface

- Audience

- About This Book

- Documentation Accessibility

- Related Documents

- Finding Information and Patches on My Oracle Support

- Finding Oracle Documentation

- Conventions

1 Introducing the Oracle Healthcare Master Person Index

- What's Included With the OHMPI Installer

- Features of OHMPI

- Design-time Wizard

- Data Quality and Load Tools

- Master Index Data Manager (MIDM)

- Integrating the Healthcare Enterprise

2 Oracle Healthcare Master Person Index Installation Requirements

- Hardware Requirements

- Hardware Installation Requirements

- Supported IDE, Application Servers, and Operating Systems

- Software Requirements

- Java Development Kit

- Installing JDK Software and Setting JAVA_HOME

- Supported Web Browsers

- Supported Databases

3 Oracle Healthcare Master Person Index Installation

- Preparing for an OHMPI Installation

- Installing Using the OHMPI Installer GUI

- Installing OHMPI Components Using the OHMPI Installer

List of Tables

- 2-1 Design-Time and Runtime Supported Platforms

Preface

This document introduces users to the Oracle Healthcare Master Person Index (OHMPI) and the OHMPI Installer. It provides important information on design-time and runtime application servers and operating systems, and supplies procedures for installing OHMPI and the Java Development Kit (JDK). You must install the JDK and set JAVA_HOME prior to installing OHMPI.

Audience

This document is intended for integration developers and system administrators.

About This Book

This document provides an overview of the OHMPI installation process, and includes the following chapters:

- Chapter 1, "Introducing the Oracle Healthcare Master Person Index," provides an overview of the OHMPI.

- Chapter 2, "Oracle Healthcare Master Person Index Installation Requirements," introduces you to the Oracle Healthcare Master Person Index and describes the requirements which must be met before installing OHMPI.

- Chapter 3, "Oracle Healthcare Master Person Index Installation," provides instructions for installing OHMPI.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information and instructions for implementing and using a master person index application, see the following documents in the Oracle Healthcare Master Person Index Release 2.0 documentation set:

- Oracle Healthcare Master Person Index Installation Guide

- Oracle Healthcare Master Person Index User's Guide

- Oracle Healthcare Master Person Index Data Manager User's Guide

- Oracle Healthcare Master Person Index Configuration Guide

- Oracle Healthcare Master Person Index Configuration Reference

- Oracle Healthcare Master Person Index Working With IHE Profiles User's Guide

- Oracle Healthcare Master Person Index WebLogic User's Guide

- Oracle Healthcare Master Person Index Standardization Engine Reference

- Oracle Healthcare Master Person Index Match Engine Reference

- Oracle Healthcare Master Person Index Provider Index User's Guide

- Oracle Healthcare Master Person Index United States Patient Solution User's Guide

- Oracle Healthcare Master Person Index Australia Patient Solution User's Guide

- Oracle Healthcare Master Person Index United Kingdom Patient Solution User's Guide

- Oracle Healthcare Master Person Index Message Processing Reference

- Oracle Healthcare Master Person Index Analyzing and Cleansing Data User's Guide

- Oracle Healthcare Master Person Index Loading the Initial Data Set User's Guide

- Oracle Healthcare Master Person Index Command Line Reports and Database Maintenance User's Guide

- Oracle Healthcare Master Person Index Release Notes

Finding Information and Patches on My Oracle Support

Your source for the latest information about Oracle Healthcare Master Person Index is Oracle Support's self-service Web site My Oracle Support (formerly MetaLink).

Before you install and use Oracle Healthcare Master Person Index, always visit the My Oracle Support Web site for the latest information, including alerts, White Papers, installation verification (smoke) tests, bulletins, and patches.

Creating a My Oracle Support Account

You must register at My Oracle Support to obtain a user name and password account before you can enter the Web site.

To register for My Oracle Support:

1. Open a Web browser to https://support.oracle.com.

2. Click the Register here link to create a My Oracle Support account. The registration page opens.

3. Follow the instructions on the registration page.

Signing In to My Oracle Support

To sign in to My Oracle Support:

1. Open a Web browser to https://support.oracle.com.

2. Click Sign In.

3. Enter your user name and password.

4. Click Go to open the My Oracle Support home page.

Finding Information on My Oracle Support

There are many ways to find information on My Oracle Support.

Searching by Article ID

The fastest way to search for information, including alerts, White Papers, installation verification (smoke) tests, and bulletins is by the article ID number, if you know it.

To search by article ID:

1. Sign in to My Oracle Support at https://support.oracle.com.

2. Locate the Search box in the upper right corner of the My Oracle Support page.

3. Click the sources icon to the left of the search box, and then select Article ID from the list.

4. Enter the article ID number in the text box.

5. Click the magnifying glass icon to the right of the search box (or press the Enter key) to execute your search.
The Knowledge page displays the results of your search. If the article is found, click the link to view the abstract, text, attachments, and related products.

Searching by Product and Topic

You can use the following My Oracle Support tools to browse and search the knowledge base:

- Product Focus — On the Knowledge page under Select Product, type part of the product name and the system immediately filters the product list by the letters you have typed. (You do not need to type "Oracle.") Select the product you want from the filtered list and then use other search or browse tools to find the information you need.

- Advanced Search — You can specify one or more search criteria, such as source, exact phrase, and related product, to find information. This option is available from the Advanced link on almost all pages.

Finding Patches on My Oracle Support

Be sure to check My Oracle Support for the latest patches, if any, for your product. You can search for patches by patch ID or number, or by product or family.

To locate and download a patch:

1. Sign in to My Oracle Support at https://support.oracle.com.

2. Click the Patches & Updates tab. The Patches & Updates page opens and displays the Patch Search region. You have the following options:

- In the Patch ID or Number is field, enter the number of the patch you want. (This number is the same as the primary bug number fixed by the patch.) This option is useful if you already know the patch number.

- To find a patch by product name, release, and platform, click the Product or Family link to enter one or more search criteria.

3. Click Search to execute your query. The Patch Search Results page opens.

4. Click the patch ID number. The system displays details about the patch. In addition, you can view the Read Me file before downloading the patch.

5. Click Download. Follow the instructions on the screen to download, save, and install the patch files.

Finding Oracle Documentation

The Oracle Web site contains links to all Oracle user and reference documentation. You can view or download a single document or an entire product library.

Finding Oracle Health Sciences Documentation

To get user documentation for Oracle Health Sciences applications, go to the Oracle Health Sciences documentation page at:

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

Note:
Always check the Oracle Health Sciences Documentation page to ensure you have the latest updates to the documentation.

Finding Other Oracle Documentation

To get user documentation for other Oracle products:

1. Go to the following Web page:
http://www.oracle.com/technology/documentation/index.html

Alternatively, you can go to http://www.oracle.com, point to the Support tab, and then click Documentation.

2. Scroll to the product you need and click the link.

3. Click the link for the documentation you need.

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Introducing the Oracle Healthcare Master Person Index

Oracle Healthcare Master Person Index (OHMPI) 2.0 is the release of the single person view application that was acquired from Sun Microsystems. This product has been developed over many years and is an established person identity resolution solution in the market with extensive customer base in the healthcare segment. It provides a flexible framework for you to design and create custom single-view applications, or master person indexes, which cleanse, match, and cross-reference healthcare objects across an enterprise. A master person index that contains the most current and accurate data about each healthcare object ensures availability of unified, trusted data to all systems in the enterprise.

Before installing OHMPI it is highly recommended that you review the information in Chapter 1, "Security Configuration Issues," in the Oracle Healthcare Master Person Index Configuration Guide.

What's Included With the OHMPI Installer

The OHMPI Installer includes the following software:

- NetBeans IDE v6.9.1

Note:
IDE is an acronym for an Integrated Development Environment. It consists of a number of components for object-oriented software development and building graphical user interfaces. It includes compiler, source code editor, build tools, debugger, browser, object inspector, and class a hierarchy diagram.

- GlassFish Enterprise Server v2.1.1 Patch 14

Note:
The Audit Record Repository (ARR) is installed with GlassFish. If you intend to use WebLogic and not GlassFish, you still need to install GlassFish if you want to use ARR. Sample files will be installed in the directory where GlassFish is installed.

- The Master Person Index Plug-in

- The IHE Plug-in

- Uninstallation software

Features of OHMPI

Oracle Healthcare Master Person Index includes the following features:

Design-time Wizard

OHMPI provides a wizard that takes you through all the steps of creating a master person index application. Using the wizard, you can define a custom master person index with a data structure, processing logic, and matching and standardization logic that are completely geared to the type of data you are indexing. OHMPI provides a graphical editor so you can further customize the business logic, including matching, standardization, queries, match weight thresholds, and so on.

Data Quality and Load Tools

By default, Master Person Index uses the OHMPI Match Engine and OHMPI Standardization Engine to standardize and match incoming data. Additional tools are generated directly from the master person index application and use the object structure defined for the master person index. These tools include the Data Profiler, Data Cleanser, and the Initial Bulk Match and Load (IBML) tool.

- OHMPI Standardization Engine
The OHMPI Standardization Engine is built on a highly configurable and extensible framework to enable standardization of multiple types of data originating in various languages and counties. It performs parsing, normalization, and phonetic encoding of the data being sent to the master person index or being loaded in bulk to the master person index database. Parsing is the process of separating a field into individual components, such as separating a street address into a street name, house number, street type, and street direction. Normalization changes a field value to its common form, such as changing a nickname like Bob to its standard version, Robert. Phonetic encoding allows queries to account for spelling and input errors. The standardization process cleanses the data prior to matching, providing data to the match engine in a common form to help provide a more accurate match weight.

- OHMPI Match Engine
The OHMPI Match Engine provides the basis for deduplication with its record matching capabilities. The OHMPI Match Engine compares the match fields in two records and calculates a match weight for each match field. It then totals the weights for all match fields to provide a composite match weight between records. This weight indicates how likely it is that two records represent the same entity. The OHMPI Match Engine is a high-performance engine, using proven algorithms and methodologies based on research at the U.S. Census Bureau. The engine is built on an extensible and configurable framework, allowing you to customize existing comparison functions and to create and plug in custom functions.

- Data Profiler
When gathering data from various sources, the quality of the data sets is unknown. You need a tool to analyze, or profile, legacy data in order to determine how it needs to be cleansed prior to being loaded into a master person index database. It uses a subset of the Data Cleanser rules to analyze the frequency of data values and patterns in bulk data. The Data Profiler performs a variety of frequency analyses. You can profile data prior to cleansing in order to determine how to define cleansing rules, and you can profile data after cleansing in order to fine-tune query blocking definitions, standardization rules, and matching rules.

- Data Cleanser
Once you know the quality of the data to be loaded to a master person index database, you can clean up data anomalies and errors as well as standardize and validate the data. The Data Cleanser validates, standardizes, and transforms bulk data prior to loading the initial data set into a master person index database. The rules for the cleansing process are highly customizable and can easily be configured for specific data requirements. Any records that fail validation or are rejected can be fixed and put through the cleanser again. The output of the Data Cleanser is a file that can be used by the Data Profiler for analysis and by the Initial Bulk Match and Load Tool. Standardizing data using the Data Cleanser aids the matching process.

- Initial Bulk Match and Load Tool (IBML Tool)
Before your Master Data Manager (MDM) solution can begin to cleanse data in real time, you need to seed the master person index database with the data that currently exists in the systems that will share information with the master person index. The IBML tool can match bulk data outside of the master person index environment and then load the matched data into the master person index database, greatly reducing the amount of time it would normally take to match and load bulk data. This tool is highly scalable and can handle very large volumes of data when used in a distributed computing environment. The IBML Tool loads a complete image of processed data, including potential duplicate flags, assumed matches, and transaction information.

Master Index Data Manager (MIDM)

The Master Index Data Manager is your primary tool to view and maintain the data stored in a master person index database and cross-referenced by a master person index application. The web-based interface allows you to access, monitor, and maintain the data stored by the master person index applications you create using OHMPI. The MIDM provides the ability to search for, add, update, deactivate, merge, unmerge, and compare object profiles. It also enables you to view and correct potential duplicate profiles, view transaction histories, view an audit log, and print reports.

Integrating the Healthcare Enterprise

Integrating the Healthcare Enterprise (IHE) has created a number of standards and profiles that help create, process, and manage electronic health records in secure patient cross-reference applications. They work in conjunction with native Health Level 7 (HL7) v2 and v3 messaging and transport standards, which define how the information is packaged and shared between systems. OHMPI has incorporated a number of the IHE profiles (listed below), as they increase the efficiency of sharing trusted cross-references of healthcare person entities. A number of the IHE profiles function with HL7 v2 and v3 encoding standards to integrate healthcare networks.

With OHMPI Release 2.0.3 you have the capability to create an IHE project that contains a pre-configured master person index project. See "IHE-MPI Projects" in Oracle Healthcare Master Person Index Working With IHE Profiles.

- Patient Identifier Cross Referencing (PIX) allows cross-referencing of patient identifiers across a network of healthcare sites.

- Patient Demographics Query (PDQ) queries and retrieves patient demographics.

- Audit Record Repository (ARR) includes an audit server and an audit repository. It also supports ATNA (see below).

- Audit Trail and Node Authentication (ATNA) uses certificates and transmits and receives audit events to a secure repository to maintain patient confidentiality, and is built on top of Security Audit and Access Accountability Message XML Data Definitions for Healthcare Applications, the Syslog Protocol, Transmission of Syslog Messages over Transport Layer Security (TLS), and Transmission of Syslog Messages over User Datagram Protocol (UDP).

- Consistent Time (CT) synchronizes time stamps and system clocks on computers functioning within a healthcare network.

- Patient Identity Management (PIM) under Patient Administration Management (PAM) creates a patient record, updates the record, links the record to another patient record, and if the records represent the same patient, merges the records (these records can be unlinked if the records do not represent the same patient).

- Patient Encounter Management (PEM) is part of Patient Administration Management (PAM), which specifies two transactions (Patient Encounter Management, and the previously implemented Patient Identity Feed). For this release PEM supports the following:

- Basic mandatory subset, which creates, updates, or closes inpatient and outpatient encounters. It also updates patient information and merges patient records.

- Inpatient/outpatient encounter management option, which includes pre-admitting an inpatient and changing a patient's classification.

- Patient Demographics Visit Query (PDVQ) accesses user-defined search criteria and visit criteria to provide multiple distributed applications the capability to query a patient information server for a list of patients.

- Patient Identifier Cross-Reference and Patient Demographics Query for HL7v3 (PIX/PDQ v3) leverages HL7 version 3 to extend the capability of these profiles.

2 Oracle Healthcare Master Person Index Installation Requirements

This chapter introduces describes OHMPI Installer. It also lists requirements prior to installing OHMPI, including design-time and runtime application servers, the operating systems on which they run, and a procedure for installing the Java Development Kit (JDK) and setting JAVA_HOME.

This chapter includes the following sections:

- "Hardware Requirements"

- "Software Requirements"

Hardware Requirements

Oracle Healthcare Master Person Index requires that the computer on which you plan to install it already has an appropriate Java Development Kit with JAVA_HOME set prior to beginning the process. See "Installing JDK Software and Setting JAVA_HOME".

OHMPI can be installed on PC and UNIX computers; see "Supported IDE, Application Servers, and Operating Systems" for details about the supported platforms.

A typical PC running Microsoft Windows might have the following:

- 4 GB of RAM

- 2.8 GHz processor

- 40 GB of disk space

Hardware Installation Requirements

Installation requirement vary depending upon the operating system on which you are installing. For example:

- On Microsoft Windows, you need 1.5 GB of free storage space

- On Solaris, you need 1.5 GB of free storage space

Note:
The OHMPI Installer informs you how much free storage space is required.

Supported IDE, Application Servers, and Operating Systems

OHMPI supports the following application servers:

- Integrated Design-time Environment (IDE)
NetBeans IDE 6.9.1 is a design-time application used to create, generate, and build OHMPI applications.

Note:
Table 1-1 lists the design-time operating systems that are compatible with Master Person Index design-time components and NetBeans IDE v6.9.1.

- Runtime Application Servers
The following runtime application servers support the IHE interface and run an OHMPI application after it has been created and built.

- GlassFish Server 2.1.1 Patch 14

- Oracle WebLogic Server 11gR1 10.3.5 and 10.3.6 (including cluster environment deployments on these versions)

Note:
OHMPI is supported on any edition of WebLogic Server, such as Standard, Enterprise, or WL Suite. WebLogic Server 10.3.5 and 10.3.6 brings in newer operating system versions: AIX 7.1 /64bit, Windows 2008 SP1/32 and 64 bit, and Solaris 10 x64.

Table 2-1 lists operating systems that are compatible with Master Person Index runtime components and the GlassFish Server 2.1.1 Patch 14 or the Oracle WebLogic Server 11gR1 and 10.3.5 and 10.3.6.

Table 2-1 Design-Time and Runtime Supported Platforms

PlatformFoot 1

Design-time NetBeans IDE

Runtime GlassFish

Runtime WebLogic

Runtime JVM

IBM AIX 7.1

---

32 and 64 bit

64 bit

32 and 64 bit

IBM AIX 6.1

---

32 and 64 bit

64 bit

32 and 64 bit

IBM AIX 5.3

---

32 bit

64 bit

32 and 64 bit

Microsoft Windows 2008 SP1

---

32 bit

32 and 64 bit

32 and 64 bit

Microsoft Windows 2008 R2

---

64 bit

64 bit

32 and 64 bit

Microsoft Windows 7 Professional

32 and 64 bit

---

32 and 64 bit

32 bit

Microsoft Windows Vista SP1+

32 bit

32 bit

32 bits

32 bit

Microsoft Windows XP SP3

32 bit

32 bit

32 bit

32 bit

Microsoft Windows 2003 R2 SP2

---

32 bit

32 and 64 bit

32 and 64 bit

Oracle Enterprise Linux 5

32 and 64 bit

---

32 and 64 bit

32 and 64 bit

Red Hat Enterprise Linux (UL3+)

32 and 64 bit

32 and 64 bit

32 and 64 bit

32 and 64 bit

Red Hat Linux 5.3

32 and 64 bit

32 and 64 bit

32 and 64 bit

32 and 64 bit

Solaris 10 SPARC Update 4

64 bit

64 bit

64 bit

64 bit

Solaris 10 x64 Update 6+

64 bit

64 bit

---

64 bit

Solaris 10 x86

32 and 64 bit

32 and 64 bit

---

32 bit

Footnote 1 The supported bits for the platforms are noted in the table.

Software Requirements

OHMPI requires the following software:

- "Java Development Kit"

OHMPI also requires a web browser to view the Master Index Data Manager (MIDM) and a database.

- "Supported Web Browsers"

- "Supported Databases"

Java Development Kit

OHMPI requires that a Java Development Kit is installed, and on UNIX systems the JAVA_HOME environment variable set, on the computer on which you install a Master Person Index prior to beginning the installation.

For OHMPI Release 1.1, the supported JDK is the minimum required to run the OHMPI Installer and install the program.

- JDK 1.6.0_18

Installing JDK Software and Setting JAVA_HOME

If you do not already have the JDK software installed or if JAVA_HOME is not set, the Master Person Index installation will not be successful. The following tasks provide the information you need to install the JDK software on Windows and UNIX systems. Set JAVA_HOME on UNIX systems.

Caution:
NetBeans IDE and GlassFish require the JDK for installation, in particular JDK 1.6 Update 18 or later. If you select a Java Runtime Environment (JRE) instead of a JDK, you cannot install or configure NetBeans IDE or GlassFish.
Oracle WebLogic Server, which is a separate installation, automatically installs JRockit JDK. However, if you intend to use Oracle JDK, it must be installed before you install the WebLogic Server.

To Install JDK Software on a Windows System

1. Go to http://java.sun.com/javase/downloads/index.jsp.

2. Select the appropriate JDK version and click Download. The JDK software is installed on your computer (for example, at C:\Program Files\Java\jdk1.6.0_18).

Note:
You can change this location.

To Install JDK Software and Set JAVA_HOME on a UNIX System

1. Install the JDK software.

- Go to http://java.sun.com/javase/downloads/index.jsp.

- Select the appropriate JDK version and click Download. The JDK software is installed on your computer, for example, at /usr/jdk/jdk1.6.0_18.

Note:
You can change this location.

2. Set JAVA_HOME

- Korn and bash shells:

- export JAVA_HOME=jdk-install-dir

- export PATH=$JAVA_HOME/bin:$PATH

- Bourne shell:

- JAVA_HOME=jdk-install-dir

- export JAVA_HOME

- PATH=$JAVA_HOME/bin:$PATH

- export PATH

- C shell:

- setenv JAVA_HOME jdk-install-dir

- setenv PATH $JAVA_HOME/bin:$PATH

Supported Web Browsers

OHMPI supports the following web browsers:

- Firefox: All versions; v. 3.5x and newer are recommended

- Internet Explorer (IE): Full support in version 7 and compatibility mode in version 8
Some of the pages in the MIDM application report HTML errors for IE 8. This is because of the difference in the DOM implementation in IE8. You can ignore these errors.

- Google Chrome

It is recommended to use Internet Explorer or Mozilla Firefox to access the MIDM application in the WebLogic Clustering environment.

Supported Databases

OHMPI supports the following databases:

- Oracle 11gR2 11.2.0.1.0; Oracle 10gR2

Note:
You must have atleast the Standard edition for OHMPI.

- MySQL Community Server 5.5.x

- Microsoft SQL Server 2008 R2 SP1

Note:
You must have atleast the Standard edition for OHMPI. The IHE Profiles Application does not support Microsoft SQL Servers.

3 Oracle Healthcare Master Person Index Installation

This chapter provides conceptual and mandatory information, as well as a procedure for installing the Oracle Healthcare Master Person Index.

This chapter includes the following sections:

- "Preparing for an OHMPI Installation"

- "Installing Using the OHMPI Installer GUI"

Preparing for an OHMPI Installation

Before beginning the installation, read the Oracle Healthcare Master Person Index Release Notes, as it contains important information such as what is in the release package, a listing of new features, and known issues. This information may be pertinent for you to complete a successful installation of the Oracle Healthcare Master Person Index.

Important installation information:

- Master Person Index does not support spaces in the installation directory path.

- You must have the JDK software installed and JAVA_HOME set prior to installing Master Person Index or the OHMPI Installer will halt the installation. If you have not installed the JDK yet, see "Installing JDK Software and Setting JAVA_HOME".

Installing Using the OHMPI Installer GUI

Although you can change the default installation values, accepting most of them is a good practice, especially the port numbers.

Caution:
Master Person Index does not support spaces in the installation directory path.

Before You Begin

When installing Master Person Index on UNIX systems, such as Solaris computers, set the DISPLAY variable to install in GUI mode. How you do this depends on how you connect to your system.

- If you receive the error message "No X11 DISPLAY variable was set, but this program performed an operation which requires it" and you use the SSH command to connect to your system from another UNIX machine, you need to set the DISPLAY variable.

- C shell with localhost the host name: setenv DISPLAY localhost:0.0

- Korn shell with localhost the host name: DISPLAY=localhost:0.0; export DISPLAY

- Bash shell with localhost the host name: DISPLAY=localhost:0.0; export DISPLAY

- Bourne shell with localhost the host name: DISPLAY=localhost:0.0; export DISPLAY

- If you use X Windows software, such as Exceed, the DISPLAY variable is set for you automatically and can be referenced as a macro, @d&@, when issuing the xterm command.

Installing OHMPI Components Using the OHMPI Installer

Follow the instructions in this section to run the OHMPI Installer:

1. Download the installation executable file for your platform from the link supplied to you through eDelivery.

2. Extract the installer file for your platform to a temporary directory.

Platform

Installer File

Windows

OracleHealthcareMPlv2_0-full-installer-windows.exe

Solaris SPARC

OracleHealthcareMPlv2_0-full-installer-solaris-sparc.sh

Solaris x86

OracleHealthcareMPlv2_0-full-installer-solaris-x86.sh

Linux

OracleHealthcareMPlv2_0-full-installer-linus.sh

AIX

OracleHealthcareMPlv2_0-full-installer-aix.sh

3. Exit from all programs prior to beginning the installation.

Note:
You can cancel the installation at any time during the process.

4. To start the installation, initiate the appropriate executable file:

- For Linux or Solaris, change the execution mode with the command, chmod a+x installer-file.sh; and then start the installation with the command, ./installer-file.sh.

- For Windows, double-click the file, installer-file.exe.

5. When the OHMPI Installer wizard appears you have two choices on how to begin the installation, and they are based upon which application server you want to use with OHMPI.

- To install GlassFish, click Next.

Note:
The Audit Record Repository (ARR) is installed in a directory parallel to the directory where GlassFish is installed.

- To not install GlassFish and install Oracle WebLogic Server in a separate installation after you complete this installation, click Customize. See Oracle Healthcare Master Person Index WebLogic User's Guide for installation instructions.

- On the Customize Installation window un-check Oracle Healthcare Master Person Index Runtime and then click OK.

Note:
You cannot un-check Oracle Healthcare Master Person Index Design-time, as it is required to install OHMPI, IHE, and Netbeans IDE.

Tip:
Use the Next and Previous buttons to navigate forward and backward in the installation.

6. On the NetBeans IDE Installation window, do the following:

- Verify or modify the location for the NetBeans IDE.

- Verify or modify the location of the associated JDK.

- Click Next.

Note:
NetBeans IDE and GlassFish require the JDK for installation, in particular JDK 1.6 Update 18 or later.

7. On the GlassFish Installation window, do the following:

- Verify or modify the location for GlassFish.

- Verify or modify the location of the associated JDK.

Caution:
In this step, if you previously selected a JRE instead of a JDK, NetBeans IDE and GlassFish will not install.

- If there are no port conflicts with any other system applications, accept the default server properties.

- Click Next. The default GlassFish properties are described below.

Setting

Description

Default

Admin user name

The name you use when you log in as administrator.

admin

Admin password

The password you use when you log in as administrator.

adminadmin

HTTP port number

The port on which GlassFish listens for HTTP requests for web applications that you deploy.

8080

Secure HTTPS port number

The port on which GlassFish listens for HTTPS requests for web applications that you deploy.

8181

Admin port number

The port on which GlassFish listens for administrative HTTP requests.

4848

8. When the Summary page appears, verify each component of the installation and click Install. If you need to make changes, click Previous to return to a previous screen.

9. Click Finish.
OHMPI is configured for your system. For additional details about the installation, see the installation logs.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.