Oracle® Health Sciences Information Gateway Installation Guide Release 1.2 E22757-01 |
|
|
PDF · Mobi · ePub |
This chapter provides instructions for installing the OHIG Gateway and Adapter templates. It is assumed that you have previously installed the required technology described in Chapter 1, "Minimum Hardware and Software Requirements". Specifically, the Oracle Database, the Oracle VM Server, and the Oracle VM Manager.
This chapter includes the following sections:
The OHIG Gateway and Adapter VM templates use the “Paravirtualized“ virtualization method. Each template is distributed as a compressed tar file (*.tgz). Each compressed tar file contains two binary files and a text file. The binary files are the disk images taken from a fully configured and functional VM. The text file is a VM configuration file. The contents of the compressed tar files are listed below:
Disk Image with Oracle Software
/appliance.img
Disk Image with Operating System
/System.img
VM Configuration File
/vm.cfg
Gateway and Adapter VM Templates
The VMs consist of the following pre-installed software:
Oracle Enterprise Linux 5 (as in System.img)
http://www.oracle.com/technetwork/topics/linux/whatsnew/index.html
OHIG specific software (as in appliance.img)
Apache Ant 1.8.1
Install dir: /home/common/ant
Java Development Kit 1.6.0_21
Install dir: /home/common/java/latest (symbolic link to JDK 1.6.0_21)
For hiauser only:
OHIG Ant Configuration Utility
Install dir: /home/hiauser/config
Netbeans 6.7.1
Install dir: /home/hiauser/netbeans-6.7.1
Glassfish Enterprise Server 2.1.1
Install dir: /home/hiauser/SUNWappserver
Admin user
Username: admin
Password: adminadmin
Admin Console
http://<VM_IP or VM_HOST_NAME >:4848
VM Memory Settings:
2 GB (2048 MB) of RAM
Note:
The RAM memory setting can be changed after installation in VM Manager.12 GB of Disk Space
Linux Users:
Root user
Username: root
Linux Group: root
Password: ovsroot
OHIG specific user
Username: hiauser
Linux Group: hiauser
Password: hiapass
Tip:
For security purposes, it is recommended that you change the default passwords after installation.To download the Gateway and Adapter templates:
Navigate to http://edelivery.oracle.com/linux
.
Enter your Registration information, accept the Agreement Terms by checking the checkboxes, then click Continue.
Select Oracle VM from the Select a Product Pack drop-down menu.
Select x86 32 bit from the "Platform" drop-down menu.
Click Go.
Click the Oracle Health Sciences Information Gateway 1.2 Media Pack link for Linux x86 or Linux x86-64.
Click the Download button for the following:
Oracle HIG 1.2 Gateway Template 32-bit
Oracle HIG 1.2 Adapter Template 32-bit
or
Oracle HIG 1.2 Gateway Template 64-bit
Oracle HIG 1.2 Adapter Template 64-bit
Save the files to your system.
Unzip the files to view the Installation Guide and to get the compressed tar file (*.tgz).
To import the OHIG Gateway and Adapter VM templates:
Copy the OHIG Gateway and Adapter VM template .tgz files to the /OVS/seed_pool directory of your Oracle VM Server machine.
Uncompress the .tgz files:
> tar –zxvf
<FILENAME>
.tgz
This step creates a directory with the name of the template.
Example:
> cd /OVS/seed_pool
> tar -zxvf /OVS/seed_pool/OVM_HIGV12_X86_GATEWAY_PVM.tgz
or
> tar -zxvf /OVS/seed_pool/OVM_HIGV12_X86_64_GATEWAY_PVM.tgz
Creates the directory:
/OVS/seed_pool/OVM_HIGV12_X86_GATEWAY_PVM
or
/OVS/seed_pool/OVM_HIGV12_X86_64_GATEWAY_PVM
Log in to the Oracle VM Manager.
Note:
The default location for the Oracle VM Manager log in screen is http://<VM_MANAGER_HOST_NAME>:8888/OVSFrom the Oracle VM Manager console:
Click the Resources tab. The Virtual Machine Templates screen is displayed.
Click the Import button. The Source screen is displayed.
Choose the Select from Server Pool (Discover and register) radio button.
Click Next. The General Information screen is displayed.
Enter or select the following general information:
The server pool on which the virtual machine will be located:
Server Pool Name: <SERVER_POOL_NAME>
The operating system of the Virtual Machine
Operating System: Oracle Enterprise Linux 5
The Oracle VM template to be imported
Virtual Machine Template Name: <VM_TEMPLATE_NAME>
The username used to log in to the Virtual Machine
Virtual Machine System Username: root
The password used to log in to the Virtual Machine
Virtual Machine System Password: ovsroot
Click Next. The Confirm Information screen is displayed.
Click Confirm. The Virtual Machine Template screen is displayed with a message to confirm the VM template has been imported.
Click the Resources tab to see the list of available VM templates.
To make the Virtual Machine template available for use, select the Virtual Machine template and click Approve, moving the VM template from the "Pending" state to the "Active" state.
The VM template is imported and ready for use in Oracle VM Manager.
To create the OHIG Gateway and Adapter VMs from VM templates:
Create a new VM using the Gateway and Adapter VM templates just installed by following the instructions in the VM Manager 2.2 User's Guide (refer to Section 6.3.1, "Creating Virtual Machine from a Template").
Note:
The Console Password entered as part of this step is the same as the VNC Password used by "How to VNC into a VM".To power on the Virtual Machine select the Virtual Machines tab, select the Virtual Machine Name, and click Power On.
In the VM Manager Console ensure that the Gateway VM and Adapter VM are now in the running state (Status=Running).
This section provides instructions for configuring the OHIG Gateway and Adapter VMs.
To VNC into a VM:
Note:
To enable the VNC Port link in the VM Manager follow the instructions in "Installing OVM Console" athttp://oss.oracle.com/oraclevm/manager/RPMS/README-console
.Expand the details of the VM by clicking the + on Show. You can VNC into the box from the VM Manager by clicking on the VNC Port link under the VM details or you can use a VNC client to log in using the address:
<VM_SERVER_HOST_NAME>:<VM_VNC_PORT>
To prepare the OHIG database tables for Oracle:
Copy the files under /home/hiauser/config/files/database/oracle to a machine with Oracle SQL*Plus installed.
To create the OHIG database tables and OHIG database user load the script /home/hiauser/config/files/database/oracle/nhincdb_oracle.sql into the database.
Example:
> sqlplus system@
<SID>
SQL> @nhincdb_oracle.sql
To delete the OHIG database tables and OHIG database user, load the script /home/hiauser/config/files/database/oracle/dropall_oracle.sql into the database.
Example:
> sqlplus system@
<SID>
SQL> @dropall_oracle.sql
To populate the OHIG database with test data, first drop the nhincuser.document table, then import the Oracle dump file /home/hiauser/config/files/database/oracle/populateTestData_oracle.dmp into the database.
Example:
> sqlplus system@
<SID>
SQL> DROP TABLE nhincuser.document;
> imp
<NHINCUSER>
/
<NHINCPASS>
file=populateTestData_oracle.dmp log=output.log full=yes
To prepare the OHIG database tables for MySQL:
Copy the files under /home/hiauser/config/files/database/mysql to a machine with MySQL Client installed.
To create the OHIG database tables and OHIG database user load the script /home/hiauser/config/files/database/mysql/nhincdb_mysql.sql into the database.
Example:
> mysql -u
<ROOTUSER>
-p
<ROOTPASS>
< nhincdb_mysql.sql
To delete the OHIG database tables and OHIG database user, load the script /home/hiauser/config/files/database/mysql/dropall_mysql.sql into the database.
Example:
> mysql -u
<ROOTUSER>
-p
<ROOTPASS>
< dropall_mysql.sql
To populate the OHIG database with test data, first drop the docrepository.document table, then load the script /home/hiauser/config/files/database/mysql/populateTestData_mysql.sql into the database.
Example:
> mysql -u
<NHINCUSER>
-p docrepository
mysql> DROP TABLE docrepository.document;
> mysql -u
<NHINCUSER>
-p
<NHINCPASS>
< populateTestData_mysql.sql
To configure the VMs to use static IPs:
Note:
The VMs are configured by default to use DHCP to assign IP addresses.If you are using DHCP addressing you can skip the following steps.
To configure the VMs to use static IPs, log in as the root user (default password: ovsroot) and set the IPs using the following steps:
Select System=>Administration=>Network
Click Devices, click Edit, click the Statically Set IP Address radio button, and then enter the following values:
Address: <VM_IP>
Subnet mask: <SUBNET_MASK>
Default Gateway address: <DEFAULT_GATEWAY_ADDRESS>
- From the Ethernet Device panel, select the Hardware Device tab, and then click the Probe button that corresponds to "Bind to MAC address".
This sets the correct MAC address for this machine.
Note:
Make certain that you a record the MAC address.Click OK.
Click File=>Save
Click the DNS tab and enter the following values:
Hostname: <VM_HOST_NAME>
Primary DNS: <PRIMARY_DNS>
Secondary DNS: <SECONDARY_DNS>
Tertiary DNS: <TERTIARY_DNS>
DNS search path: <VM_NAME_SUFFIX>
Click File=>Save
Click the Hosts tab, click New, and enter the following values:
Address: <VM_IP>
Hostname: <VM_HOST_NAME>
Aliases: <VM_NAME_PREFIX> hostname
Click OK.
Click File=>Save
Restart Network Services from a terminal window.
> service network restart
Check the output for <VM_IP>
> ifconfig
Check the output for <VM_HOST_NAME>
> hostname
Check the success of:
> ping
<VM_IP>
Check the success of:
> ping
<VM_HOST_NAME>
Note:
(Optional) In order to preserve the static IP address when the OVM is powered off, follow below steps, but only if the linevif = ['mac=AA:BB:CC:DD:AA:CC,bridge=xenbr0']
does not match what you have in the vm.cfg
file (see below).
Power off the Virtual Machine by selecting the Virtual Machines tab in the VM Manager, choose the Virtual Machine Name, and click Power Off.
Edit the vm.cfg
file that is found on the VM Server under /OVS/seed_pool/
<template_name> by replacing the line:
vif = ['bridge=xenbr0,type=netfront']
with the MAC corresponding to that virtual machine:
vif = ['mac=AA:BB:CC:DD:AA:CC,bridge=xenbr0']
where AA:BB:CC:DD:AA:CC
is the MAC corresponding to the created OVM noted above.
To configure the CONNECT software on the Gateway and Adapter VMs:
Log in to the VMs as hiauser (default password: hiapass).
Navigate to the directory: /home/hiauser/config.
Run the script create-config-properties.sh to create the properties file used to configure the CONNECT application.
Note:
You can runifconfig
on your VM to determine the ip address.Example:
> sh create-config-properties.sh
The dialect of your database installation:
Choose target database: oracle
The VM_IP address of your Adapter Virtual Machine
Enter adapter_host_ip: <ADAPTER_VM_IP>
The VM_IP address of your Gateway Virtual Machine
Enter gateway_host_ip: <GATEWAY_VM_IP>
The hostname of your Oracle Database
Enter oracle_host: <ORACLE_HOST>
The Oracle TNS Listener port of your Oracle Database
Enter oracle_port: <ORACLE_PORT>
The Oracle System ID (SID) of your Oracle Database
Enter oracle_sid: <ORACLE_SID>
Run the config-appserver.sh script to apply the properties file to the configuration of the CONNECT application.
Example:
> sh config-appserver.sh
To validate the CONNECT software on the OHIG Gateway and Adapter VMs:
Start the Application Server on both the Gateway and Adapter VMs using the following commands:
> cd /home/hiauser/SUNWAppserver/bin
> asadmin start-domain domain1
Validate the installation using the sample universal client distributed with the Gateway:
Launch the application by navigating to the following URL:
http://<GATEWAY_IP>:8080/UniversalClientGUI/
Search for patient with last name “Younger”.
If the installation is correct, this returns a page with the PatientId for the patient.
Click on the PatientId for additional details on the patient.
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.
Click on the document URL to retrieve the document.