Getting Started with the Integrator

Introduction

The Integrator is a software component which allows n OSCAR instances to share records. It primarily acts as a data cache, stores linking information, and allows other software to query it (OSCAR).

Architecture

Setup

You will need to have the integrator running on it's own JVM from any OSCAR. Here are the basic steps

Note that this document reflects the new way of doing things, so grab the integrator code this way. 

Getting the code

The code is housed in a GIT repository. You should have git, if not, add it using apt-get install git

git clone git@bitbucket.org:oscaremr/integrator.git

git checkout OSCAREMR-6112-change-integrator-job-to-w

Preparing to build

Update src/main/resources/config.xml or create a copy of it and use that as the override file. You should update the database username, password, and uri at the very least. Make sure the paths exists and the defaults make sense for you.

Create an empty database and grant access to your user/password.

Build

The integrator is built using Apache Maven

mvn package

You should have a successful build, giving you a WAR file, and updating your catalina_base subdirectory with a ready to go tomcat base directory.

Start server

update your set_env.sh file and then source it, and start up tomcat

source set_env.sh

$CATALINA_HOME/bin/startup.sh

Configure

Go to http://localhost:8085/caisi_integrator/site/ (or wherever you installed it) and login using admin/password

to to administration, and facilities

Add a Facility for each of your OSCAR instances