Home

Oracle Health Sciences Information Gateway CONNECT Gateway

1. a Djsse enableSNIExtension false To set these JVM options perform the following steps 1 Navigate to the scripts directory using the following command cd lt install_dir gt addons connect scripts 2 Open the script file using the following command vi connect start weblogic sh 3 Add the following commands before the export JAVA_OPTIONS command JAVA_OPTIONS SJAVA_OPTIONS Dcom sun net ssl enableECC false JAVA OPTIONS SJAVA OPTIONS Djsse enableSNIExtension false 4 Save the changes and restart the server Configuring Oracle CONNECT Adapters with Oracle Components B 5 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository B 6 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide C Creating and Importing Certificates Using the GlassFish Self Signed Certificate Scripts This appendix describes how to create and import certificates using the GlassFish self signed certificate scripts It contains the following topics Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Adapter on page C 1 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Gateway on page C 2 Avoiding a Java Security Certificate Exception on page C 2 C 1 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Adapter Perform the following s
2. c If the installation is correct this returns a page with the Patient ID for the patient d Click PatientId for additional details on the patient e The Document tab is now enabled and you can search for patient documents by date range Search for date range 08 01 2000 to 08 01 2010 2 6 Validating Oracle Health Sciences Information Gateway CONNECT using Soap UI Validation Suite 2 6 1 Running Validation Suite Tests Perform the following steps to run validation suite tests 1 Setup soapUI cp lt install_dir gt addons connect oracle_db ojdbc6 jar to lt soapui_install_ dir gt bin ext 2 Load soapUI tests cd lt config_nhin_dir gt ValidationSuite 1 InternalSelfTest_g0 soapui project xml Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 7 Validating Oracle Health Sciences Information Gateway CONNECT using Soap UI Validation Suite 1 InternalSelfTest_gl soapui project xml 2 EndToEndSelfTest_g0 soapui project xml 2 EndToEndSelfTest gl soapui project zml 4 ConnectionManagerTest soapui project xml Note If running from an alternate machine copy the lt config_ nhin_dir gt directory and edit the xml wsdl paths to reflect the new location 3 Tar nhin directory cd lt domain_config_dir gt tar cvf nhin tar nhin 4 Copy the remote file scp hiauser lt remote_host gt lt domain_config_dir gt nhin tar 2 8 Oracle Health Sciences Information
3. cer trustcacerts 5 List the truststore keytool list keystore WL SERVER DIR server lib DemoTrustChangeit jks storepass changeit v 2 6 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Validating Oracle Health Sciences Information Gateway CONNECT using Soap UI Validation Suite 2 4 Installing Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Execute the following commands to install the CONNECT Gateway and Adapter tar zxvf ohig_connect_installer tgz cd ohig_connect_installer java jar ohig connect installer jar To follow prompts refer to Appendix A Running Oracle Health Sciences Information Gateway CONNECT Installer 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client The OHIG CONNECT adapter comes with an internal implementation of MPI Document Registry and Document Repository services that are enabled by default These services are available for testing purposes only To validate the CONNECT software on the OHIG Gateway and Adapter perform the following steps 1 Start the application server on both the gateway and adapter 2 Validate the installation using the sample universal client distributed with the adapter a Launch the application by navigating to the following URL http lt adapter_host_ip gt 7001 CONNECTUniversalClientGUI b Search for patient with last name Younger
4. Health Information Exchange Health Information Exchange is an entity that enables the movement of health related data among entities within a state a region or a non jurisdictional participant group which might include classic regional health information organizations at regional and state levels Health Information Organization integrated delivery systems and health plans or health data banks that support health information exchange Health Information Organization Health Information Organization is an organization that enables the movement of health related data among entities evolving as a replacement term for health information exchange or HIE Healthcare Information Technology Standards Panel Or simply HITSP a cooperative partnership between the public and private sectors formed and supported by ONC for the purpose of harmonizing and integrating standards that will meet clinical and business needs established by AHIC use cases for sharing information among organizations and systems Integrating the Healthcare Enterprise Integrating the Healthcare Enterprise is an initiative by healthcare professionals and industry to improve the way computer systems in healthcare share information promoting and coordinating the use of established standards such as DICOM and HL7 to address specific clinical need in support of optimal patient care The Nationwide Health Information Network is being developed by ONC to provide a secure Glossary
5. gt lt keyedReference tModelKey CONNECT adapter apilevel keyName keyValue LEVEL_a0 gt lt categoryBag gt 5 Edit the file lt config_nhin_dir gt repository properties and edit or create the following property convert PnR2SOR true Note The property convertPnRSOR should only be set to true when using the internal test repository with Oracle Registry 6 Restart the application server B 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Healthcare Master Person Index 1 Log into the OHIG adapter host 2 Edit the file lt config_nhin_dir gt internalConnectionInfo xml GlassFish example lt glassfish_install_dir gt domains lt domain_ name gt config nhin internalConnectionInfo xml WebLogic example lt weblogic_install_dir gt user_projects domains lt domain_ name gt config nhin internalConnectionInfo xml B 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository 3 Edit or create the business service adaptercomponentmpiservice Change the lt accessPoint gt from lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 Adapter PatientDiscovery A_0 AdapterComponentMpiService lt accessPoint gt to lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 AdapterComponent IheMpi Adapte
6. Before proceeding with creating OHIG CONNECT test patients ensure that you have already validated your configuration with OHIM HRL as described in Section 3 1 3 Setting up Components and Section 3 1 4 Validating Adapter Configuration with Oracle Health Sciences Information Manager Health Record Locator Perform the following steps to create OHIG CONNECT test patients 1 Login to the OHMPI Master Index Data Manager MIDM web application http sohmpi host uri 8080 PatientMIDM A default user with MasterIndex Admin Administrator group privileges has already been created in the GlassFish file realm User mdm Password mdm Configuring the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 3 3 Configuring the Adapter with Oracle Healthcare Master Person Index 3 Inthe Source Record tab select Add and create the following patients in the MIDM System SelfTest System 1 LocalID D123401 FirstName Gallow LastName Younger SSN 999 99 9999 Gender Male Date of Birth 06 27 1999 Address Type street address line Address Linel 123 Main street City LEESBURG State Code VA Postal Code 20176 System SelfTest System 1 LocalID D123407 FirstName Jordy LastName LaForge SSN 999 99 9999 Gender Female Date of Birth 11 14 1923 Address Type delivery address line Address Linel 5804 Post Corners Trl City Centerville State Code VA Postal Code 20120 Sy
7. export PATH JAVA_HOME ANT_HOME MW_HOME WL_SERVER_DIR WL_DOMAIN_DIR alias start sh WL_DOMAIN_DIR bin startWebLogic sh alias stop sh WL_DOMAIN_DIR bin stopWebLogic sh alias log tail f SWL_DOMAIN_DIR servers AdminServer logs AdminServer log D 2 Creating and Importing a Self Signed Certificate Perform the following steps to create a self signed certificate 1 Create the identity keystore keytool genkey keystore keystore jks storepass changeit keypass changeit alias identity dname CN MyHostname OU FOR TESTING ONLY O MyOrganization L MyTown S MyState C US keyalg RSA keysize 2048 2 Export the identity keystore certificate keytool export keystore keystore jks storepass changeit alias identity file identity cer 3 Import the identity keystore certificate keytool import keystore truststore jks storepass changeit alias identity file identity cer trustcacerts Examples for Setting up Oracle Health Sciences Information Gateway CONNECT D 3 Creating and Importing a Self Signed Certificate 4 List the identity keystore keytool list keystore keystore jks storepass changeit v 5 List the truststore keytool list keystore truststore jks storepass changeit v D 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide E References This section provides links to supporting documentation and resources E 1 CONNECT Please visit the
8. srcstorepass DemoIdentityKeyStorePassPhrase deststorepass changeit srcalias demoidentity destalias demoidentity srckeypass DemoIdentityPassPhrase destkeypass changeit noprompt 5 List JSSE compatible demo truststore keytool list keystore WL SERVER DIR server lib DemoTrustChangeit jks storepass changeit v 6 List JSSE compatible demo identity keystore keytool list keystore WL_SERVER_DIR server lib DemoIdentityChangeit jks storepass changeit v 2 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Prerequisites 2 1 2 1 2 Configuring Custom WebLogic Trust and Identity Keystores 1 Update WebLogic security through the console a b Log into http localhost 7001 console Navigate to Home gt Summary of Environment gt Summary of Servers gt AdminServer Under the General tab enter the following values in the respective fields Listener Port Enabled true Listener Port 7001 SSL Listener Port Enabled true SSL Listener Port 7002 Under the Configuration Keystores tab enter the following values in the respective fields Custom Identity and Custom Trust true Keystores Custom Identity and Custom Trust Custom Identity Keystore home hiauser Oracle Middleware wlserver_ 10 3 server lib DemoldentityChangeit jks Custom Identity Keystore Type JKS Custom Identity Keystore Passphrase changeit Custom Trust Keystore home hiauser Oracle Middl
9. 4 4 the businessKey value should be set to uddi testnhieonenode 4 4 5 Edit or create the business service adapterxdsbdocrepository Change the lt accessPoint gt from lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 CONNECTAdapter DocumentRepository_Service lt accessPoint gt to lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 CONNECTAdapterDocReposSoap12 AdapterDocRepository2Soap12Service lt acces sPoint gt lt categoryBag gt lt keyedReference tModelKey uddi nhin versionofservice keyName keyValue 1 0 gt lt keyedReference tModelKey CONNECT adapter apilevel keyName keyValue LEVEL_a0 gt lt categoryBag gt 6 Ensure to comment out the business service adapterxdsbdocrepositorysoap12 element 7 Restart the application server B 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository Note To avoid the exception javax net ssl SSLException Received fatal alert illegal_parameter execute the following steps GlassFish Add the following JVM options from Glassfish admin console and restart the server a Dcom sun net ssl enableECC false a Djsse enableSNIExtension false WebLogic Add the following JVM options to the OHIG Connect WebLogic script Dcom sun net ssl enableECC false
10. Gateway CONNECT Installation and Configuration Guide 3 Configuring the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter This section describes how to do the configure the adapter to connect to Oracle services instead of the internal test services This chapter contains the following topics Configuring the Adapter with Oracle Health Sciences Information Manager Health Record Locator on page 3 1 Configuring the Adapter with Oracle Healthcare Master Person Index on page 3 2 Configuring the Adapter with Oracle Health Sciences Transaction Database on page 3 5 3 1 Configuring the Adapter with Oracle Health Sciences Information Manager Health Record Locator This section describes how to configure the adapter to connect to the Oracle Health Sciences Information Manager OHIM registry to Record Locator instead of the internal test document registry Prerequisite Configuration and validation specified in Section 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 are completed successfully 3 1 1 Installing Certificates Log in to the adapter host If not done already create and import the certificate for the adapter host in to your application server s keystore For details refer to the following GlassFish or Weblogic application server documentation Sun GlassFish Enterprise Server v2 1 1 http docs oracle com cd E19879 01 index html Oracle F
11. Prerequisites 2 1 2 Prerequisites for WebLogic Oracle Health Sciences Information Gateway CONNECT Install 2 1 2 1 Setting up Java Secure Socket Extension JSSE Compatible Demo Trust and Identity Keystores 2 1 2 1 1 Creating Java Secure Socket Extension JSSE Compatible Keystores from DemoTrust jks and Demoldentity jks Example Environment Variables MW_HOME home hiauser Oracle Middleware JAVA_HOME home common java jdk1 7 0 JAVA_VENDOR Sun WL_SERVER_DIR SMW_HOME wlserver_10 3 WL_DOMAIN_DIR MW_HOME user_projects domains domainl Execute the following commands 1 List the original demo truststore keytool list keystore WL_SERVER_DIR server lib DemoTrust jks storepass DemoTrustKeyStorePassPhrase v 2 List the original demo identity keystore keytool list keystore WL_SERVER_DIR server 1lib DemoIdentity jks storepass DemoIdentityKeyStorePassPhrase v 3 Create Java Secure Socket Extension JSSE compatible demo truststore keytool importkeystore srckeystore WL SERVER DIR server lib DemoTrust jks destkeystore WL SERVER DIR server lib DemoTrustChangeit jks srcstoretype JKS deststoretype JKS srcstorepass DemoTrustKeyStorePassPhrase deststorepass changeit 4 Create JSSE compatible demo identity keystore keytool importkeystore srckeystore WL_SERVER_ DIR server lib DemoIdentity jks destkeystore WL SERVER DIR server 1lib DemoIdentityChangeit jks srcstoretype JKS deststoretype JKS
12. and get the compressed tar file tgz 1 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide 2 Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter This chapter provides general directions for setting up OHIG CONNECT It contains the following topics Prerequisites on page 2 1 Setting up the Network on page 2 4 Exchanging Certificates on page 2 5 Installing Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter on page 2 7 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 Validating Oracle Health Sciences Information Gateway CONNECT using Soap UI Validation Suite on page 2 7 2 1 Prerequisites 2 1 1 Prerequisites for Installing Common Oracle Health Sciences Information Gateway CONNECT Perform the following steps for a common install of OHIG CONNECT 1 Extract the installer tgz file by executing the following commands tar zxvf ohig connect installer tgz cd ohig connect installer Create database tables by executing the following commands cd lt install_dir gt addons connect oracle_db sqlplus SOL Plus Release 11 1 0 6 0 Production on Thu Jul 19 12 34 18 2012 Enter user name sys as sysdba Enter password SQL gt nhincdb oracle sal Commit complete SQL gt quit Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 1
13. following links for more information about CONNECT software and documentation CONNECT Release Home http developer connectopensource org display NHINR33 Release 3 3 Home CONNECT Software Documentation http developer connectopensource org display NHINR33 Software Documentation CONNECT Architecture Overview http developer connectopensource org display NHINR33 Architect ure Overview CONNECT Interface Description Document http developer connectopensource org display NHINR33 Interface Description Document CONNECT Universal Client GUI User Manual http developer connectopensource org display NHINR33 UC GUI Us er Manual Using the CONNECT Solution to support Health Information Exchange http developer connectopensource org display NHINR33 Using the CONNECT Solution to Support Health Information Exchange HIE CONNECT Specifications http www connectopensource org product connect nhin specs References E 1 CONNECT E 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide F This section provides a list of commonly used acronyms F 1 Acronyms CCD Continuity of Care Document CDA Clinical Document Architecture DER Distinguished Encoding Rules HIE Health Information Exchange HIO Health Information Organization HL7 Health Level 7 IHE Integrating the Healthcare Enterprise NAV Notification Of Document Availabil
14. gt lt keyedReference tModelKey uddi nhin versionofservice keyName keyValue 1 0 gt Configuring Oracle CONNECT Adapters with Oracle Components B 3 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository lt keyedReference tModelKey CONNECT adapter apilevel keyName keyValue LEVEL_a0 gt lt categoryBag gt Note If you have selected non default home community ID other than 1 1 for the HIG installation ensure that you provide an appropriate value for the businessKey attribute of the businessService element For example if you have selected home community ID as 4 4 the businessKey value should be set to uddi testnhieonenode 4 4 4 Edit or create the business service adapterxdsbdocrepositorysoap12pnr Ensure lt accessPoint gt is defined as lt accessPoint useType endPoint gt https lt oracle_repository_host_ ip gt 7778 XDS xdsrepositoryb iti41 lt accessPoint gt lt categoryBag gt lt keyedReference tModelKey uddi nhin versionofservice keyName keyValue 1 0 gt lt keyedReference tModelKey CONNECT adapter apilevel keyName keyValue LEVEL_a0 gt lt categoryBag gt Note If you have selected non default home community ID other than 1 1 for the HIG installation ensure that you provide an appropriate value for the businessKey attribute of the businessService element For example if you have selected home community ID as
15. 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 BA crac arr NE De BG EG ee GE EE EG ERG vii PUI CI CO Ee EE N E DE EE EO OG Pad Ba DE DER abs ss Des GE EE Ke 8 Dog Ee vii Documentation Accessibility si Sessies dei ieies pE e E E EE TEE Geskeer gegee ged Ee eed vii Related DO Gumen ts ss EE EN Ee ES Siete wl esac Boe eh ee I iin ee gee eee vii GONVERHONSS REIS Ee ER EE Ge RE De ee DE Ee ER n E RR ED Re sg viii 1 Getting Started 1 1 Hardware Requirements innin ioa es aa i E aa Eiaa ee de ge ek ee kee Paaris 1 1 1 2 Software Requirements pini iar a a A a eer es a E aari 1 1 1 3 Downloading Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 1 2 2 Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 1 Prerequisites fos ees es gede ee es gee does ee cued ey ee ecco ieee tales Be EER sees teh oie tees 2 1 2 1 1 Prerequisites for Installing Common Orac
16. the machine hostname it should match the cert file you copied to the config folder without cer suffix gt bash import others cert sh C 2 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Gateway Perform the following steps to install self signed certificates on the OHIG CONNECT gateway 1 2 Log in to the gateway machine Stop the application server using the following commands a gt cd lt glassfish_install_dir gt bin b gt asadmin stop domain lt domain_name gt Navigate to the directory lt install_dir gt addons connect scripts using the following command gt cd lt install_dir gt addons connect scripts Execute create and import selfsigned certs sh to install the self signed certificate gt sh create and import selfsigned certs sh This performs the following creates the keystore for the private internal key exports the certificate that will authenticate the internal key imports the trusted certificates into the truststore provides these certificates to the server to use for authentication purposes Install the adapter machine certificate Copy the adapter machine certificate of lt ADAPTER_ HOSTNAME cer gt to the lt glassfish_install_dir gt domains lt domain_name gt config folder Navigate to and execute lt install_ dir gt addons connect scripts import others cert sh When prompted by the scripts enter the adapter machine hostname it s
17. 1 Nationwide Health Information Network Glossary 2 nationwide interoperable health information infrastructure that will connect providers consumers and others involved in supporting health and healthcare Nationwide Health Information Network Nationwide Health Information Network is a set of standards services and policies that enable secure health information exchange over the Internet The network will provide a foundation for the exchange of health information across diverse entities within communities and across the country helping to achieve the goals of the HITECH Act This critical part of the national health IT agenda will enable health information to follow the consumer be available for clinical decision making and support appropriate use of healthcare information beyond direct patient care so as to improve population health Nationwide Health Information Network Gateway Within the CONNECT solution the implementation of the core NHIN services and service interface specifications comprising the CONNECT gateway and CONNECT adapter The NHIN health information exchange or NHIE a health information exchange that implements the NHIN architecture processes and procedures is accredited as a participant of the NHIN Oracle Virtual Machine Oracle Virtual Machine is a platform that provides a fully equipped environment for better leveraging the benefits of virtualization technology Oracle VM enables you to deploy opera
18. 1 D 1 1 D 1 2 D 1 3 D 1 4 D 1 5 D 1 6 D 2 EnvironmentoetHngs issie sed ee iS ie Res oe sa Geek An Ee sek Ee de Ee Rek ee eek sg EE ee eed D 1 Example GlassFish Directories issues ee geoes ee sede gese ee Ge seke goe Ge e Eed Ge oe sk ese GESE be D 1 Example GlassFish Commands ssi ese sesse se se see Re Ge pi tiar ee He He ee He He He aie aar a D 1 Example WebLogic Directories uitsien sei ese rek ER See ve ok vk gebere AA SEE er Ge RES KeN oe Ge DABESe GF Ge Eb D 2 Example WebLogic Commands ese sesse se se ee Re Ge Gee RR Ge Ge AR Re He Ge Ge RR Re He Gee Re He He Gee D 2 Example GlassFish home hiauser bashrC i ese sees se se see Re He Ge Ge ER Re He Ge ee He He Deeg D 2 Example WebLogic home hiauser bashrC i iese se se se se ee Ge Ge Ge Re Ge ee He Ge Gee D 3 Creating and Importing a Self Signed Certificate sesse se ek ER ER ER ER ERGE GE GE ek Ee BEK ER ee ee D 3 E References E 1 F Acronyms F 1 Glossary Index CONNEC ER RE EE RE EE OO ER ER OR OE Oe E 1 ACTON INS REDE ns ED ee ee Ge Ge RE ee De N de F 1 vi Audience Preface The Oracle Health Sciences Information Gateway OHIG leverages Integrating the Healthcare Enterprise IHE profiles CONNECT reference architecture Direct and Oracle WebLogic to orchestrate secure health policy based exchanges over the Internet This document is intended for users who want to install and use OHIG to participate in standards based health inf
19. Enterprise Linux 5 5 or higher Configuration Requirements Apache Ant 1 8 2 executable in path PATH S PATH lt install_dir gt apache ant 1 8 2 bin Oracle Software Requirements Oracle Health Sciences Information Manager OHIM Record Locator 2 0 or higher Oracle Health Sciences Information Manager OHIM Policy Engine 2 0 or higher Getting Started 1 1 Downloading Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Oracle Healthcare Master Person Index OHMPI 2 0 1 or higher Oracle Healthcare Transaction Database HTB 6 1 or higher 1 3 Downloading Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter To download the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter perform the following tasks 1 2 9 N o N BR w Navigate to http edelivery oracle com Enter your Registration information accept the Agreement Terms by selecting the checkboxes then click Continue From the Select a Product Pack drop down menu select Health Sciences From the Platform drop down menu select Linux x86 Click Go Select Oracle Health Sciences Information Gateway Media Pack Click Continue Click Download for the following and save the files to your system a Oracle Health Science Information Gateway 2 0 1 CONNECT Gateway and Adapter Extract the files to view the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Installation and Configuration Guide
20. ORACLE Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Installation and Configuration Guide Release 2 0 1 E37024 02 October 2013 Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Installation and Configuration Guide Release 2 0 1 E37024 02 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 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 user
21. _dir null gt home hiauser SUNWappserver Glassfish domain name Enter glassfish domain name domainl gt Glassfish copy ojdbc jar to domain lib ext Choose option glassfish_copy_ojdbc_jar_to_domain_lib_ext yes no gt Start glassfish Choose option start_glassfish yes no Running Oracle Health Sciences Information Gateway CONNECT Installer A 1 Oracle Health Sciences Information Gateway CONNECT Adapter gt no Glassfish admin username Enter glassfish_admin_username admin gt Glassfish admin password Enter glassfish_admin_password adminadmin a Glassfish master password Enter glassfish_master_password changeit gt Glassfish admin port Enter glassfish_admin_port 4848 Pe Glassfish jvm option Xms Enter glassfish_jvm_option_xms 512m gt Glassfish jvm option Xmx Enter glassfish_jvm_option_xmx 1024m gt Glassfish jvm option XX MaxPermSize Enter glassfish_jvm_option_max_perm_size 256m ma Connect database host Enter connect_db_host localhost gt hiadevdb Connect database port Enter connect_db_port 1521 gt Connect database sid Enter connect_db_sid orcl gt Connect database nhinc username Enter connect_db_nhinc_username nhincuser gt Connect database nhinc password Enter connect_db_nhinc_password nhincpass gt Connect adapter host Enter connectadapter_host localhost gt Connect
22. adapter http port Enter connectadapter_http_port 8080 gt Connect adapter https port Enter connectadapter_https_port 8181 2 Connect gateway host Enter connectgateway_host localhost 2 Connect gateway http port Enter comnectgateway http port 8080 Connect gateway https port Enter comnectgateway https port 8181 Connect home community id Enter connect_home_community_id 1 1 Connect home community name Enter connect_home_community_name 1 1 A 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Oracle Health Sciences Information Gateway CONNECT Adapter gt Connect assigning authority id Enter connect_assigning_authority_id 1 1 gt Stop glassfish Choose option stop_glassfish yes no gt no A 1 2 WebLogic cd lt install_dir gt java jar ohig connect installer jar Oracle HIG Connect Installer 2 0 1 0 Feature Choose option install_feature connect connectadapter connectgateway gt connectadapter Target Choose option install_target glassfish weblogic gt weblogic Command Choose option install_command usage version install gt install Start weblogic Choose option start_weblogic yes no gt no Weblogic install directory Enter weblogic_install_dir nul1l gt home hiauser Oracle Middleware Weblogic jdk directory Enter weblogic_jdk_dir home common java jdk1 7 0 based on inst
23. all_java_ home gt Weblogic server name Enter weblogic_server_name AdminServer gt Weblogic domain name Enter weblogic_domain_name domain1 gt Weblogic domain directory Enter weblogic_domain_dir home hiauser Oracle Middleware user_ projects domains domainl based on weblogic_install_dir user_ projects domains weblogic_domain_name gt Weblogic admin username Enter weblogic_admin_username weblogic a Weblogic admin password Enter weblogic_admin_password welcome1 gt Weblogic admin protocol Enter weblogic_admin_protocol t3 gt Weblogic host Enter weblogic_host localhost gt Weblogic admin port Enter weblogic_admin_port 7001 gt Running Oracle Health Sciences Information Gateway CONNECT Installer A 3 Oracle Health Sciences Information Gateway CONNECT Gateway Connect database host Enter connect_db_host localhost gt hiadevdb Connect database port Enter connect_db_port 1521 gt Connect database sid Enter connect_db_sid orcl Pe Connect database nhinc username Enter connect_db_nhinc_username nhincuser a Connect database nhinc password Enter connect_db_nhinc_password nhincpass gt Connect gateway host Enter connectgateway_host localhost gt Connect gateway http port Enter connectgateway_http_port 7001 Connect gateway https port Enter connectgateway_https_port 7002 Conne
24. and authorization data between security domains XML Schema Web Services Description Language Web Services Description Language is an XML format for describing network services as a set of endpoints operating on messages containing either document oriented or procedure oriented information XML Schema XML Schema is a means for defining the structure content and semantics of XML documents Glossary 3 XML Schema Glossary 4 A acronyms F 1 C configuring CONNECT HTB 3 5 OHIM Health Record Locator 3 1 OHMPI 3 2 Oracle registry B 1 Oracle repository B 3 E examples for setting up CONNECT D 1 exchanging certificates 2 5 N network GlassFish 2 4 WebLogic 2 5 P prerequisite common 2 1 testing 2 4 WebLogic 2 2 R references E 1 requirements downloading 1 2 hardware 1 1 software 1 1 running installer adapter A 1 GlassFish A 1 WebLogic A 3 gateway A 4 GlassFish A 4 WebLogic A 6 V Index validating OHIG CONNECT SoapUI 2 7 Uinversal client 2 7 Index 1 Index 2
25. ct adapter host Enter connectadapter_host localhost Connect adapter http port Enter connectadapter_http_port 7001 Connect adapter https port Enter connectadapter_https_port 7002 Connect home community id Enter connect_home_community_id 1 1 Connect home community name Enter connect_home_community_name 1 1 Connect assigning authority id Enter connect_assigning_authority_id 1 1 gt Stop weblogic Choose option stop_weblogic yes no gt no A 2 Oracle Health Sciences Information Gateway CONNECT Gateway Note For the connectadapter_host or connectgateway_host properties ensure that you provide a valid host name instead of localhost to avoid certificate exceptions A 2 1 GlassFish A 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Oracle Health Sciences Information Gateway CONNECT Gateway cd lt install_dir gt java jar ohig connect installer jar Oracle HIG Connect Installer 2 0 1 0 Feature Choose option install_feature connect connectadapter connectgateway gt connectgateway Target Choose option install_target glassfish weblogic gt glassfish Command Choose option install_command usage version install gt install Glassfish install directory Enter glassfish_install_dir null gt home hiauser SUNWappserver Glassfish domain name Enter glassfish domain name domainl
26. e firewall settings For more information on updating firewall settings refer to Setting up the Network on page 2 4 2 Exchange certificates between gateway and adapter machines For more information on exchanging information refer to Exchanging Certificates on page 2 5 3 Load sample documents cd lt install_dir gt addons connect oracle_db sqlplus SQL Plus Release 11 1 0 6 0 Production on Thu Jul 19 12 34 18 2012 Enter user name sys as sysdba Enter password SQL gt DROP TABLE nhincuser document Table dropped SQL gt quit imp nhincuser nhincpass file populateTestData_oracle dmp log output log full yes Import terminated successfully without warnings 2 2 Setting up the Network This section provides information for the GlassFish network setup and the WebLogic network setup 2 2 1 Setting up the GlassFish Network Perform the following steps to setup the GlassFish network 1 Allow external connections to http port and SSL http port by opening incoming ports cd etc sysconfig vi iptables 2 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Exchanging Certificates Add the following lines A RH Firewall 1 INPUT m state state NEW m tcp p tcp dport 8080 j ACCEPT A RH Firewall 1 INPUT m state state NEW m tcp p tcp dport 8181 j ACCEPT Restart the service service iptables restart Flushing firewall rules OK 2 2 2 Setting up t
27. ectadapter_https_port 8181 Pe Connect gateway host Enter connectgateway_host localhost a Connect gateway http port Enter connectgateway_http_port 8080 Connect gateway https port Enter connectgateway_https_port 8181 Connect home community id Enter connect_home_community_id 1 1 Connect home community name Enter connect_home_community_name 1 1 Connect assigning authority id Enter connect_assigning_authority_id 1 1 Stop glassfish Choose option stop_glassfish yes no gt no A 2 2 WebLogic cd lt install_dir gt java jar ohig_connect_installer jar Oracle HIG Connect Installer 2 0 1 0 Feature Choose option install_feature connect connectadapter connectgateway gt connectgateway Target Choose option install_target glassfish weblogic gt weblogic Command Choose option install_command usage version install gt install Start weblogic Choose option start_weblogic yes no gt no Weblogic install directory Enter weblogic_install_dir null gt home hiauser Oracle Middleware Weblogic jdk directory Enter weblogic_jdk_dir home common java jdk1 7 0 based on install_java_ home Pe Weblogic server name Enter weblogic_server_name AdminServer gt A 6 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Oracle Health Sciences Information Gateway CONNECT Gateway Weblogic d
28. eware wlserver_ 10 3 server lib DemoTrustChangeit jks Custom Trust Keystore Type JKS Custom Trust Keystore Passphrase changeit Under the Configuration SSL tab enter the following values in the respective fields Private Key Location from Custom Identity Keystore Private Key Alias demoidentity Private Key Passphrase changeit Certificate Location from Custom Identity Keystore Trusted Certificate Authorities from Custom Trust Keystore Under the Advanced tab enter the following values in the respective fields Select Hostname Verification None Note This setting is not recommended for the production environment Install shared libraries jsf 1 2 war jstl 1 1 2 war Shared libraries can be found in home hiauser Oracle Middleware wlserver_ 10 3 common deployable libraries Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 3 Setting up the Network Note The following is required for OHIG CONNECT Universal Client GUI jsf 1 2 war jstl 1 1 2 war 3 Edit WebLogic installation information Note This script should be used to start WebLogic before and after deploying OHIG CONNECT cd lt install_dir gt addons connect scripts vi connect start weblogic sh 4 Use the OHIG CONNECT WebLogic Start Script sh connect start weblogic sh 2 1 3 Prerequisites for Testing Oracle Health Sciences Information Gateway CONNECT 1 Updat
29. figuration Guide Oracle Health Sciences Information Manager Policy Monitor Installation and Configuration Guide Oracle Health Sciences Information Manager Health Record Locator User Guide Oracle Health Sciences Information Manager Security Guide Oracle Health Sciences Information Manager Release Notes Oracle Healthcare Master Person Index Conventions The following text conventions are used in this document viii Oracle Healthcare Master Person Index Australia Patient Solution User s Guide Oracle Healthcare Master Person Index United States Patient Solution User s Guide Oracle Healthcare Master Person Index United Kingdom Patient Solution User s Guide Oracle Healthcare Master Person Index Provider Index User s Guide Oracle Healthcare Master Person Index User s Guide Oracle Healthcare Master Person Index Installation Guide Oracle Healthcare Master Person Index Working With IHE Profiles LIser s Guide Oracle Healthcare Master Person Index Analyzing and Cleansing Data 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 Standardization Engine Reference Oracle Healthcare Master Person Index Configuration Reference Oracle Healthcare Master Person Index WebLogic User s Guide Oracle Healthcare Master Person Index Command Line Reports and Database Maintenance User s Guide Oracle Healthcare Master Person I
30. gt Glassfish copy ojdbc jar to domain lib ext Choose option glassfish_copy_ojdbc_jar_to_domain_lib_ext gt Start glassfish Choose option start_glassfish yes no gt no Glassfish admin username Enter glassfish_admin_username admin gt Glassfish admin password Enter glassfish_admin_password adminadmin i Glassfish master password Enter glassfish_master_password changeit gt Glassfish admin port Enter glassfish_admin_port 4848 2 Glassfish jvm option Xms Enter glassfish_jvm_option_xms 512m gt Glassfish jvm option Xmx Enter glassfish_jvm_option_xmx 1024m gt Glassfish jvm option XX MaxPermSize Enter glassfish_jvm_option_max_perm_size 256m 2 Connect database host Enter connect_db_host localhost gt hiadevdb Connect database port Enter connect_db_port 1521 gt Connect database sid Enter connect db sid orcl gt Connect database nhinc username Enter connect_db_nhinc_username nhincuser gt Connect database nhinc password Enter connect_db_nhinc_password nhincpass gt Running Oracle Health Sciences Information Gateway CONNECT Installer yes no A 5 Oracle Health Sciences Information Gateway CONNECT Gateway Connect adapter host Enter connectadapter_host localhost a Connect adapter http port Enter connectadapter_http_port 8080 gt Connect adapter https port Enter conn
31. he WebLogic Network Perform the following steps to setup the WebLogic network 1 Allow external connections to http port and SSL http port by opening incoming ports cd etc sysconfig vi iptables Add the following lines A RH Firewall 1 INPUT m state state NEW m tcp p tcp dport 7001 j ACCEPT A RH Firewall 1 INPUT m state state NEW m tcp p tcp dport 7002 j ACCEPT Restart the service service iptables restart Flushing firewall rules OK 2 3 Exchanging Certificates 2 3 1 Exchanging GlassFish Certificates Perform the following steps to exchange GlassFish certificates Example Environment Variables JAVA_HOME home common java jdk1 7 0 ANT_HOME home common ant apache ant 1 8 2 AS_HOME home hiauser SUNWappserver JAVA_VENDOR Sun AS_SERVER_DIR SAS_HOME AS_DOMAIN_DIR AS_HOME domains domainl Export the demo identity certificate keytool export keystore AS_DOMAIN_DIR config identity jks storepass changeit alias identity file lt machinel_host_name gt cer Copy the demo identity certificate remotely scp rp lt machinel_host_name gt cer hiauser lt machine2_host_ Setting Up Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 5 Exchanging Certificates name gt home hiauser downloads certs 3 Copy the trusted identity certificate locally scp hiauser lt machine2_host_ name gt home hiauser SUNWappserver domains domainl config lt machi
32. hould match with the cert file you copied to the config folder without cer suffix gt bash import others cert sh C 3 Avoiding a Java Security Certificate Exception To avoid a java security cert CertificateException you must ensure that your OHIM host names are not fully qualified To Make the Hostname Not Fully Qualified 1 Set the OHIM and OHIG host names to be not fully qualified C 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Avoiding a Java Security Certificate Exception Sh oe ON Add aliases for all hosts Regenerate and reimport the certificates Restart all the servers Test that you do not have a Java security certificate exception Creating and Importing Certificates Using the GlassFish Self Signed Certificate Scripts C 3 Avoiding a Java Security Certificate Exception C 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide D Examples for Setting up Oracle Health Sciences Information Gateway CONNECT This appendix contains the following topics a Environment Settings on page D 1 Creating and Importing a Self Signed Certificate on page D 3 D 1 Environment Settings D 1 1 Example GlassFish Directories GlassFish Home home hiauser SUNWappserver GlassFish Domain Directory home hiauser SUNWappserver domains domainl GlassFish NHIN Config Directory home hiauser SUNWappserver domains domain1l c
33. id Enter connect_home_community_id 1 1 gt Connect home community name Running Oracle Health Sciences Information Gateway CONNECT Installer A 7 Oracle Health Sciences Information Gateway CONNECT Gateway Enter connect_home_community_name 1 1 gt Connect assigning authority id Enter connect_assigning_authority_id 1 1 gt Stop weblogic Choose option stop_weblogic yes no gt no A 8 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Configuring Oracle CONNECT Adapters with Oracle Components This appendix contains the following topics Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry on page B 1 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Healthcare Master Person Index on page B 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository on page B 3 B 1 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry 1 Log into the OHIG adapter 2 Edit the file lt config_nhin_dir gt internalConnectionInfo xml GlassFish example lt glassfish_install_dir gt domains lt domain_ name gt config nhin internalConnectionInfo xml WebLogic example lt weblogic_install_dir gt user_projects domains lt domain_ name gt config nhin internalConnectionInfo xml 3 Edit or create the bu
34. ity NHIE Nationwide Health Information Exchange NHIN Nationwide Health Information Network NHIO Nationwide Health Information Organization Acronyms Acronyms F 1 Acronyms OHIG Oracle Health Sciences Information Gateway OHIM Oracle Health Sciences Information Manager SAML Security Assertion Markup Language VM Oracle Virtual Machine WSDL Web Service Definition Language XDM Cross Enterprise Document Media Interchange F 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Glossary This section provides definitions of commonly used words CONNECT Is a software solution that supports health information exchange that implements Nationwide Health Information Network NHIN standards and governance to make sure that health information exchanges are compatible with other exchanges being set up throughout the country It enables public and private organizations to participate in the NHIN by leveraging their existing health information systems CONNECT Adapter The portion of the CONNECT architecture that encapsulates the components most likely to be customized or replaced by an organization implementing CONNECT CONNECT Gateway The portion of the CONNECT architecture that encapsulates the components most likely to be use as is by an organization without modification These components are primarily responsible for orchestrating information exchange with the NHIN
35. le Health Sciences Information Gateway CONNECT 2 1 2 1 2 Prerequisites for WebLogic Oracle Health Sciences Information Gateway CONNECT Install 2 2 2 1 2 1 Setting up Java Secure Socket Extension JSSE Compatible Demo Trust and Identity Keystores 2 2 2 1 3 Prerequisites for Testing Oracle Health Sciences Information Gateway CONNECT 2 4 2 2 Setting up the Networks eeste Be KEER Re Ee eedeatbicbee viet a Ses ve Begeer oer 2 4 2 2 1 Setting up the GlassFish Network iese sesse se cece Ge ee ge He Gee He He Gee ee He He ee eke ee 2 4 2 2 2 Setting up the WebLogic Network see se se se ee ge He Ge ee ge He Gee Re He He ee Ee He He ee Ee eke 2 5 2 3 Exchanging EerHilca tesis eis More Louse tet e Reese ER ese generation E ede ge eer Gegee 2 5 2 3 1 Exchanging GlassFish Certificates sesse se ee se eke Ge Ge SR Re Ge Ge RR Ge SR Re Ge Gee Re He Ge Gee 2 5 2 3 2 Exchanging WebLogic Certificates sesse see se ek eek SR SR Rek Ge Re Ge GR ER Re Ge Ge Se RR ee Ge se 2 6 2 4 Installing Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 2 7 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client 2 7 2 6 Validating Oracle Health Sciences Information Gateway CONNECT using Soap UI Validation Suite 2 7 2 6 1 Running Validation Suite Test ese see se se se Gee ce ceceeseseececeseesnesesecssesenesesesesenesesesenees 2 7 3 Configuring the Oracle Health Sciences Information Gateway CONNECT Gateway a
36. n Gateway CONNECT Adapter with A Oracle Repository 3 6 Running Oracle Health Sciences Information Gateway CONNECT Installer A 1 Oracle Health Sciences Information Gateway CONNECT Adapter esse se sesse sees ese A 1 A 1 1 et at OR DE OE EE Sb T A 1 A 1 2 WeebiOg te suide es Ai be ania veeraa an vaa eie nina betaine tie A 3 A 2 Oracle Health Sciences Information Gateway CONNECT Gateway e ese sesse sesse ese se see A 4 A 2 1 GlassFish mietin ea e Eate ches ton cht ely tates tole A EE R A 4 A 2 2 WebLogic AE RE ee Secs Sneek Sasso cas sree Tas sat ce ER the EDE EE SEDES A 6 B Configuring Oracle CONNECT Adapters with Oracle Components B 1 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry B 1 B 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Healthcare Master Person Index B 2 B 3 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository B 3 C Creating and Importing Certificates Using the GlassFish Self Signed Certificate Scripts C 1 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Adapter C 1 C 2 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Gateway C 2 C 3 Avoiding a Java Security Certificate Exception ccc be ee He He bee He He ee C 2 D Examples for Setting up Oracle Health Sciences Information Gateway CONNECT D
37. nd Adapter 3 1 Configuring the Adapter with Oracle Health Sciences Information Manager Health Record Locator 3 1 3 1 1 Installing Certificates vivid sesse EE ee ee Ane sg Qiu teats Pi see ees i ee Ee 3 1 3 1 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry 3 2 3 1 3 Setting Up Components see Ee See EES Ge snan Re ges EED ee ek Ee Renaa iS Enea iene 3 2 3 1 3 1 Loading Test Data in Oracle Health Sciences Information Manager Health Record Locator s Oracle Database 3 2 3 1 4 Validating Adapter Configuration with Oracle Health Sciences Information Manager Health Record Locator 3 2 3 2 Configuring the Adapter with Oracle Healthcare Master Person Index sesse sees 3 2 3 2 1 Installing Certificates wii verse ee Been ge ee BEDR GARS ERA ek cea skin a ba e r S EEEE 3 3 3 2 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Master Person Index 3 3 3 2 3 Setting Up Components is mssins Ne ie Dees es ee N re Ge otek en ees geed Ee Ge N ee EG ee 3 3 3 2 3 1 Creating Oracle Health Sciences Information Gateway CONNECT Test Patients 3 3 3 2 4 Validating Adapter Configuration with Oracle Healthcare Master Person Index 3 5 3 3 Configuring the Adapter with Oracle Health Sciences Transaction Database 3 5 3 3 1 installing Certificates fcc e Sek ee EE Roe Rek Re EER Rae shot Ede Gees BE Ee ee 3 6 3 3 2 Configuring Oracle Health Sciences Informatio
38. ndex Loading the Initial Data Set User s Guide Oracle Healthcare Master Person Index Match Engine Reference Oracle Healthcare Master Person Index Message Processing Reference 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 Getting Started This chapter describes the minimum hardware and software requirements for installing Oracle Health Sciences Information Gateway OHIG CONNECT This chapter includes the following sections Hardware Requirements on page 1 1 Software Requirements on page 1 1 Downloading Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter on page 1 2 1 1 Hardware Requirements The following are the hardware requirements for installing OHIG CONNECT Gateway and Adapter 4 GB 4096 MB of RAM 12 GB of Disk Space 16 GB of disk space for 64 bit 1 2 Software Requirements The following are the software requirements for installing OHIG CONNECT Gateway and Adapter Java 1 7 executable in path Oracle Database 10 11g Release 1 GlassFish Enterprise Server 2 1 1 Patch 16 or higher WebLogic Server 10 3 6 0 11g Release 1 Oracle
39. ne2_host_ name gt cer 4 Import the trusted identity certificate keytool import keystore AS_DOMAIN_DIR config cacerts jks storepass changeit alias lt machine2_host_name gt file lt machine2_host_name gt cer trustcacertsTrust this certificate no yes 5 List the truststore keytool list keystore AS_DOMAIN_DIR config cacerts jks storepass changeit y 2 3 2 Exchanging WebLogic Certificates Perform the following steps to exchange WebLogic certificates Example Environment Variables MW_HOME home hiauser Oracle Middleware JAVA_HOME home common java jdk1 7 0 JAVA_VENDOR Sun WL_SERVER_DIR MW_HOME wlserver_10 3 WL_DOMAIN_DIR MW_HOME user_projects domains domain1 1 Export the demo identity certificate keytool export keystore WL SERVER DIR server lib DemoldentityChangeit jks storepass changeit alias demoidentity file lt machinel_host_name gt cer 2 Copy the demo identity certificate remotely scp rp lt machinel_host_name gt cer hiauser lt machine2_host_ name gt home hiauser downloads certs 3 Copy the trusted identity certificate locally scp hiauser lt machine2_host_name gt home hiauser Oracle Middleware wlserver_ 10 3 server 1lib lt machine2_host_name gt cer 4 Import the trusted identity certificate keytool import keystore WL SERVER DIR server lib DemoTrustChangeit jks storepass changeit alias smachine2 host name file smachine2 host name
40. omain name Enter weblogic_domain_name domain1 gt Weblogic domain directory Enter weblogic_domain_dir home hiauser Oracle Middleware user_ projects domains domainl based on weblogic_install_dir user_ projects domains weblogic_domain_name 2 Weblogic admin username Enter weblogic_admin_username weblogic gt Weblogic admin password Enter weblogic_admin_password welcome1 gt Weblogic admin protocol Enter weblogic_admin_protocol t3 gt Weblogic host Enter weblogic_host localhost gt Weblogic admin port Enter weblogic_admin_port 7001 2 Connect database host Enter connect_db_host localhost gt hiadevdb Connect database port Enter connect_db_port 1521 gt Connect database sid Enter connect db sid orcl gt Connect database nhinc username Enter connect_db_nhinc_username nhincuser gt Connect database nhinc password Enter connect_db_nhinc_password nhincpass gt Connect gateway host Enter connectgateway_host localhost ee Connect gateway http port Enter connectgateway_http_port 7001 gt Connect gateway https port Enter connectgateway_https_port 7002 gt Connect adapter host Enter connectadapter_host localhost gt Connect adapter http port Enter connectadapter_http_port 7001 gt Connect adapter https port Enter connectadapter_https_port 7002 gt Connect home community
41. onfig nhin Log Directory home hiauser SUNWappserver domains domainl logs GlassFish Bin Directory home hiauser SUNWappserver bin D 1 2 Example GlassFish Commands Environment Variables AS_HOME home hiauser SUNWappserver JAVA_HOME home common java jdk1 7 0 JAVA_VENDOR Sun cd home hiauser SUNWappserver bin asadmin start domain domainl asadmin stop domain domainl Examples for Setting up Oracle Health Sciences Information Gateway CONNECT D 1 Environment Settings D 1 3 Example WebLogic Directories WebLogic Home home hiauser Oracle Middleware WebLogic Server Directory home hiauser Oracle Middleware wlserver 10 3 WebLogic Domain Directory home hiauser Oracle Middleware user_projects domains domainl WebLogic NHIN Config Directory home hiauser Oracle Middleware user_projects domains domainl config nhin Demo Certificate Directory home hiauser Oracle Middleware wlserver 10 3 server lib Log Directory home hiauser Oracle Middleware user_ projects domains domainl servers AdminServer logs WebLogic Bin Directory home hiauser Oracle Middleware user_projects domains domainl bin D 1 4 Example WebLogic Commands Environment Variables MW_HOME home hiauser Oracle Middleware JAVA_HOME home common java jdk1 7 0 JAVA_VENDOR Sun cd home hiauser Oracle Middleware user projects domains domainl bin startWebLogic sh stopWebLogic sh D 1 5 Example GlassFish home hiauser bashrc ba
42. ormation exchange activities within their organizations or with other organizations 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 amp 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 amp id info or visit http www oracle com pls topic lookup ctx acc amp id trs if you are hearing impaired Related Documents For more information see the following documentation sets Oracle Health Sciences Information Gateway a Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter Installation and Configuration Guide a Oracle Health Sciences Information Gateway Cross Community Access Installation and Configuration Guide a Oracle Health Sciences Information Gateway Cross Community Access User Guide a Oracle Health Sciences Information Gateway Secure Health Email Installation and Configuration Guide a Oracle Health Sciences Information Gateway Security Guide vii Oracle Health Sciences Information Gateway Release Notes Oracle Health Sciences Information Manager Oracle Health Sciences Information Manager Health Record Locator Installation and Configuration Guide Oracle Health Sciences Information Manager Policy Engine Installation and Con
43. rComponentMpiService lt accessPoint gt 4 Edit or create the business service adaptercomponentmpisecuredservice Change the lt accessPoint gt from lt accessPoint useType endPoint gt https lt adapter_host_ ip gt 8181 Adapter PatientDiscovery A_ 0 AdapterComponentMpiSecuredService lt accessPoint gt to lt accessPoint useType endPoint gt https lt adapter_host_ ip gt 8181 AdapterComponent IheMpi AdapterComponentMpiSecuredService lt accessPoint gt 5 Edit the file lt config_nhin_dir gt AdapterComponentIheMpiConfig properties and edit or create the following property ihempi pdq v3 endpoint url http lt oracle_mpi_host_ip gt 8080 PDQSupplier_ Service PDQSupplier 6 Restart the application server B 3 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository 1 Log into the OHIG adapter 2 Edit the file lt config_nhin_dir gt internalConnectionInfo xml GlassFish example lt glassfish_install_dir gt domains lt domain_ name gt config nhin internalConnectionInfo xml WebLogic example lt weblogic_install_dir gt user_projects domains lt domain_ name gt config nhin internalConnectionInfo xml 3 Edit or create the business service adapterxdsbdocrepositorysoap12retrieve Ensure lt accessPoint gt is defined as lt accessPoint useType endPoint gt https lt oracle_repository_host_ ip gt 7778 XDS xdsrepositoryb_Soap12 lt accessPoint gt lt categoryBag
44. re Master Person Index 3 2 1 Installing Certificates Log in to the adapter host If not done already create and import the certificate for the adapter host in to your application server s keystore For details refer to the following GlassFish or Weblogic application server documentation Sun GlassFish Enterprise Server v2 1 1 http docs oracle com cd E19879 01 index html Oracle Fusion Middleware Securing Oracle WebLogic Server http docs oracle com cd E23943_01 web 1111 e13707 toc htm Import the OHIM Health Record Location host s certificate or its CA s certification into your adapter application server s truststore Log in to the OHIM Health Record Locator host If not done already import the OHIM Health Record Locator s certificate into your application server s keystore Import the OHIG adapter host s certificate or its CA s certification into your OHIM Health Record Locator application server s truststore 3 2 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Master Person Index For information on configuring OHIG CONNECT Adapter with Oracle MPI refer to Section B 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Healthcare Master Person Index in Appendix B Configuring Oracle CONNECT Adapters with Oracle Components 3 2 3 Setting up Components 3 2 3 1 Creating Oracle Health Sciences Information Gateway CONNECT Test Patients Note
45. ring the Adapter with Oracle Health Sciences Transaction Database This section describes how to configure the adapter to connect to the Oracle Health Sciences Health Transaction Database HTB instead of the internal test document repository Configuring the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 3 5 Configuring the Adapter with Oracle Health Sciences Transaction Database Prerequisite Configuration and validation specified in Section 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 are completed successfully 3 3 1 Installing Certificates 1 Log in to the adapter host If not done already create and import the certificate for the adapter host in to your application server s keystore Refer to the GlassFish or Weblogic application server documentation for details Sun GlassFish Enterprise Server v2 1 1 http docs oracle com cd E19879 01 index html Oracle Fusion Middleware Securing Oracle WebLogic Server http docs oracle com cd E23943_01 web 1111 e13707 toc htm 2 Also import the HTB host s certificate or its CA s certification into your adapter application server s truststore 3 Log in to the HTB host If not done already import the OHIM Health Record Locator s certificate into your application server s keystore 4 Import the OHIG adapter host s certificate or its CA s certification into your HTB application server s trusts
46. s 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
47. shre Source global definitions if f etc bashrc J then etc bashre User specific aliases and functions umask 027 User specific environment and startup programs JAVA_HOME home common java jdk1 7 0 ANT_HOME home common ant apache ant 1 8 2 AS_HOME home hiauser SUNWappserver JAVA_VENDOR Sun D 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Creating and Importing a Self Signed Certificate AS_SERVER_DIR SAS_HOME AS_DOMAIN_DIR AS_HOME domains domainl PATH SJAVA_HOME bin PATH SHOME bin sbin AS_HOME bin ANT_HOME bin export PATH JAVA_HOME ANT_HOME AS_HOME AS_SERVER_DIR AS_DOMAIN_DIR alias start sh home hiauser SUNWappserver bin asadmin start domain domainl alias stop sh home hiauser SUNWappserver bin asadmin stop domain domainl alias log tail f home hiauser SUNWappserver domains domainl logs server log D 1 6 Example WebLogic home hiauser bashrc bashre Source global definitions if f etc bashrc J then etc bashrc User specific aliases and functions umask 027 User specific environment and startup programs JAVA_HOME home common java jdk1 7 0 ANT_HOME home common ant apache ant 1 8 2 MW_HOME home hiauser Oracle Middleware JAVA_VENDOR Sun WL SERVER DIR MW HOME wlserver 10 3 WL DOMAIN DIR MW HOME user projects domains domainl PATH S JAVA_HOME bin PATH SHOME bin sbin MW_HOME bin SANT_HOME bin
48. siness service adapterxdsbdocregistrysoap12 Ensure lt accessPoint gt is defined as lt accessPoint useType endPoint gt http lt oracle_registry_host_ ip gt 8080 hr1 regsvc lt accessPoint gt lt categoryBag gt lt keyedReference tModelKey uddi nhin versionofservice keyName keyValue 1 0 gt lt keyedReference tModelKey CONNECT adapter apilevel keyName keyValue LEVEL_a0 gt lt categoryBag gt Configuring Oracle CONNECT Adapters with Oracle Components B 1 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Healthcare Master Person Index Note If you have selected non default home community ID other than 1 1 for the HIG installation ensure that you provide an appropriate value for the businessKey attribute of the businessService element For example if you have selected home community ID as 4 4 the businessKey value should be set to uddi testnhieonenode 4 4 4 Edit or create the business service adapterxdsbdocregistry Change to the lt accessPoint gt from lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 CONNECTAdapter DocumentRegistry_Service lt accessPoint gt to lt accessPoint useType endPoint gt http lt adapter_host_ ip gt 8080 CONNECTAdapterDocRegSoap12 AdapterDocRegistry2Soap12Service lt accessPoi nt gt lt categoryBag gt lt keyedReference tModelKey uddi nhin versionofservice keyName keyValue 1 0
49. stem SelfTest System 1 LocalID D123409 FirstName Audrey LastName Kim SSN 999 99 9999 Gender Female Date of Birth 03 14 1980 Address Type street address line Address Linel 14701 Demming Drive City Gainsville State Code VA Postal Code 20155 System SelfTest System 1 LocalID D123402 FirstName Anna LastName Schnur SSN 999 99 9999 Gender Female Date of Birth 08 13 1956 Address Type street address line Address Linel 312 HILL ROAD City HILLSBRO State Code MO Postal Code 37660 4 Note that the EUID returned on each of the above patients and update the PatientIDs in the NHINC and HRL databases by following the instructions below 3 4 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Configuring the Adapter with Oracle Health Sciences Transaction Database Updating the NHINC Database with New Patient IDs 1 2 Log into OHIG Adapter host Copy the file from lt install_dir gt addons adapter ohmpi ohmpi_nhinc_db tgz to the host where you have an SQL Plus client present in the PATH and Bash or Sh shell is available Extract the contents for example tar zxvf ohmpi_nhinc_ db tgz Update script nhinc3_upd_nhinc_patients sh with variable oracleDBScriptsDir pointing to the path where the above file was extracted Run the script nhinc3_upd_nhinc_patients sh gt bash nhinc3_upd_nhinc_patients sh The script will prompt for the OHIG Oracle da
50. tabase host port SID and NHINCUSER database user password When prompted enter new patient IDs for the patients D123401 Gallow Younger D123407 Jordy LaForge D123409 Audrey Kim and D123402 AnnaSchnur Updating the HRL Database with New Patient IDs 1 2 Log in to OHIG Adapter host Copy the file from lt install_dir gt addons adapter ohmpi ohmpi_rls_db tgz to the host where you have an SQL Plus client present in the PATH and Bash or Sh shell is available Extract the contents for example tar zxvf hiall_ohmpi_rls_ db tgz Update script nhinc3_upd_rls_patients sh with variable oracleDBScriptsDir pointing to the path where the above file was extracted Run the script nhinc3_upd_rls_patients sh gt bash nhinc3_upd_rls_patients sh The script will prompt for the OHIG Oracle database host port SID and ADT and HRLCORE database users passwords When prompted enter new patient IDs for the patients D123401 Gallow Younger D123407 Jordy LaForge D123409 Audrey Kim and D123402 AnnaSchnur 3 2 4 Validating Adapter Configuration with Oracle Healthcare Master Person Index Perform the steps specified in Section 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 to validate the adapter s configuration with OHMPI Apart from the Universal Client user interface observe OHMPI logs during these steps to confirm that the adapter is configured to connect to OHMPI 3 3 Configu
51. teps to install self signed certificates on the OHIG CONNECT adapter 1 2 Log in to the adapter machine Stop the application server using the following commands a gt cd lt glassfish_install_dir gt bin b gt asadmin stop domain lt domain_name gt Navigate to the directory lt install_dir gt addons connect scripts using the following command gt cd lt install_dir gt addons connect scripts Execute create and import selfsigned certs sh to install the self signed certificate gt sh create and import selfsigned certs sh This performs the following creates the keystore for the private internal key a exports the certificate that will authenticate the internal key imports the trusted certificates into the truststore provides these certificates to the server to use for authentication purposes Install the certificates from the other components that will communicate with the Adapter Gateway OHMPI HPE HPM HRL HTB and so on Creating and Importing Certificates Using the GlassFish Self Signed Certificate Scripts C 1 Installing Self signed Certificates on Oracle Health Sciences Information Gateway CONNECT Gateway Copy the certificate of the component machine lt COMPONENT_HOSTNAME cer gt to the lt glassfish_install_dir gt domains lt domain_name gt config folder Navigate to and execute lt install_ dir gt addons connect scripts import others cert sh When prompted by the scripts enter
52. ting systems and application software within a supported virtualization environment Oracle Virtual Machine Manager Oracle Virtual Machine Manager provides the user interface which is a standard ADF Application Development Framework web application to manage Oracle VM Servers It manages virtual machine lifecycle including creating virtual machines from installation media or from a virtual machine template deleting powering off uploading deployment and live migration of virtual machines It manages resources including ISO files virtual machine templates and sharable hard disks Oracle Virtual Machine Server Oracle Virtual Machine Server allows a self contained virtualization environment designed to provide a lightweight secure server based platform for running virtual machines Oracle VM Server is based upon an updated version of the underlying Xen hypervisor technology and includes Oracle VM Agent Oracle Virtual Machine Template Oracle Virtual Machine Template provides an innovative approach to deploying a fully configured software stack by offering pre installed and pre configured software images Use of Oracle VM templates eliminates the installation and configuration costs and reduces the ongoing maintenance costs helping organizations achieve faster time to market and lower cost of operations Security Assertion Markup Language Security Assertion Markup Language is an XML based standard for exchanging authentication
53. tore 3 3 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Repository For information on configuring OHIG CONNECT Adapter with Oracle repository refer to Section 3 3 Configuring the Adapter with Oracle Health Sciences Transaction Database in Appendix B Configuring Oracle CONNECT Adapters with Oracle Components 3 6 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide A Running Oracle Health Sciences Information Gateway CONNECT Installer This appendix describes how to run the OHIG CONNECT installer It contains the following topics a Oracle Health Sciences Information Gateway CONNECT Adapter on page A 1 Oracle Health Sciences Information Gateway CONNECT Gateway on page A 4 A 1 Oracle Health Sciences Information Gateway CONNECT Adapter Note For the connectadapter_host or connectgateway_host properties ensure that you provide a valid host name instead of localhost to avoid certificate exceptions A 1 1 GlassFish cd lt install_dir gt java jar ohig connect installer jar Oracle HIG Connect Installer 2 0 1 0 Feature Choose option install_feature connect connectadapter connectgateway gt connectadapter Target Choose option install_target glassfish weblogic gt glassfish Command Choose option install_command usage version install gt install Glassfish install directory Enter glassfish_install
54. usion Middleware Securing Oracle WebLogic Server http docs oracle com cd E23943 01 web 1111 e13707 toc htm Import the OHIM Health Record Location host s certificate or its CA s certification into your adapter application server s truststore Configuring the Oracle Health Sciences Information Gateway CONNECT Gateway and Adapter 3 1 Configuring the Adapter with Oracle Healthcare Master Person Index 3 Log in to the OHIM Health Record Locator host If not done already import the OHIM Health Record Locator s certificate into your application server s keystore 4 Import the OHIG adapter host s certificate or its CA s certification into your OHIM Health Record Locator application server s truststore 3 1 2 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry For information on configuring OHIG CONNECT Adapter with Oracle registry refer to Section B 1 Configuring Oracle Health Sciences Information Gateway CONNECT Adapter with Oracle Registry in Appendix B Configuring Oracle CONNECT Adapters with Oracle Components 3 1 3 Setting up Components 3 1 3 1 Loading Test Data in Oracle Health Sciences Information Manager Health Record Locator s Oracle Database To load test data into Health Record Locator s Oracle Database perform the following steps 1 Log in to the OHIG adapter host 2 Copy the file from lt install_dir gt addons adapter hr1 rls_oracle_db_ scripts zip to the host
55. where you have an SQL Plus client present in the PATH and Bash or Sh shell is available Extract the contents 3 Log in to the host having SQL Plus and change the directory to where you copied or extracted the files in the previous step 4 Ensure that SQL Plus is available in the PATH then run the script as follows gt bash loadTestData sh 5 When prompted enter information for the registry database host port SID ADT user password and HRLCORE user password 3 1 4 Validating Adapter Configuration with Oracle Health Sciences Information Manager Health Record Locator Perform the steps specified in Section 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 to validate the adapter s configuration with OHMPI Health Record Locator Apart from Universal Client UI observe HRL logs during these steps to confirm Adapter is configured to connect to HRL 3 2 Configuring the Adapter with Oracle Healthcare Master Person Index This section describes how to configure the adapter to connect to OHMPI instead of the internal test patient master person index Prerequisite Configuration and validation specified in Section 2 5 Validating Oracle Health Sciences Information Gateway CONNECT using Universal Client on page 2 7 are completed successfully 3 2 Oracle Health Sciences Information Gateway CONNECT Installation and Configuration Guide Configuring the Adapter with Oracle Healthca

Oracle Health Sciences Information Gateway CONNECT Gateway

Contents

Download Pdf Manuals

Related Search

Related Contents