Oscar EMR Installation

...

...

Preface

...

This document is an A-Z installation guide on installing the Oscar EMR with the Caisi Integrator. The OscarSetup.zip file will be available on Google Drive. In most cases in this document, the process will be described, followed by the bolded instructional steps. All paths are absolute.

* See bottom of document for list of commonly used commands *

Prerequisites

...

• Install Ubuntu 12.04 LTS (host or vm). Run all updates.

• Java

  • See instructions on how to get sun-java below.

• MySQL 5.1 or 5.5+

  Info
  icon false title Terminal Commands
  sudo apt-get install mysql-server libmysql-java

• Tomcat

  Info
  icon false title Terminal Commands
  sudo apt-get install tomcat6

  The tomcat service will run automatically. Enter the following command to stop the service.

  Info
  icon false title Terminal Commands
  sudo /etc/init.d/tomcat6 stop

• Git

  Info
  icon false title Terminal Commands
  sudo apt-get install git

• MySQL Workbench

  Info
  icon false title Terminal Commands
  sudo apt-get install mysql-workbench

• Maven2

  • Download the apache-maven-2.2.1.zip file. It must be 2.2.1.

  • Create a directory called bin in the home folder.

  • Extract the zip file to the bin folder.

• Configure your environment variables:

  • Enter these lines at the bottom of the file:source (sudo nano /etc/profile) - Have to logout for the changes to take effect

    Info
    icon false title Terminal Commands
    JAVA_HOME="/usr/lib/jvm/java-6-sun" CATALINA_HOME="/usr/share/tomcat6" CATALINA_BASE="/var/lib/tomcat6" M2_HOME=”/home/username/bin/apache-maven-2.2.1” M2=”$M2_HOME/bin”PATH=”$M2:$PATH” export JAVA_HOME CATALINA_HOME CATALINA_BASE M2_HOME M2\

    Logout and in to see changes

• Check your versions to confirm it’s all working

  Info
  icon false title Terminal Commands
  java -version (if this says Ice Tea, you have the wrong Java) mvn –version mysql –V (capital)

MySQL Workbench

Info

icon	false
title	Terminal Commands

sudo apt-get install mysql-workbench

• Eclipse (install java first, instruction below)

  Info
  icon false title Terminal Commands
  sudo apt-get install eclipse

...

*If using eclipse, you will want to install egit and m2e (Help > Install New Software > All Available Sites > search for ‘egit’ and ‘m2e’ and install each).

MySQL Setup

...

You will want to create a mysql user named 'oscar' with the password 'oscar' and grant this user all permissions to your databases. The easiest way to perform these mysql operations is to use mysql workbench.

...

The user oscar@localhost will be used for all mysql operations from this point on, rather than root@localhost.

Getting the Latest Version of Oscar

...

To clone Oscar from gerrit, you will have create an account on gerrit - the code review system of choice for Oscar – generate an ssh key, and link it to your account. In terminal, follow the steps below:

...

cd /home/username/workspace/ (mkdir workspace first if this directory does not exist)
git clone ssh://<your username>@source.oscartools.org:29418/oscar

Setting Up a Custom Tomcat Installation

...

Download the OscarSetup.zip file from the google docs and unzip it into the user directory.

Next you will have to copy the tomcat-local folder into your local workspace

Setting Up the Oscar Database

Don’t do this unless you have to. Instead ask for the latest MySQL dump from someone who cares. If you can’t find anyone, do it this way.

...

mysql> create database drugref;
mysql> use drugref;
mysql> source drugref.sql;

Building and Running Oscar

Copy the files into your home folder

...

sudo /etc/init.d/tomcat6 

start/restart/stop

sudo nano /etc/profile/

mv /home/mohawk/workspace/oscar_source/oscar/target/oscar-SNAPSHOT.war $CATALINA_BASE/webapps/oscar.war

mvn clean package 
from ~/workspace/oscar_source/oscar

...