Release 2.0.2 for Oracle Data Integrator E29531-07 May 2013 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide, Release 2.0.2 for Oracle Data Integrator E29531-07 Copyright 2011, 2013 Oracle and/or its affiliates. All rights reserved. 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 RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. 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 is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software 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. iii Contents Preface................................................................................................................................................................. v Audience....................................................................................................................................................... v Documentation Accessibility..................................................................................................................... v Finding Documentation on Oracle Technology Network..................................................................... v Related Documents ..................................................................................................................................... vi Conventions ................................................................................................................................................. vi 1 Overview 1.1 Technology Stack and System Requirements ......................................................................... 1-1 1.2 General Security Principles ....................................................................................................... 1-1 2 Installing Oracle Healthcare Analytics Data Integration 2.1 Installing the Prerequisite Software ......................................................................................... 2-1 2.2 Setting Up the Database............................................................................................................. 2-1 2.2.1 Preinstallation Checklist ..................................................................................................... 2-2 2.2.2 New Installation of Oracle Healthcare Analytics Data Integration ODI 2.0.2............ 2-3 2.3 Setting Up ODI Repositories ..................................................................................................... 2-6 2.3.1 Creating a New Oracle Data Integrator Repository Login............................................ 2-7 2.3.2 Importing Master Repository............................................................................................. 2-9 2.3.3 Creating a New Oracle Data Integrator Work Repository ......................................... 2-11 2.3.4 Importing Scripts .............................................................................................................. 2-14 2.4 Configuring ODI Repositories ............................................................................................... 2-18 2.5 Installation Verification........................................................................................................... 2-21 3 Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3.1 Setting Up ODI Repositories ..................................................................................................... 3-1 3.2 Configuring ODI Repositories ............................................................................................... 3-10 3.2.1 Post Installation Steps ...................................................................................................... 3-14 Index iv v Preface This guide provides information about how to install Oracle Healthcare Analytics Data Integration (OHADI). This preface contains the following topics: Audience on page v Documentation Accessibility on page v Finding Documentation on Oracle Technology Network on page v Related Documents on page vi Conventions on page vi Audience This installation guide is intended for those who are responsible for installing Oracle Healthcare Analytics Data Integration. You should be familiar with: Oracle Database Oracle Data Integrator (ODI) application Oracle Healthcare Data Warehouse Foundation (HDWF) application UNIX or Windows operating system 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. Finding Documentation on Oracle Technology Network The Oracle Technology Network Web site contains links to all Oracle user and reference documentation. To find user documentation for Oracle products: vi 1. Go to the Oracle Technology Network at http://www.oracle.com/technetwork/index.html and log in. 2. Mouse over the Support tab, then click the Documentation hyperlink. Alternatively, go to Oracle Documentation page at http://www.oracle.com/technology/documentation/index.html 3. Navigate to the product you need and click the link. For example, scroll down to the Applications section and click Oracle Health Sciences Applications. 4. Click the link for the documentation you need. Related Documents For more information, see the following documents in the Oracle Data Integrator Release 7.0 documentation set or in the Oracle Other Product Two Release 6.1 documentation set: Oracle Data Integrator Oracle Data Integrator Release Notes Oracle Data Integrator Getting Started Guide Oracle Data Integrator Installation Guide Oracle Data Integrator Oracle Fusion Middleware Patching Guide Oracle Data Integrator Upgrade Guide Oracle Data Integrator Developers Guide Oracle Data Integrator Application Adapters Guide Oracle Data Integrator Knowledge Module Developer's Guide Oracle Data Integrator Connectivity and Knowledge Modules Guide: Oracle Healthcare Data Warehouse Foundation Oracle Healthcare Data Warehouse Foundation Release Notes Oracle Healthcare Data Warehouse Foundation Secure Installation and Configuration Guide Oracle Healthcare Data Warehouse Foundation Programmer's Guide Oracle Healthcare Data Warehouse Foundation Interface Table Programmer's Guide Conventions The following text conventions are used in this document: 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 Overview 1-1 1 Overview This chapter contains the following topics: Technology Stack and System Requirements on page 1 General Security Principles on page 1 This section presents an overview of the Oracle Healthcare Analytics Data Integration (OHADI) requirements. It also describes the tasks that you must complete before you can install the OHADI application. 1.1 Technology Stack and System Requirements The following hardware and software technology stacks are required for OHADI installation: Oracle Database 11.2.0.2 (64-bit) Oracle Data Integrator 11.1.1.6 Oracle Healthcare Data Warehouse Foundation 5.0.2 UNIX or Window operating system with at least 8 GB RAM The following table lists system requirement references. 1.2 General Security Principles The following principles are fundamental to using any application securely. Note: All references to media pack server in this document refer to the computer onto which you download the media pack for Oracle Healthcare Analytics Data Integration. Table 11 System Requirement References Product Reference Oracle Database 11.2.0.2 (64-bit) Database Installation Guide for <platform> Oracle Data Integrator 11.1.1.6 Oracle Data Integrator Installation Guide Oracle Healthcare Data Warehouse Foundation 5.0.2 Oracle Healthcare Data Warehouse Foundation Patch Readme and Release Notes General Security Principles 1-2 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Keep Software Up To Date One of the principles of good security practices is to keep all software versions and patches up to date. Keeping Up To Date on the Latest Security Information Critical Patch Updates Oracle continually improves its software and documentation. Critical Patch Updates are the primary means of releasing security fixes for Oracle products to customers with valid support contracts. They are released on the Tuesday closest to the 17th day of January, April, July and October. We highly recommend customers to apply these patches as soon as they are released. Configure Strong Passwords on the Database Although the importance of passwords is well known, the following basic rule of security management is worth repeating: Ensure all passwords are strong passwords. You can strengthen passwords by creating and using password policies for your organization. For guidelines on securing passwords and for additional ways to protect passwords, refer to the Oracle Database Security Guide specific to the database release you are using. You should modify the following passwords to use your policy-compliant strings: Passwords for the database default accounts, such as SYS and SYSTEM. Passwords for the database application-specific schema accounts, such as HDM, HDI, and HMC. The password for the database listener. You must not configure a password for the database listener as that will enable remote administration. For more information, refer to the section "Removing the Listener Password" of Oracle Database Net Services Reference 11g Release 2 (11.2). Follow the Principle of Least Privilege The principle of least privilege states that users should be given the least amount of privilege to perform their jobs. Overly ambitious granting of responsibilities, roles, grants especially early on in an organization's life cycle when people are few and work needs to be done quickly often leaves a system wide open for abuse. User privileges should be reviewed periodically to determine relevance to current job responsibilities. Before executing DDL scripts to create HMC schema, a database user should be created with specified limited set of privileges. DBA access should not be given to the user. Database Security Features The following principles are fundamental to using any application securely. Database Vault - Oracle Database Vault restricts access to specific areas in an Oracle database from any user, including users who have administrative access. For example, you can restrict administrative access to employee salaries, customer medical records, or other sensitive information. About Audit Vault - Oracle Audit Vault automates the audit collection, monitoring and reporting process. It turns audit data into a key security resource for detecting unauthorized activity. Consider using this feature to satisfy compliance regulations such as SOX, PCI, and HIPAA, and to mitigate security risks. General Security Principles Overview 1-3 About Tablespace Encryption - Transparent Data Encryption is one of the three components of the Oracle Advanced Security option for Oracle Database 11g Release 2 Enterprise Edition. It provides transparent encryption of stored data to support your compliance efforts. Applications do not have to be modified and will continue to work seamlessly as before. Data is automatically encrypted when it is written to disk, and automatically decrypted when accessed by the application. Key management is built in to the Tablespace Encryption feature, eliminating the complex task of creating, managing and securing encryption keys. Managing Default User Accounts Schema owner should not be the user for normal production; instead the account should be locked after the installation. Closing All Open Ports Not in Use Keep only the minimum number of ports open and close all ports that are not in use. Disabling the Telnet Service Oracle Healthcare Analytics Data Integration Configuration does not use the Telnet service. Telnet listens on port 23 by default. If the Telnet service is available on any computer, Oracle recommends that you disable Telnet in favor of Secure Shell (SSH). Telnet, which sends clear-text passwords and user names through a log-in, is a security risk to your servers. Disabling Telnet tightens and protects your system security. Disabling Other Unused Services In addition to not using Telnet, the Oracle Healthcare Analytics Data Integration Configuration does not use the following services or information for any functionality: Simple Mail Transfer Protocol (SMTP). This protocol is an Internet standard for E-mail transmission across Internet Protocol (IP) networks. Identification Protocol (identd). This protocol is generally used to identify the owner of a TCP connection on UNIX. Simple Network Management Protocol (SNMP). This protocol is a method for managing and reporting information about different systems. Restricting these services or information does not affect the use of Oracle Healthcare Analytics Data Integration Configuration. If you are not using these services for other applications, Oracle recommends that you disable these services to minimize your security exposure. If you need SMTP, identd, or SNMP for other applications, be sure to upgrade to the latest version of the protocol to provide the most up-to-date security for your system. Designing for Multiple Layers of Protection When designing a secure deployment, design multiple layers of protection. If a hacker should gain access to one layer, such as the application server, that should not automatically give them easy access to other layers, such as the database server. Providing multiple layers of protection may include: Enable only those ports required for communication between different tiers, for example, only allowing communication to the database tier on the port used for SQL*NET communications (1521 by default). General Security Principles 1-4 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Place firewalls between servers so that only expected traffic can move between servers. Configuring Secure SQL NET If the Oracle Data Integrator (ODI) repository is installed in a database server other than the server having HDWF schema, the data transfer will take place between two different database servers over a network. As HDWF contains sensitive clinical and healthcare data, you must secure the communication between database servers. Use Oracle Net Manager to configure encryption to secure communication between database servers. Oracle provides different encryption algorithms to secure communication. Select an appropriate encryption algorithm. For more information, refer to Oracle Database Advanced Security Administrator's Guide 11g Release 2 (11.1). 2 Installing Oracle Healthcare Analytics Data Integration 2-1 2 Installing Oracle Healthcare Analytics Data Integration This chapter contains the following topics: Installing the Prerequisite Software on page 2-1 Setting Up the Database on page 2-1 Setting Up ODI Repositories on page 2-6 Configuring ODI Repositories on page 2-18 Installation Verification on page 2-21 2.1 Installing the Prerequisite Software Oracle expects that you have good knowledge of concepts and commands of UNIX, Oracle Data Integrator (ODI), and Oracle Database. Before you can install the OHADI application, you must complete the following pre-installation tasks: 1. Install Oracle Database 11.2.0.2 (64-bit). Follow the instructions in Database Installation Guide for <platform>. 2. Install Oracle Data Integrator 11.1.1.6. Follow the instructions in ODI Installation Guide. 3. Install Oracle Healthcare Data Warehouse Foundation 5.0.2. Follow the instructions in Oracle Healthcare Data Warehouse Foundation Patch Readme and Release Notes. 2.2 Setting Up the Database This patch contains the following files required to install the physical data model portion of OHADI ODI 2.0.2 and the associated documentation: Table 21 Media Pack Contents File Name Contains doc\iguide Secure Installation and Configuration Guide software\repository XML files for OHADI ODI 2.0.2 (zip format) software\batchscripts .sh and .bat scripts for the OHADI ODI 2.0.2 installation software\database SQL scripts for OHADI ODI 2.0.2 installation Setting Up the Database 2-2 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide 2.2.1 Preinstallation Checklist Ensure that you have set the NLS_LENGTH_SEMANTICS parameter of the session creating Metadata Configuration (HMC) schema to either CHAR or BYTE as per your requirements. Ensure that you have set a consistent default date format setting across HDWF, OHADI, and Rules Metadata Configuration. Ensure that you have set a consistent time zone setting across HDWF, OHADI, and Rules Metadata Configuration. Ensure that you have already installed HDWF 5.0.2 to install OHADI ODI 2.0.2. If not already installed, do so by following the respective installation guides. To install on UNIX, perform the following steps: 1. Download the media pack on to Windows operating system and unzip the media pack file in the <OHADI_INSTALL_DIR>\*.* directory before transferring any objects to UNIX operating system. 2. Create a directory in UNIX installation server for copying OHADI ODI 2.0.2 installation package files. For example, OHADI_INSTALL_DIR. 3. On the installation server, create four directories inside the <OHADI_INSTALL_ DIR> for placing SQL scripts, batch scripts, XML files, and log files that will be generated. For example: <OHADI_INSTALL_DIR>/ohadi_sqls/ <OHADI_INSTALL_DIR>/ohadi_xmls/ <OHADI_INSTALL_DIR>/ohadi_scripts/ <OHADI_INSTALL_DIR>/ohadi_logs/ 4. Transfer the XML files (ODIExport.zip and OHADI_MASTER_REPOSITORY.zip) in binary mode and other files in text mode from the following locations in Windows operating system to OHADI installation directory in UNIX server (for example, OHADI_INSTALL_DIR). software\batchscripts\*.sh to <OHADI_INSTALL_DIR>/ohadi_scripts/ software\database\*.* to <OHADI_INSTALL_DIR>/ohadi_sqls/ software\repository\*.* to <OHADI_INSTALL_DIR>/ohadi_xmls/ Extract the contents of the ODIExport.zip files in the <OHADI_INSTALL_ DIR>\ohadi_xmls\ directory using the following command: unzip ODIExport.zip 5. Provide execute permission for all the scripts as per the following commands: Note: In the following sections, the text enclosed within <> indicate parameters and you need to provide the parameter values as per your system. Note: No error message should be prompted upon the execution of unzip command. Ensure that you can view the list of .xml files in the ohadi_xmls directory after they are extracted. Setting Up the Database Installing Oracle Healthcare Analytics Data Integration 2-3 chmod 755 <OHADI_INSTALL_DIR>/ohadi_sqls/* chmod 755 <OHADI_INSTALL_DIR>/ohadi_scripts/* chmod 755 <OHADI_INSTALL_DIR>/ohadi_xmls/* 6. The .sh scripts mentioned in the following installation steps should be executed from directory where the scripts are placed. For example, <OHADI_INSTALL_ DIR>/ohadi_scripts/ To install on Windows, perform the following steps: 1. Download the media pack to Windows operating system and unzip the media pack file in the <OHADI_INSTALL_DIR>\*.* directory. 2. Navigate to the <OHADI_INSTALL_DIR>\software\repository directory. Unzip and extract the contents of ODIExport.zip file in the same directory using WinZip application. 3. Enter sqlplus in the command prompt and press Enter. If the following message is displayed in the console: SQL*Plus: Release 11.2.0.2.0 Production on Wed Jan 16 18:27:47 2013 Copyright (c) 1982, 2010, Oracle. All rights reserved. Enter user-name: Exit the command prompt and proceed to the section 2.2.2. If the following message is displayed in the console: sqlplus is not recognized as an internal or external command, operable program or batch file Right-click on My Computer and select Properties. Click Advanced and then click Environment Variables. The Environment Variables window is displayed. Edit the PATH variable from the System Variables window. Verify if <oracle home directory>\bin is configured. For example, if your oracle home directory is: D:\app\pdogipar\product\11.2.0\dbhome_1, then verify D:\app\pdogipar\product\11.2.0\dbhome_1\bin exists in PATH variable or not. 2.2.2 New Installation of Oracle Healthcare Analytics Data Integration ODI 2.0.2 For a fresh installation of OHADI ODI 2.0.2, perform the following steps: Note: If it does not exist, add the same to PATH variable and keep clicking OK until the dialog box is closed and go to step 3. If it does exist, remove the same from PATH variable and keep clicking on OK until the dialog box is closed and go to step 3. Note: The following three steps are common for both UNIX and Windows installations. Setting Up the Database 2-4 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide 1. Log in as SYSTEM user in database by executing the following command in the command prompt. sqlplus <system user>/<system user password>@<DB instance name> (or) connect to the SYSTEM user using Oracle SQL developer. 2. Create a HMC user with appropriate default tablespace with requisite quotas and temporary tablespace, and grant the user session privilege. To create a HMC user: CREATE USER <HMC_schema_user> IDENTIFIED BY <password> DEFAULT TABLESPACE <tablespace name> TEMPORARY TABLESPACE <temporary tablespace name> QUOTA <size or UNLIMITED> ON <tablespace name>; grant create session to <HMC_schema_user>; For example: CREATE USER HMC IDENTIFIED BY <secure password> DEFAULT TABLESPACE users TEMPORARY TABLESPACE temp QUOTA UNLIMITED ON users; grant create session to HMC; 3. Disconnect SYSTEM user by executing the following command: SQL>exit; (or) Disconnect Oracle SQL developer manually. To install on UNIX, perform the following steps: 1. Update the environment file <OHADI_INSTALL_DIR>/ohadi_scripts/OHADI_ ODI_SETENV.sh with appropriate values for SYS_USR, SYS_SID, HDI_USR, HDI_ SID, HDM_USR, HDM_SID, HMC_USR, HMC_SID, ORACLE_HOME, SQL_DIR, BIN_DIR, LOG_DIR, and NOTIFICATION_EMAIL_LIST parameters. For remaining parameters (ODI_WORK_REP, ODI_HOME, and ODI_XML_DIR), provide blank values (erase the given syntax). 2. After successful completion of step 1, execute the OHADI_ODI_DATABASE_ SETUP.sh script from the command prompt by using the following commands: cd <OHADI_INSTLLA_DIR>/ohadi_scripts/ sh OHADI_ODI_DATABASE_SETUP.sh Note: Do not put a slash symbol (/) at the end of the directory declaration. Setting Up the Database Installing Oracle Healthcare Analytics Data Integration 2-5 The execution status of the script can be verified in the $LOG_DIR/OHADI_ODI_ DATABASE_SETUP_INSTALL_SUMMARY.log file. Individual SQL file logs also will be generated in $LOG_DIR/. If any errors are found during the database setup, look for the errors in the corresponding individual log file and fix them. Execute the failed step manually as per the command used in the script and proceed with further installation. To install on Windows, perform the following steps: 1. Update the environment file <OHADI_INSTALL_ DIR>\software\batchscripts\OHADI_ODI_SETENV.bat with appropriate values for the parameters SYS_USR, SYS_SID, HDI_USR, HDI_SID, HDM_USR, HDM_ SID, HMC_USR, HMC_SID, SQL_DIR, BIN_DIR, and LOG_DIR. For remaining parameters (ODI_WORK_REP, ODI_HOME, and ODI_XML_DIR) provide blank values (erase the given syntax). 2. After successful completion of step 1, execute the OHADI_ODI_DATABASE_ SETUP.bat script from the command prompt by using the following commands: cd <OHADI_INSTALL_DIR>\software\batchscripts OHADI_ODI_DATABASE_SETUP.bat Note: The script prompts for password to connect to database during execution. Password entry is hidden in console. Enter correct password and press Enter. If the password entered is NULL or wrong, the script will display an error and the script has to be restarted again by providing correct login credentials. The script also prompts for parameters to be passed to the seed data procedures. The possible values are Y or N. Y - Non-EHA_User versioned seed data record will be replaced by EHA_User versioned seed data. N - Recommended, non-EHA_User versioned seed data record will not be replaced by EHA_User versioned seed data. Corresponding record will be rejected and a log will be entered in the log table. Note: Do not put a backslash symbol (\) at the end of the directory declaration. If any directory name contains spaces, specify the whole path in double quotation marks. For example, "<whole path name>". Setting Up ODI Repositories 2-6 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide If any errors are found during the database setup, look for the errors in the corresponding individual log file and fix them. Execute the failed step manually as per the command used in the script and proceed with further installation. 2.3 Setting Up ODI Repositories The media pack contains the following files used to setup ODI repositories: Perform the following steps: 1. Create a database schema for ODI master repository and another for ODI work repository with the following privileges: a. Log in to database using system user. CREATE USER <user> IDENTIFIED BY <password> DEFAULT TABLESPACE <tablespace name> TEMPORARY TABLESPACE <temporary tablespace name> QUOTA <size or UNLIMITED> ON <tablespace name>; For example: CREATE USER ohadi_master IDENTIFIED BY ohadi_master DEFAULT TABLESPACE users TEMPORARY TABLESPACE temp QUOTA UNLIMITED ON users; Note: The script prompts for password to connect to database during execution. Password entry is hidden in console. Enter correct password and press Enter. If the password entered is NULL or wrong, the script can not be executed and the script has to be restarted again by providing correct login credentials. The script also prompts for parameters to be passed to the seed data procedures. The possible values are Y or N. Y - Non-EHA_User versioned seed data record will be replaced by EHA_User versioned seed data. N - Recommended, non-EHA_User versioned seed data record will not be replaced by EHA_User versioned seed data. Corresponding record will be rejected and a log will be entered in the log table. Note: This section is common for both UNIX and Windows installations. Table 22 Files for ODI Repositories File Name Comments software\repository\OHADI_MASTER_ REPOSITORY.zip ODI master repository zip for OHADI ODI 2.0.2. software\repository\ODIExport.zip Contains all the ETLs along with the import scripts. software\database\OHADI_WORK_ REPOSITORY_UPDATE.sql Contains SQL statements for work repository schema. Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-7 CREATE USER ohadi_work IDENTIFIED BY ohadi_work DEFAULT TABLESPACE users TEMPORARY TABLESPACE temp QUOTA UNLIMITED ON users; b. Disconnect from system user. 2. Log in to database using sys user with sysdba role. a. GRANT ALTER SESSION, CREATE DATABASE LINK, CREATE INDEXTYPE, CREATE JOB, CREATE MATERIALIZED VIEW, CREATE PROCEDURE, CREATE SEQUENCE, CREATE SESSION, CREATE SYNONYM, CREATE TABLE, CREATE TRIGGER, CREATE TYPE, CREATE VIEW to <user>; For example: GRANT ALTER SESSION, CREATE DATABASE LINK, CREATE INDEXTYPE, CREATE JOB, CREATE MATERIALIZED VIEW, CREATE PROCEDURE, CREATE SEQUENCE, CREATE SESSION, CREATE SYNONYM, CREATE TABLE, CREATE TRIGGER, CREATE TYPE, CREATE VIEW to ohadi_master; GRANT ALTER SESSION, CREATE DATABASE LINK, CREATE INDEXTYPE, CREATE JOB, CREATE MATERIALIZED VIEW, CREATE PROCEDURE, CREATE SEQUENCE, CREATE SESSION, CREATE SYNONYM, CREATE TABLE, CREATE TRIGGER, CREATE TYPE, CREATE VIEW to ohadi_work; b. GRANT EXECUTE ON DBMS LOCK TO <user>; For example: GRANT EXECUTE ON DBMS_LOCK to ohadi_master; GRANT EXECUTE ON DBMS_LOCK to ohadi_work; c. Disconnect from sys user. Perform the following steps to create an ODI master repository. 2.3.1 Creating a New Oracle Data Integrator Repository Login Perform the following steps to create a new ODI repository login: 1. Navigate to ODI > File > New > Create a New ODI Repository Login. Note: The repository names provided in the screenshot are for explanation of examples. The same naming convention for the screenshots can be followed if there are no users or connections of existing name exists, or follow the own naming convention for repositories and proceed with the following steps accordingly. Setting Up ODI Repositories 2-8 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 21 Create a New ODI Repository Login 2. Click OK. The Repository Connection Information screen is displayed. Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-9 Figure 22 Repository Connection Information Enter the following values: Login Name: OHADI_MASTER_REPOSITORY User: SUPERVISOR Password: SUNOPSIS (you can change it once import is completed successfully) User: <database schema created for Master Repository> Password: <database schema password created for Master Repository> Driver List: Select Oracle JDBC Driver from the list. Driver Name: oracle.jdbc.oracledriver Url: Set appropriate values based on your database details. 3. Click OK. A login name is created with the name given in the first property (for example, OHADI_MASTER_REPOSITORY here). 2.3.2 Importing Master Repository Perform the following steps to import a master repository: 1. Navigate to ODI > File > New > Master Repository Import Wizard. Setting Up ODI Repositories 2-10 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 23 Importing a Master Repository 2. Click OK. The Master Repository Import Wizard screen is displayed. Figure 24 Master Repository Import Wizard Enter the following values: Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-11 Login: Select the login created in step 2. JDBC Driver: Will be populated automatically. JDBC Url: Will be populated automatically. User and Password: Will be populated automatically. Leave them as is. DBA User and DBA Password: Enter appropriate values. Id: Enter a number. Use a Zip file: Check this box. Navigate to software > repository folder and select the OHADI_Master_Repository.zip file. 3. Click Finish. The master repository will be created. 2.3.3 Creating a New Oracle Data Integrator Work Repository Perform the following steps to create a new ODI work repository: 1. To create a new ODI work repository, open an ODI console window and log into OHADI_MASTER_REPOSITORY login that was created in Step 1 in Section 2.3.1. 2. Connect to the master repository and navigate to Topology > Repositories > Work Repositories. Right-click Work repositories and select New Work Repository. The Create Work Repository screen is displayed: Note: ODI does not support single ID system for repository IDs. The IDs used in one repository cannot be used in another repository while importing that particular repository. The repository provided contains repository IDs 321, 999, and 100 for the master repository. Ensure that you provide an ID other than these IDs in the text box of Id field. Setting Up ODI Repositories 2-12 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 25 ODI Work Repository Connection Properties Enter the following values in the screen: Technology: Select Oracle from the list. JDBC Driver: As per your database details JDBC Url: As per your database details User: Database schema created for work repository Password: Database schema password created for work repository 3. Click Test Connection to check if the connection is successful. 4. Click Next. The Specify ODI Work Repository Properties screen is displayed. Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-13 Figure 26 ODI Work Repository Properties Enter the following details: Name: Enter the name of the work repository. For example, OHADI_WORK_ REPOSITORY. Password: It is optional to enter a value in this field. Id: Enter a number. 5. Click Finish. The work repository will be created. You will be prompted to create a login for the same work repository as shown below. Note: ODI does not support single ID system for repository IDs. The IDs used in one repository cannot be used in another repository while importing that particular repository. Ensure that you provide an ID other than these values (1, 2, 3, 4, 5, 6, 7, 11, 39, 61, 67, 86, 123, 131, 201, 327, 440, 499, 645) in the text box of Id field. Setting Up ODI Repositories 2-14 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 27 Create a Login for the New Work Repository 6. Click Yes. The login screen is displayed. Figure 28 Login to Work Repository 7. Specify the login name and Click OK. 8. Disconnect from the master repository by selecting ODI and then Disconnect "OHADI_MASTER_REPOSITORY" from the menu bar. 2.3.4 Importing Scripts Perform the following steps to import scripts to the work repository: 1. Log in to OHADI_WORK_REPOSITORY. Figure 29 ODI Login 2. Open ODI Studio Login and enter the following details: Login Name: Select OHADI_WORK_REPOSITORY User: Supervisor Password: SUNOPSIS Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-15 To import the ODI objects on Linux environment, follow these steps: 1. Modify odiparams.sh file present in <ODI Installed folder>\oracledi\agent\bin directory with the necessary credentials to connect to the ODI repository. You need to set the following parameters: ODI_MASTER_DRIVER=oracle.jdbc.OracleDriver ODI_MASTER_URL=jdbc:oracle:thin:@<host>:<port>:<sid> ODI_MASTER_USER=<master repository database schema name> ODI_MASTER_ENCODED_PASS=<encoded password> a. To provide the encoded password, from the command prompt, navigate to the <ODI Installed folder>\oracledi\agent\bin directory and enter the following command: sh encode.sh <Master Repository database schema password> b. Copy and paste the output value returned by the command for the above parameter. ODI_SUPERVISOR=SUPERVISOR ODI_SUPERVISOR_ENCODED_PASS=<encoded password for SUNOPSIS> a. To provide the encoded password, from the command prompt, navigate to the <ODI Installed folder>\oracledi\agent\bin directory and enter the following command: sh encode.sh SUNOPSIS b. Copy and paste the output value returned by the command for the above parameter. c. ODI_SECU_WORK_REP=<OHADI_WORK_REPOSITORY> Enter the name of the work repository created in section Section 2.3.3. ODI_MAX_HEAP=1024m 2. Modify $ODI_HOME/bin/odiparams.sh to add timeout parameter by changing following line: ODI_JAVA_OPTIONS="-Djava.security.policy=server.policy -Doracle.security.jps.config=./jps-config.xml $ODI_PARAMS_JAVA_OPTION" to ODI_JAVA_OPTIONS="-Djava.security.policy=server.policy -Doracle.security.jps.config=./jps-config.xml -Doracle.odi.jdbc.connection.timeout=300 $ODI_PARAMS_JAVA_OPTION" 3. Update appropriate values for the following parameters in OHADI_ODI_ SETENV.sh located at OHADI_INSTALL_DIR>/ohadi_scripts/. ODI_WORK_REP, ODI_XML_DIR, ODI_HOME 4. Navigate to <OHADI_INSTALL_DIR>/ohadi_scripts/ and run OHADI_ODI_MASTER_ IMPORT.sh using the following command: nohup sh OHADI_ODI_MASTER_IMPORT.sh & Note: Save the file once all the parameters are set properly. Setting Up ODI Repositories 2-16 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide The status of the import process can be checked in $LOG_DIR/ OHADI_ODI_ IMPORT_INSTALLSUMMARY.log file. The summary log file looks as follows: <PASSED/FAILED> <XML file name> NO OF XMLS IMPORTED SUCCESSFULLY: <success xml count> NO OF XMLS FAILED TO IMPORT: <failed xml count> 5. If there are any failures (indicated by NO OF XMLS FAILED TO IMPORT: <n>, where n is the number of failed ETL imports) in the summary log file, fix the issues and execute the following retry script: nohup sh OHADI_ODI_IMPORT_RETRY.sh & Status of the retry script can be checked in $LOG_DIR/OHADI_ODI_ INSTALLSUMMARY.log file. The summary log file looks as follows: <PASSED/FAILED> <XML file name> NO OF XMLS IMPORTED SUCCESSFULLY: <success xml count> NO OF XMLS FAILED TO IMPORT: <failed xml count> 6. Run the following SQL file against the work repository schema: <OHADI_INSTALL_DIR>/ohadi_sqls/OHADI_WORK_REPOSITORY_UPDATE.sql Execute the following commands: cd <OHADI_INSTALL_DIR>/ohadi_sqls/ . <OHADI_INSTALL_DIR>/ohadi_scripts/OHADI_ODI_SETENV.sh $ORACLE_HOME/bin/sqlplus <work_rep_Db_user>/<work_rep_db_ password>@<work_rep_db> @<OHADI_INSTALL_DIR>/ohadi_sqls/OHADI_WORK_ REPOSITORY_UPDATE.sql To import the ODI objects on Windows environment, perform the following steps: 1. Ensure the following environment variables are set: a. Right-click on My Computer and select Properties. Click Advanced and then click Environment Variables. The Environment Variables window is displayed. Configure the following three environment variables (2 system, 1 user variables): Add system environment variable ODI_HOME that points to <ODI Installed folder>\oracledi\agent directory. Update system environment variable PATH to <PATH>;<ODI Installed folder>\oracledi\agent\bin directory. Add user environment variable %classpath% pointing to %classpath%. Note: No further retry script will be generated if failure occurs in OHADI_ODI_IMPORT_RETRY.sh. The failed ETL has to be imported by executing the individual import. Setting Up ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-17 b. Once these three variables are added, keep clicking OK until the Environment Variables window is closed. 2. Modify odiparams.bat file present in <ODI installed folder>\oracledi\agent\bin directory with the necessary credentials to connect to the ODI repository. Set the following parameters: set ODI_MASTER_DRIVER=oracle.jdbc.OracleDriver set ODI_MASTER_URL=jdbc:oracle:thin:@<host>:<port>:<sid> set ODI_MASTER_USER=<master repository schema name> set ODI_MASTER_ENCODED_PASS=<encoded password> a. To provide the encoded password, from the command prompt, navigate to the <ODI Installed folder>\oracledi\agent\bin directory and enter the following command: encode.bat <Master Repository database schema password> b. Copy and paste the output value returned by the command carefully for the parameter. set ODI_SUPERVISOR=SUPERVISOR set ODI_SUPERVISOR_ENCODED_PASS=<encoded password for SUNOPSIS> a. To provide the encoded password, from the command prompt, navigate to the <ODI Installed folder>\oracledi\agent\bin directory and enter the following command: encode.bat SUNOPSIS b. Copy and paste the output value returned by the command carefully for the above parameter. Set ODI_SECU_WORK_REP=<OHADI_WORK_REPOSITORY> Enter the name of the work repository created in step 4 in Section 2.3.3. set ODI_MAX_HEAP=1024m 3. Modify $ODI_HOME/bin/odiparams.bat to add timeout parameter by changing following line: SET ODI_JAVA_OPTIONS="-Djava.security.policy=server.policy" "-Doracle.security.jps.config=./jps-config.xml" %ODI_PARAMS_JAVA_OPTION% to SET ODI_JAVA_OPTIONS="-Djava.security.policy=server.policy -Doracle.security.jps.config=./jps-config.xml -Doracle.odi.jdbc.connection.timeout=300" %ODI_PARAMS_JAVA_OPTION% Save the file once all the parameters are set. 4. Update appropriate values for the following parameters in OHADI_ODI_ SETENV.bat located at <OHADI_INSTALL_DIR>/software/batchscripts/: ODI_ WORK_REP, ODI_XML_DIR, ODI_HOME 5. From the command prompt, navigate to the path <OHADI_INSTALL_DIR>/ software/batchscripts/ and run OHADI_ODI_MASTER_IMPORT.bat using the following command: OHADI_ODI_MASTER_IMPORT.bat Configuring ODI Repositories 2-18 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide The status of the import process can be checked in %LOG_DIR%/ OHADI_ODI_ VALIDATE_IMPORT.log. The success count and failure count are displayed at the end of the log file as follows: SUCCESS_COUNT = 3662 FAILURE_COUNT = 0 Additionally, individual log files will also be created in the same directory. 6. Run the following SQL file against the work repository schema: <OHADI_INSTALL_DIR>/ohadi_sqls/OHADI_WORK_REPOSITORY_UPDATE.sql Execute the following commands: cd <OHADI_INSTALL_DIR>/software/batchscripts/ OHADI_ODI_SETENV.bat sqlplus <work_rep_Db_user>/<work_rep_db_password>@<work_rep_db> @<OHADI_INSTALL_DIR>/software/database/OHADI_WORK_REPOSITORY_ UPDATE.sql 2.4 Configuring ODI Repositories This section is common for both UNIX and Windows installations. Configuring Physical Data Server When the master repository is imported, three Physical Data Servers will be created with following names: HDI connects to HDWF Interface database schema HDWF connects to HDWF database schema HMC connects to Metadata Configuration database 1. Connect to work repository by selecting OHADI_WORK_REPOSITORY as your login name. Figure 210 Log into Work Repository Enter the following details: Login Name: OHADI_WORK_REPOSITORY User: Supervisor Password: SUNOPSIS Configuring ODI Repositories Installing Oracle Healthcare Analytics Data Integration 2-19 2. Navigate to Topology > Physical Architecture> Expand Technology. Expand the Oracle node and double-click the physical data server created for HDI. Figure 211 Navigate to Physical Data Server 3. In the Definition tab, update the values for the properties: User: Database schema user of HDWF Interface schema Password: Database schema password for HDWF interface schema Instance/dblink (data Server): Connect string, for example, orcl. Figure 212 Connection Properties 4. In the JDBC tab, update the values of host, port, and sid in the JDBC URL connection, "jdbc:oracle:thin:@<host>:<port>:<sid>" for HDWF interface schema. 5. Click Save from the menu bar. The existing Physical Data Server HDI will be updated. 6. In addition, you can also verify whether the provided values are correct or not by using the Test Connection option. 7. Now repeat steps 2 through 6 for HDWF and HMC physical data servers. Configuring ODI Repositories 2-20 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Configuring Physical Schema 1. To update the existing physical schema for HDI, navigate to HDI data server in the Topology tab and expand the HDI data server node as configured above. Double-click HDI.HDI_ODI_202 as displayed in the following figure: Figure 213 Select Physical Schema 2. In the Definition tab, select the HDWF interface schema name from the drop down menus for the Schema (Schema) and Schema (work Schema) options accordingly. Figure 214 Configure the Physical Schema Note: This screenshot is only for information purpose. You may see different physical schema name in your system. Installation Verification Installing Oracle Healthcare Analytics Data Integration 2-21 3. Click Save from menu. The existing physical schema will be updated. 4. Repeat steps 1 through 3 for HDWF and HMC physical data servers. 5. Review all the above configurations again before going to next section. For more information on configuring the Topology, refer to ODI documentation. 2.5 Installation Verification For installing on UNIX, perform the following steps to validate your OHADI installation: 1. Run the following script to drop foreign key constraints. sh OHADI_ODI_DROP_IDX_VALIDATION.sh If prompted, enter valid HDM schema password. Password entry is hidden in console, so type correct password and press Enter. The script will display an error if wrong credentials are entered. Then the script has to be restarted again by entering correct credentials. The status of the script can be verified in $LOG_DIR/OHADI_ODI_DROP_IDX_ VALIDATION_SUMMARY.log The summary log looks as follows: <MM-DD-YYYY HH:MI:SS> ### START OF SCRIPT EXECUTION### OHADI_DROP_IDX_VALIDATION.sql : success <MM-DD-YYYY HH:MI:SS> ### SCRIPT COMPLETED ### 2. Execute the following validation script: sh OHADI_ODI_INSTALL_VERIFICATION.sh When prompted, enter valid HDI schema password and HDM schema password. Password entry is hidden in console, so type correct password and press Enter. The script will display an error if wrong credentials are entered. Then the script has to be restarted again by entering correct credentials. 3. The status of the execution of step 2 can be verified in the following file: Note: Before proceeding to install verification, ensure all the preceding steps are completed successfully. Note: All the scripts have to be executed from <OHADI_INSTALL_ DIR>/ohadi_scripts/ directory. Note: The above script contains three script executions internally in sequential order. The first script loads test data in HDWF interface tables. The second script runs corresponding ETLs to load the data in HDM. The third script checks and notifies if the data is being loaded to HDWF tables or not. Installation Verification 2-22 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide $LOG_DIR/OHADI_ODI_INSTALL_VERIFICATION_SUMMARY.log The summary log looks as follows: <MM-DD-YYYY HH:MI:SS> #### STARTED THE SCRIPT EXECUTION ## OHADI_INSTALLTEST_TESTDATA_CREATION.sql : <SUCCESS/FAILED> OHADI_INSTALLTEST_EXECUTE_INITIALLOAD_ETLS.sh : <SUCCESS/FAILED> OHADI_INSTALLTEST_VALIDATERESULT.sql : <SUCCESS/FAILED> <MM-DD-YYYY HH:MI:SS> #### END OF SCRIPT EXECUTION ## 4. After OHADI ODI 2.0.2 has been successfully installed, execute the following script to delete test data inserted into HDI tables and loaded to HDM tables. sh OHADI_ODI_DELETE_TEST_DATA.sh When prompted, enter valid HDI schema password and HDM schema password. Password entry is hidden in console, so type the correct password and press Enter. The script can not be executed if wrong credentials are entered. Then the script has to restarted again by entering correct credentials. The script status can be checked in $LOG_DIR/OHADI_ODI_DELETE_TEST_ DATA_SUMMARY.log 5. Run the following script to create foreign key indexes: sh OHADI_ODI_CREATE_IDX_VALIDATION.sh When prompted, enter valid HDM schema password. Password entry is hidden in console, so type the correct password and press Enter. The script can not be executed if wrong credentials are entered. Then the script has to restarted again by entering correct credentials. The status of the script can be checked in $LOG_DIR/OHADI_ODI_CREATE_ IDX_VALIDATION_SUMMARY.log The summary log looks as follows: <MM-DD-YYYY HH:MI:SS> ### START OF SCRIPT EXECUTION### OHADI_CREATE_IDX_VALIDATION.sql : success <MM-DD-YYYY HH:MI:SS> ### SCRIPT COMPLETED ### 6. Run the following script to revert the load date value in the configuration table: sh OHADI_ODI_RESET_LOADDATE.sh When prompted, enter valid HMC schema password. Password entry is hidden in console, so type the correct password and press Enter. The script can not be executed if wrong credentials are entered. Then the script has to restarted again by entering correct credentials. Note: You must verify the following files for any errors: $LOG_DIR/OHADI_INSTALLTEST_TESTDATA_CREATION.log $LOG_DIR/OHADI_INSTALLTEST_VALIDATERESULT.log If the validation script OHADI_INSTALL_VERIFICATION.sh has to be rerun, first execute the delete script OHADI_DELETE_TEST_ DATA.sh and then proceed from step 1. Installation Verification Installing Oracle Healthcare Analytics Data Integration 2-23 The status of the script can be verified in $LOG_DIR/OHADI_ODI_RESET_ LOADDATE_SUMMARY.log The summary log looks as follows: <MM-DD-YYYY HH:MI:SS> ### START OF SCRIPT EXECUTION### OAHDI_RESET_LOADDATE.sql : success <MM-DD-YYYY HH:MI:SS> ### SCRIPT COMPLETED ### To install on Windows, perform the following step: From the command prompt, navigate to the <OHADI_INSTALL_ DIR>/software/batchscripts directory and run the script OHADI_ODI_ INSTALLTEST.bat by using the below command: OHADI_ODI_INSTALLTEST.bat The script will display the status of the installation in the %LOG_DIR%\OHADI_ INSTALLTEST_VALIDATE_RESULT.log file. The following message is displayed in the file if the installation is successful: INSTALLATION SUCCEEDED: TARGET TABLES LOADED! If installation contains any errors then the following message is displayed in the file: ERROR: TARGET TABLES NOT LOADED Note: If the install verification has to be re-executed, then perform the following steps: Execute step 6 first. Execute from step 1 through step 5. Installation Verification 2-24 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide 3 Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-1 3 Installing Oracle Enterprise Healthcare Analytics Health Language International Integration This chapter contains the following topics: Setting Up ODI Repositories on page 3-1 Configuring ODI Repositories on page 3-10 3.1 Setting Up ODI Repositories The following files for ODI repositories are present in software > repository folder. 1. You must create a database schema for ODI master repository and for ODI work repository with the privileges mentioned in Section 2.3, "Setting Up ODI Repositories". 2. Get the master repository and work repository zip files from installation package. The file names of repository are: EHA_HLI_Master_Repository.zip EHA_HLI_Work_Repository.zip To create the ODI Master repository, perform the following steps: 1. To create a new ODI repository, log into ODI and navigate to File > New > Create a new ODI repository Login. Table 31 Files for ODI Repositories File Name Contains EHA_HLI_Master_Repository.zip ODI master repository zip for EHA HLI Integration EHA_HLI_Work_Repository.zip ODI work repository zip for EHA HLI Integration Note: The repository names provided in the screenshot are for explanation of examples. The same naming convention for the screenshots can be followed if there are no users or connections of existing name exists, or follow the own naming convention for repositories and proceed with the following steps accordingly. Setting Up ODI Repositories 3-2 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 31 Creating a new ODI Repository 2. Click OK. The Repository Connection Information screen is displayed. You must provide necessary values for all properties. Figure 32 Repository Connection Details Setting Up ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-3 Enter the following values: Login Name: EHA_HLI_MASTER_REPOSITORY User: SUPERVISOR Password: SUNOPSIS User: <database schema created for Master Repository in step 1> Password: <database schema password created for Master Repository in step 1> Driver List: Select Oracle JDBC Driver from the list. Driver Name: oracle.jdbc.oracledriver Url: Set appropriate values based on your database details. 3. Click OK. A login name is created with the name given in the first property (for example, EHA_HLI_MASTER_REPOSITORY). 4. To import the master repository, navigate to ODI > File > New > Master Repository Import Wizard. Figure 33 Importing the Master Repository 5. Click OK. The Master Repository Import Wizard screen is displayed. Setting Up ODI Repositories 3-4 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 34 Repository Connection Information Enter the following values: Login: Select the login created in step 2. JDBC Driver: Will be populated automatically. JDBC Url: jdbc:oracle:thin: Will be populated automatically. User and Password: Will be populated automatically. Leave them as is. DBA User and DBA Password: Enter appropriate values. Id: Enter a number. Use a Zip file: Select this check box. Navigate to software > repository folder and select the EHA_HLI_Master_Repository.zip file. 6. Click Finish. The master repository will be created. 7. To create a new ODI work repository, open an ODI console window and log in to EHA_HLI_MASTER_REPOSITORY login that is created in Step 1. 8. Connect to the master repository and navigate to Topology > Repositories > Work Repositories. Right-click Work repositories and select New Work Repository. The Create Work Repository screen is displayed. Note: ODI does not support single ID system for repository IDs. The IDs used in one repository cannot be used in another repository while importing that particular repository. The existing installation zip file already contains certain repository IDs 33, 321, 999 for the master repository. Ensure that you provide an ID other than these values in the ID field whenever a warning appears. Setting Up ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-5 Enter the following values in the screen: Technology: Select Oracle from the list. JDBC Driver: As per your database details JDBC Url: As per your database details User: Database schema created for work repository Password: Database schema password created for work repository 9. Click Test Connection to check if the connection is successful. 10. Click Next. The Specify ODI Work Repository Properties screen is displayed. Setting Up ODI Repositories 3-6 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 35 Specify ODI Work Properties Enter the following details: Id: Enter a number. Name: Enter EHA_HLI_WORK_REPOSITORY. Password: It is optional to enter a value in this field. 11. Click Finish. The work repository will be created. You will be prompted to create a login for the same work repository as shown: Note: ODI does not support single ID system for repository IDs. The IDs used in one repository cannot be used in another repository while importing that particular repository. The existing installation zip file already contains certain repository IDs 1, 2, 3, 4, 5, 33, 100, 102, 201, 222, 322, 624, 625, 626, 785 for the work repository. Ensure that you provide an ID other than these values in the ID field. Setting Up ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-7 Figure 36 Create a Login for Work Repository 12. Click Yes. The login screen is displayed. Figure 37 Login Name 13. Specify the login name and Click OK. 14. Disconnect from the master repository. 15. To import a work repository into ODI from a zip file, connect to work repository by selecting EHA_HLI_WORK_REPOSITORY as your login name. Figure 38 Log in to Work Repository Enter the following details: Login Name: EHA_HLI_WORK_REPOSITORY User: Supervisor Password: SUNOPSIS 16. To import a work repository into ODI from EHA_HLI_Work_Repository.zip file, navigate to Designer > Import. Setting Up ODI Repositories 3-8 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 39 Select Import 17. The Selection screen is displayed. Select Import the Work Repository. Figure 310 Import Work Repository 18. In the Import Work Repository screen: Select Synonym Mode INSERT_UPDATE as the Import Mode. Select Import From a Zip File. Enter the path to EHA_HLI_Work_Repository.zip. Setting Up ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-9 Figure 311 Import from Zip File 19. A Confirmation dialog box is displayed for each ID used in zip file. Click Yes on all dialog boxes until you see Import is in Progress dialog box. Figure 312 ID Declaration Confirmation Screen 20. Once the import is completed, the Import Report screen is displayed. In the Import Report screen, scroll down to the end. The last four sections should have zero objects if the import is successful as shown: Figure 313 Import Report Screen Configuring ODI Repositories 3-10 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide 3.2 Configuring ODI Repositories Configuring Physical Data Server When the master repository is imported, the following Physical Data Servers will be created with these names: HDI - connects to HDWF Interface database HMC - connects to Metadata Configuration database HLI_DATA - connects to the Physical folder location having HLI Data Files 1. Open ODI studio and click Connect To Repository and select the login EHA_HLI_ WORK_REPOSITORY and click OK. Figure 314 Log in to Work Repository Enter the following details: Login Name: EHA_HLI_WORK_REPOSITORY User: Supervisor Password: SUNOPSIS 2. Navigate to Topology > Physical Architecture > Technologies > Oracle. Double-click HDI. 3. In the Definition tab, update the values for the following properties: User: Database schema user of HDWF Interface schema Configuring ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-11 Password: Database schema password for HDWF interface schema Instance/dblink (data Server): Connect string, for example, ORCL. Figure 315 Enter Details for HDI 4. In the JDBC tab, update the values of the JDBC system connection, which contains HDWF interface schema. 5. Click Save from the menu. The existing Physical Data Server HDI will be updated. 6. Click Test Connection on the top. Click Test in the next screen to verify if the configuration is correct. 7. Repeat steps 1 through 6 for HMC physical data server. Configuring Database Physical Schema 1. To update the existing physical schema for HDI, navigate to Topology > Oracle > HDI. Expand HDI and double-click HDI.HDI_V502. Configuring ODI Repositories 3-12 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 316 Select the Physical Schema 2. In the Definition tab, select the appropriate values accordingly. Select the actual physical database schema name of HDI from the drop-down lists. Figure 317 Update the Schema Properties 3. Click Save from menu. The existing physical schema will be saved. 4. Repeat steps 1 through 3 for HMC physical data server. HLI_DATA File Data Server 1. Navigate to Topology > Physical Architecture > Technologies > File. Double-click HLI_DATA. Configuring ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-13 Figure 318 HLI_DATA File Data Server 2. In the JDBC tab, update the values of the JDBC Driver and JDBC URL as shown: JDBC Driver: com.sunopsis.jdbc.driver.file.FileDriver JDBC URl: jdbc:snps:dbfile Figure 319 Update Values in JDBC Tab Configuring File Physical Schema 1. To update the existing physical schema for HLI_DATA, navigate to Topology > Physical Architecture > Technologies > File > HLI_DATA. Double-click the physical schema. Configuring ODI Repositories 3-14 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Figure 320 Update the Physical Schema for HLI_Data 2. In the Definition tab, specify the actual physical folder location of the HLI Data Files for the properties Directory (Schema) and Directory (Work Schema). 3. Click Save from menu. The existing physical schema will be saved. 4. For Windows machine, perform the following steps (for UNIX machine installation, skip this step). a. Disconnect from the work repository (EHA_HLI_WORK_REPOSITORY). b. Run the following query against the HLI work repository schema: UPDATE SNP_TABLE SET FILE_SEP_ROW='\u000D\u000A' WHERE RES_NAME IN ( '#EHA_HLI_INTEGRATION.VAR_CODE_FILE_NAME', '#EHA_HLI_INTEGRATION.VAR_RELATED_ENTITY_FILE_NAME', '#EHA_HLI_INTEGRATION.VAR_CODE_HIERARCHY_FILE_NAME', '#EHA_HLI_INTEGRATION.VAR_RELATIONSHIP_TYPE_FILE_NAME', '#EHA_HLI_INTEGRATION.VAR_CODE_DESCRIPTION_FILE_NAME'); c. Connect to the work repository back (EHA_HLI_WORK_REPOSITORY) and proceed with the post installation steps. 3.2.1 Post Installation Steps The following post installation steps are mandatory for OHADI to work: 1. Open ODI studio. Note: For further references on Topology configuration, see ODI documentation. Note: If the source file are transferred from Windows to UNIX machine, transfer it using the TEXT mode. Configuring ODI Repositories Installing Oracle Enterprise Healthcare Analytics Health Language International Integration 3-15 2. Click Connect to Repository, select the login EHA_HLI_WORK_REPOSITORY, and click OK. 3. In the Designer tab: a. Navigate to the project EHA HLI Integration, select the Global folder. b. Select the package GENERATE ALL SCENARIOS, right-click on the package, and select Execute. The Execute dialog box is displayed. c. Click OK. d. Click OK in the Information dialog box. 4. In the Designer tab, click the Load Plans and Scenarios tab. Select and execute the scenario LOAD_GLOBAL Version 001. 5. Create a flat file Code.txt with the following two records in the configured folder location: "ConceptId"~`^"Code"~`^"Description"~`^"CodeSystem"~`^"CodeVersion"~`^" EffectiveDate"~`^"ExpirationDate"~`^"CreationDate"~`^"LastModifiedDate" ~`^"Status" "ID123456"~`^"CODE1234"~`^"Code Description testing"~`^"CD_TEST_ SYSTEM"~`^"CD_TEST_SYS_VER_ 1:2:3"~`^"01/10/2000"~`^"01/10/2999"~`^"01/10/2003"~`^"02/01/2999"~`^"C URRENT" 6. In the Designer tab, click the Load Plans and Scenarios tab. Select and execute the scenario LOAD_HDI_CD_SYS Version 001. A record should be loaded in HDI_CD_SYS. 7. Delete the file Code.txt from the configured folder location. To delete the test record inserted into HDI_CD_SYS, perform the following steps: a. Login to the HDI schema using sqlplus. For connecting to sqlplus, see Section 2.2, "Setting Up the Database". b. Execute the following command: DELETE FROM HDI_CD_SYS WHERE INT_ID='CD_TEST_SYSTEM~CD_TEST_SYS_ VER_1:2:3'; This command will delete a record. c. Commit the transaction by running the following command: COMMIT; Note: Ensure only two lines are showing up in the flat file. If the records split into multiple lines, rearrange the records to show only two lines. Configuring ODI Repositories 3-16 Oracle Healthcare Analytics Data Integration Secure Installation and Configuration Guide Index-1 Index C configuring ODI repositories, 2-18 H health language international, 3-1 hli, 3-1 configuring ODI repositories, 3-10 setting ODI repositories, 3-1 P prerequisite software, 2-1 R related documents, vi S security, 1-1 setting up database, 2-1 ODI repositories, 2-6 T technology stack, 1-1 Index-2