Skip Headers
Oracle® Health Sciences Information Gateway Secure Health Email Installation and Configuration Guide
Release 1.2

E22884-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

1 Installing and Configuring OHIG Secure Health Email

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:

1.1 Understanding OHIG Secure Health Email Components and Templates

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.

1.1.1 OHIG Secure Health Email Components

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

1.1.2 OHIG Secure Health Email VM Template

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.

1.2 Importing the OHIG Secure Health Email Template

  1. Copy the OHIG Secure Health Email VM template .tgz file to the /OVS/seed_pool directory of your Oracle VM Server machine.

  2. 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 use OVM_HIGV12_X86_64_EMAIL_PVM.
  3. 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/OVS.
  4. From the Oracle VM Manager console:

    1. Click the Resources tab. The Virtual Machine Templates screen is displayed.

    2. Click the Import button. The Source screen is displayed.

    3. Choose the Select from Server Pool (Discover and register) radio button.

    4. 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

    5. Click Next. The Confirm Information screen is displayed.

    6. Click Confirm. The Virtual Machine Template screen is displayed with a message to confirm the VM template has been imported.

  5. Click the Resources tab to see the list of available VM templates.

  6. 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.

1.3 Creating the OHIG Secure Health Email VM

To create the OHIG Secure Health Email VM from the VM template:

  1. 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").

  2. To power on the Virtual Machine select the Virtual Machines tab, choose the Virtual Machine Name, and click Power On.

  3. In the VM Manager Console ensure that the OHIG Secure Health Email VM is now in the running state (Status=Running).

1.4 Configuring the OHIG Secure Health Email VM

This section provides instructions for configuring the OHIG Secure Health Email VM.

1.4.1 How to VNC into a VM

To VNC into a VM:

Note:

To enable the VNC Port link in the VM Manager follow the instructions in "Installing OVM Console" at http://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>

1.4.2 Configuring the VM Network Settings

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.

  1. 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:

    1. Select System, Administration, and then Network.

    2. 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.
    3. Click OK.

    4. Choose File and then click Save.

    5. 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>

    6. Choose Next and click Save.

    7. Choose the Hosts tab, click New, and then enter the following values:

      - Address: <VM_IP>

      - Hostname: <VM_HOST_NAME>

      - Aliases: <VM_NAME_PREFIX> hostname

    8. Click Okay.

    9. Choose File and then click Save.

    10. Restart Network Services from a terminal window.

      > service network restart

    11. Check the output for <VM_IP>.

      > ifconfig

    12. Check the output for <VM_HOST_NAME>.

      > hostname

    13. Check the success of:

      > ping <VM_IP>

    14. 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 line

vif = ['mac=AA:BB:CC:DD:AA:CC,bridge=xenbr0']

does not match what you have in the vm.cfg file (see below).

  1. Power off the Virtual Machine by selecting the Virtual Machines tab in the VM Manager, choose the Virtual Machine Name, and click Power Off.

  2. 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.