Oracle® Health Sciences Information Gateway Secure Health Email Installation and Configuration Guide Release 1.2 E22884-01 |
|
|
PDF · Mobi · ePub |
Oracle Health Sciences Information Gateway (OHIG) has implemented the National Health Information Network (NHIN) to provide a secure, scalable, standards-based method of sending authenticated and encrypted health information to known and trusted recipients over the internet. OHIG Secure Health Email interacts with Oracle Health Sciences Information Manager (HIM) services, such as Oracle Healthcare Master Person Index (OHMPI), Document Registry, Repository, Policy Engine, and Audit Record Repository (ARR).
This chapter includes the following sections:
The OHIG Secure Health Email template uses the "Paravirtualized" virtualization method. The template is distributed as a compressed tar file (*.tgz
). The 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 file is listed below:
Disk Image with Oracle Software
/appliance.img
Disk Image with Operating System
/System.img
VM Configuration File
/vm.cfg
The VM consists 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 Secure Health Email specific software (as in appliance.img
)
Apache Ant 1.8.1
Install directory: /home/common/ant
Java Development Kit 1.6.0_X
Install directory: /home/common/java/latest
(symbolic link to JDK 1.6.0_X)
Apache James Mail Server 2.3.2
Install directory: /home/common/james
(symbolic link to Apache James Mail Server 2.3.2)
For hiauser only:
OHIG Secure Health Email Ant Configuration Utility
Install directory: /home/hiauser/config
VM Memory Settings:
2 GB (2048 MB) of RAM
Note:
The RAM memory setting can be changed after installation in VM Manager.16 GB of Disk Space
Linux Users:
Root user
Username: root
Linux Group: root
Password: ovsroot
OHIG Secure Health Email specific user
Username: hiauser
Linux Group: hiauser
Password: hiapass
Tip:
For security purposes, it is recommended that you change the default passwords after installation.Copy the OHIG Secure Health Email VM template .tgz
file to the /OVS/seed_pool
directory of your Oracle VM Server machine.
Uncompress the .tgz
file:
> 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_EMAIL_PVM.tgz
Creates the directory:
/OVS/seed_pool/OVM_HIGV12_X86_EMAIL_PVM
Note:
If you are using 64 bits, you would useOVM_HIGV12_X86_64_EMAIL_PVM
.Log in to the Oracle VM Manager
Note:
The default location for the Oracle VM Manager log in screen ishttp://<VM_MANAGER_HOST_NAME>:8888/OVS
.From 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 Secure Health Email VM from the VM template:
Create a new VM using the OHIG Secure Health Email VM template 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").
To power on the Virtual Machine select the Virtual Machines tab, choose the Virtual Machine Name, and click Power On.
In the VM Manager Console ensure that the OHIG Secure Health Email VM is now in the running state (Status=Running).
This section provides instructions for configuring the OHIG Secure Health Email VM.
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 configure the VM to use static IP:
Note:
The VM is configured by default to use DHCP to assign an IP address.If you are using DHCP addressing you can skip the following steps.
To configure the VM to use static IP, log in as the root user (default password: ovsroot
) and set the IP using the following steps:
Select System, Administration, and then Network.
Choose Devices, click Edit, select 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.
Choose File and then click Save.
Click the DNS tab and then 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>
Choose Next and click Save.
Choose the Hosts tab, click New, and then enter the following values:
- Address: <VM_IP>
- Hostname: <VM_HOST_NAME>
- Aliases: <VM_NAME_PREFIX>
hostname
Click Okay.
Choose File and then click 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.