6.1 Basic Oscar Install

Preface

NOTE
This documentation is for older versions of Oscar
applications and is no longer being maintained. See http://new.oscarmanual.org/oscar-emr
for documentation for versions 10.6 and newer

This basic install is adequate for a local install of Oscar. Many users prefer to install Oscar as a server and run it on a browser from another computer and this will require setting up tomcat for https:// connections and other basic security hardening.

Prerequisites

You have installed a version of Ubuntu 10.4 LTS "Lucid" (32/64 bit desktop/server)

You have a basic level of Linux knowledge

You can open a Linux terminal

You can use a Linux text editor

You can cut and paste EXACTLY the following instructions

NOTE: Firefox will copy with Control+C while a linux terminal requires Shift+Control+V for paste

Installing The Infrastructure Packages

OSCAR is predominately written in the Java programming language
and thus requires the Java SDK to be built from source. The Java SDK
also supports the Tomcat web framework. The following installs Java

First enable the ubuntu lucid partner
repository (it's not enabled by default) by editing sources.list

A note about the following command – ‘vi’ (for visual
editor) is a classic unix editor. First time users usually find other Linux editors easier to use particularly ‘nano’, if you are running in
a terminal
environment, and ‘gedit’, if you are running with a GUI. If you elect
to use an alternative
editor, replace ‘vi’ in the commands that follow with your editor of
choice.

sudo vi /etc/apt/sources.list

Uncomment the following line in /etc/apt/sources.list by removing its preceding #

#deb http://archive.canonical.com/ubuntu lucid partner

This gives you access to certain software from
companies (the partners) that have entered into an agreement with
Canonical (which develops Ubuntu) such as Oracle (Sun) that provides
the type of java that we want.

sudo apt-get updatesudo apt-get install sun-java6-jdk

Mouse or tab to highlight the <yes> acceptance of the liscence agreement and click or enter to accept it.

The source code compilation process for OSCAR is managed by the
Ant package.

sudo apt-get install ant-optional

Your specific CMS data, profiles, and information will all be
stored in the MySQL database. This installation sequence will ask you
for a secure password for the database server – remember this
password as you will need it again later in the installation whenever ****** is referenced. If you use symbols "#,!, &,*, (, ), / , \ and $" in this password (eg pass&word), be sure to escape them when replacing the ***** (eg pass\&word).

sudo apt-get install mysql-server libmysql-java

To support OSCAR’s web based user interface, the system
leverages the extensive resources of the Apache Tomcat web
application framework.

sudo apt-get install tomcat6

Concurrent Versions System (CVS) is used for source code control
on the OSCAR Project. You will need this package to grab the OSCAR
source code.

sudo apt-get install cvs

These are all of the base packages that need to be installed. Now,
we will reboot the server.

sudo shutdown -r now

After the server restarts, log in once again, and proceed to the
next section.

Configuring The Base Packages

A few environment variables need to be set to support OSCAR.

sudo vi /etc/profile

If you are configuring OSCAR on a freshly installed Ubuntu server,
then you should be safe to add these lines to end of the file.

To load the new environment variables into your existing terminal,
run the following command. Please note that the sudo command
is not required in this case.

source /etc/profile

The infrastructure is now in place and it is time to get the OSCAR
source code. The first cvs command below will ask you for a
password – please respond by hitting the Enter key,
without adding a password (ie a null password).

By specifying a specific date/time on the checkout command, you
ensure that you get a specific, dated version that you can track
from. The command, run without the datestamp verb -D "2010-05-05
23:59:59" will retrieve the most recent version that works for both BC and ON.

By specifying a particular release, you will get the code from
that branch of the code. The command, run without the release flags,
will get you the code from the development branch. If the development
stream code is what you want, run the command without -r and
also without -r RELEASE_9_12.

NOTHING will seem to happen (except for the page loading symbol) for half an hour so get a coffee.

When you get back to the screen you will get a page like.

Update Drugref Database!

Table Name

Number of Rows

CdVeterinarySpecies

5584

Interactions

3872

CdDrugProduct

39173

CdDrugSearch

86216

CdDrugStatus

119642

CdActiveIngredients

109648

CdInactiveProducts

51568

CdTherapeuticClass

42538

CdCompanies

43458

CdForm

50800

CdPharmaceuticalStd

23836

CdPackaging

43802

CdRoute

46940

LinkGenericBrand

39142

CdSchedule

43664

Time spent on importing data: 14 minutes

Time spent on new generic import: 8 minutes

Trying It Out

At this point you can test the fairly plain install. To test the connection, open your web browser and go to your the
web address of your server. If you installed on a local desktop version of Ubuntu it is as shown below. You should see the OSCAR
login page.