Table of Contents
maxLevel 4 printable false

How Integrator works

• Both Oscar sites periodically push data into Integrator, which stores it into its database.
• Patients have their demographics registered in both Oscar sites and "linked" through Integrator.
• When a patient's chart is opened in one Oscar site, Oscar will contact the integrator and pull his/her chart data from the other site(s).
• Chart data from remote site is shown with special indication.

Prerequisites

Java

...

Version 6

Sun Java 6 is no longer available in the Ubuntu repositories.  However, it can still be installed from Oracle's web site.  Alternatively (and likely preferably), you can create packages of Java 6 using this script.

cd ~/
wget https://raw.github.com/flexiondotorg/oab-java6/master/oab-java.sh -O oab-java.sh
chmod +x oab-java.sh
sudo ./oab-java.sh
sudo apt-get install sun-java6-jre

Tomcat version

...

6

sudo apt-get install tomcat6

Tomcat setting

The following line should be added to tomcat start script at before executing the web service:

export JAVA_OPTS="-Xmx1024M -Dcaisi_integrator_config=/usr/share/tomcat6/integrator_override.xml"

...

Notes:

...

Oscar version

Integrator works with Oscar release 12.1.  All Oscar systems connected to the same integrator should be on the same version of Oscar.

Installation Via Script

We have created a script which will:

...

You can always download the latest WAR file for the integrator from this url: https://demo.oscarmcmaster.org:11042/job/integratorMaster/lastBuild/org.oscarehr$caisioscarehrcaisi_integrator/artifact/org.oscarehr/caisi_integrator/0.0-SNAPSHOT/caisi_integrator-0.0-SNAPSHOT.war

...

...

Web Setup

Integrator

...

Web Setup

1. Run Integrator by starting tomcat

2. Open a web browser and go to: (url) http://integrator_server_name:8080/caisi_integrator

   Info
   change "integrator_server_name" and port according to your own settings

3. Select "Integrator Site"
4. Login as "admin", password: "admin"
5. Select "Administration"
6. Select "Manage Facilities"
7. Select "Add New Facility", enter a username and password for each Oscar site to use on connecting to the integrator.  The facility username and password will be used in the next section.
8. Repeat step 7. Each facility represents one Oscar site.

Oscar

...

Web Setup

1. Start Oscar (if not already running)
2. Login to Oscar using an account with admin rights
3. Select "Admin" in the top menu
4. Select "Manage Facilities" under "Misc"
5. Select "Edit"

6. Change "Name", "Description" to something of your choice. 

   Info
   The name field will be used to identify this Oscar instance at other facilities so we suggest using something short and identifiable. For example, a name of "Fakestreet Family Health Team" is likely too long, whereas "FFHT" may not be unique or identifiable, but "Fakestreet" allows users at other sites to know what site information is coming from.

7. Enter "http://integrator_server_name:8080/caisi_integrator/ws" into "Integrator Url" (This should be the URL from step 2 in the previous section + "/ws")
8. Enter "Integrator User" and "Integrator password" with the facility name and password from step 7 in the previous section
9. Check "Enable Integrator"
10. Save. You will be prompted with "Remove Demographic Identity NOT checked! Is it OK?". Select "OK".

...

Integrator

...

Preferences Within Oscar

The purpose of setting this is to allow all patients to be synced, or by default only Rostered patients will be synced.

...