Escolar Documentos
Profissional Documentos
Cultura Documentos
STEP-BY-STEP INSTALL GUIDE OSCAR MCMASTER CMS ON LINUX UBUNTU 10.04 LTS 3
1.0 Introduction 3
Part 2: Installing OSCAR McMaster CMS on Linux Ubuntu 8.04 LTS Server 5
Step 1: Preamble 5
Part 7: Drugref2/3 19
Step: 1: Install Required Packages 19
Step: 2: Create Drugref Database 19
Step: 3: Download and install Drugref2 20
1
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
References 48
Troubleshooting 48
http://creativecommons.org/licenses/by-nc-sa/3.0/
A GOV Open Access Technical Academic Publications
Enhancing education & empowering people worldwide through eLearning in the 21st Century
2
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
1.0 Introduction
In this Hands-on Labs session, we’re going to use the Linux Ubuntu 10.04 LTS (Lucid Lynx) Desktop
option. Canonical has high hopes that Ubuntu 10.04, Lucid Lynx, will easily become the platform of choice
for anybody who intends to build and deploy large-scale infrastructure, whether you're trying to build the
next Facebook, or the next Google, or the next eBay. If you want to start on [Amazon's cloud-platform]
EC2 and migrate to your own managed private cloud, Ubuntu 10.04 is going to be the platform for you.
Lucid Lynx will be the third long-term support (LTS) release by Ubuntu. LTS releases arrive bi-annually
and are supported for three years on desktops and five years for servers of free security and maintenance
updates.
Ubuntu 10.04 LTS Server Edition: Lean, fast and powerful – Ubuntu Server delivers services reliably,
predictably and economically - and easily integrates with your existing infrastructure. It has almost 100
open-source and proprietary application providers certifying their programs on Ubuntu Server Edition.
Ubuntu 10.04 includes Alfresco, Ingres, IBM, VMware, Yahoo and Zimbra. It also includes improved
installation and management tools for Ubuntu Enterprise Cloud (UEC) and Amazon EC2.
Ubuntu 10.04 LTS desktop Edition: The desktop CD allows you to try Ubuntu without changing your
computer at all, and have an option to install it permanently later. This type of CD is what most people will
want to use. You will need at least 256MB of RAM to install from this CD for general purpose installation.
While for the server, the server install CD allows you to install Ubuntu permanently on a computer for use
as a server. It will not install a graphical user interface.
OSCAR McMaster can be installed on a Desktop for single user or on two or more servers and deployed
in a redundant configuration to provide maximum resiliency in support of your practice. For the
adventurous who are interested in this topic, they can build two identical OSCAR servers, and then search
the internet on how to configure MySQL replication for the database, rsync for the filesystem, and cron for
the automation. These utilities/tools will allow you to tie your two or more OSCAR servers together.
Solution:
In this Hands-on Lab session, you’ll learn how to setup virtual network on VMware (you may also use any
other virtual machines like MS VirtualPC, Linux Xen, or VirtualBox from Sun). In this lab session, we’ll
concentrate on installing Linux Ubuntu 10.04 LTS which you can then later use to install any other
applications as desired. In this lab session, you use the as installed Ubuntu 10.04 install OSCAR v9.12.
You’ll learn how to update Ubuntu server, install and configure required packages and applications need
to run OSCAR, e.g., Sun JDK6, Apache Tomcat application server, MySQL database server, and
OpenSSH server. You’ll learn how to secure your OSCAR server using SSL connection. You will also
learn how to setup OSCAR backups using Cron command on your local machine or on a remote server
3
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
off-site, and how to restore you backups. Finally, you will learn how to perform some simple configuration
tasks on your as-installed OSCAR server. Upon completion of this lab session, you should have acquired
a capability and skills that will allow you to plan, design implement and deploy OSCAR eHealth system on
Linux Ubuntu machine.
In this lab we have installed OSCAR 9.12 on Ubuntu 10.04 LTS Desktop edition with 1224MB RAM and
222GB disk space running on a virtual machine installed on two core CPU PC.
In this Hands-on Labs, it’s assumed that your target computer is connected to the internet. After installing
the operating system, log into your machine and ensure you perform software updates to bring your
systems up-to-date.
2. Once you have downloaded the Ubuntu ISO specific to your distribution, you have the option burning
it into CD or just by using the ISO package to install it from your virtual machine, in our case VMware.
3. Fire-up a new virtual machine and perform the initial configuration and setup to use ISO package.
4. Start the virtual machine, and you should be able to see the first Ubuntu installation screen.
5. Select the option desired and then hit the Enter key to commence installation. In our case we have
selected to Install Ubuntu.
6. The complete installation of the base operating system is beyond the scope of this document.
However, in case you are having trouble with installation then hope over and check an article by same
author “Install Guide Linux Ubuntu 10.04 LTS (Lucid Lynx)”.
7. We’re done with this section
4
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
current configuration. You can run the upgrade command twice to ensure that any packages that may
have post-upgrade dependencies also have an opportunity to be upgraded.
1. From the command line, enter the following commands, one at a time.
Note 1: The sudo command is used to run privileged operations on the Ubuntu platform. The first
time you run the command, it will ask for your password. Subsequently, it will not ask for your
password again for a short period of time (typically 15 minutes).
Note 2: apt-get is the program Ubuntu uses for managing the system’s packages. When used to
manipulate the core packages of the operating system, it needs to be run in conjunction with the sudo
command.
3. We are now ready to begin the instillation of the packages required for OSCAR on Linux Ubuntu.
Part 2: Installing OSCAR McMaster CMS on Linux Ubuntu 8.04 LTS Server
In this tutorial we’ll take you through a step-by-step installation of the OSCAR McMaster Clinical
Management System (CMS), using the Ubuntu 10.04 Long Term Support (LTS) operating system (Lucid
Lynx).
Note: As this is a mission machine server, we recommend utilizing the latest Ubuntu LTS version as
the foundation for your OSCAR installation, as this will deliver the most trouble free and stable
platform for your OSCAR.
As was mentioned earlier, OSCAR can be installed on a desktop machine for single user or on two or
more servers and deployed in a redundant configuration to provide maximum resiliency in support of your
practice. The instructions to install a redundant server configuration are beyond the scope of this tutorial.
However, for the adventurous who are interested in this topic, build two identical OSCAR servers, and
then search the internet on how to configure MySQL replication for the database, rsync for the
filesystem, and cron for the automation. These utilities/tools will allow you to tie your two or more
OSCAR servers together.
Note: The OSCAR McMaster project, Copyright © 2001 McMaster University, is distributed under
the terms of the GNU General Public License version 2 (GPLv2).
Step 1: Preamble
These instructions are written for an audience comfortable with invoking instructions from the command
line and GUI option. If you are capable of installing the user friendly Ubuntu GNU/Linux operating system
or any other Linux distros, then you should be able to follow along with ease.
5
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
At the time of writing this lab manual, this installation was tested with the following standard Ubuntu 10.0
LTS distro packages:
Ubuntu 10.04 i386 (32 bit, desktop or server). In our case, we have used the Desktop option.
tomcat 6
mysql 5.1.41-3Ubuntu12 (use: myql –uroot -****)
java version 1.6.0_20 (Sun’s JDK6) (use: java –version)
javac version 1.6.0_20 (use: javac –version)
Ant version 1.7.1 (use: ant –version)
2. To log into a remote computer that is running OpenSSH, you use the "ssh username@hostname"
command, replacing username with a valid user name on the computer you are trying to log into, and
replacing hostname with either the fully qualified host name (e.g. example.com) of your server, or
it’s IP address (e.g. 192.168.83.225).
3. For example, let’s login remotely to server via SSH as user Sarah Craig (scraig) with password
xxxxx and IP address 192.168.83.188, run:
ssh scraig@192.168.83.188
Note 1: you’ll be asked to respond to yes/no and also enter scraig’s password. And as you can
observe we have successfully remotely logged in as user scraig. Now you can use your usual Linux
commands to remotely manage your Linux server. When done type exit command and hit enter to
logout.
6
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 1
Note: for those using Windows based systems, they can install PuTTY: a free telnet/ssh client.
1. The following command install Java, plus fixes a bug in its default installation program:
Note: The server will need to be rebooted to catch this fix, but we will do this later.
2. Read the License agreement, and then hit the Tab key to select <ok> and then hit Enter key.
7
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
3. Next, Read the license and then select the <Yes> and then hit the Enter key to accept the license
and install the jdk6.
4. Finally, issue the ldconfig command
$ sudo ldconfig
Note: ldconfig creates the necessary links and cache to the most recent shared libraries found in
the directories specified on the command line.
2. When prompted, enter a new root user password, as shown in Fig. 2. Hit the Tab key to select <ok>,
and then hit the Enter key. Repeat the password when prompted.
8
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 2
Warning!: Do not forget the password entered here, as it’ll be required later to login to the MySQL
database server.
$ sudo ldconfig
1. To install Apache Tomcat 6 web application framework, issue the following command:
1. Test that Apache Tomcat is successfully installed, start your browser and enter the URL:
http://localhost:8080. Try port 8180 if 8080 doesn’t work. (Note: If you’re using Ubuntu 8.04.4 LTS,
you browser might render a blank page, its ok don’t worry, so long as it didn’t return an error, you’re
good to go!)
9
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
$ export LC_ALL=C
$ sudo apt-get install postgresql python-pgsql
$ unset LC_ALL
Note: Please note that the sudo command is not required for the following export and unset
commands.
Note: for this hands-on lab session we have used entirely MySQL database!
10
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
2. After the server restarts, log in once again, and proceed to the next section.
1. To set environment variables for some of our packages, use your favorite Text editor to edit the
/etc/profile file, as follows:
$ sudo vi /etc/profile
Note: If you are configuring OSCAR on a freshly installed Ubuntu desktop machine, then you should
be safe to add these lines at the beginning of the /etc/profile file.
11
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
JAVA_HOME="/usr/lib/jvm/java-6-sun"
CATALINA_HOME="/usr/share/tomcat6"
CATALINA_BASE="/var/lib/tomcat6"
ANT_HOME="/usr/share/ant"
export JAVA_HOME CATALINA_HOME CATALINA_BASE ANT_HOME
2. 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
3. The infrastructure is now in place and it is time to get the OSCAR source code.
4. Test that Apache Tomcat is successfully installed, start your browser and enter URL:
http://localhost:8080, and should the browser rendered as shown in Fig. 3.
sudo vi /etc/default/tomcat6
12
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
2. Find the following sections and configure the variables to match what is below. Once again, we’re
assuming that you have at least 4GB RAM.
3. Save the configuration file and when you are back to the shell, then we next need create the SSL
certificate to secure our Internet connection.
Note: below are the series of questions you will be prompted to answer (change as desired!):
5. Now, modify Tomcat’s server config file to support secure encrypted connections via SSL.
sudo vi $CATALINA_BASE/conf/server.xml
6. In the server.xml file, look for the SSL SSL HTTP/1.1 Connector entry and enable that block of
configuration code by removing the comment tags (<!– and –>).
13
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
7. With these changes now configured, we need to restart the Tomcat application server.
sudo /etc/init.d/tomcat6 restart
1. Now you need to open your web browser and enter the following
https://your-server-ip:8443/
Note: on the This Connection is Untrusted page, click I Understand the Risk link, and then click
Add Exception… button. Final click Confirm Security Exception button.
2. Figure 4 shows that we can now access our server via secure SSL connection (i.e., https)
14
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Note: Those who are interested in learning more about configuring SSL/TLS on Tomcat can check
these articles: Secure Connection Tomcat Webserver on Windows and HowTo Generate & Setup
Secure Connection on Tomcat AS on Linux.
2. 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.
3. 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".
4. It’s important to note that this tutorial is specific to the commands in the following section.
mkdir -p $HOME/src/oscar_source
cd $HOME/src/oscar_source
cvs -
d:pserver:anonymous@oscarmcmaster.cvs.sourceforge.net:/cvsroot/oscarmcmaster
login
cvs -z3 -r -
d:pserver:anonymous@oscarmcmaster.cvs.sourceforge.net:/cvsroot/oscarmcmaster
co -r RELEASE_9_12 -D "2010-05-05 23:59:59" oscar_mcmaster
cvs -
d:pserver:anonymous@oscarmcmaster.cvs.sourceforge.net:/cvsroot/oscarmcmaster
logout
Note: It will take a few minutes for the source code to download.
5. Next, to compile OSCAR, change its Build directory and run the ant command.
cd $HOME/src/oscar_source/oscar_mcmaster/build
ant
6. You may ignore the warnings from the compiler, however you should expect to receive the message:
BUILD SUCCESSFUL, as shown in Fig. 5.
15
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 5
sudo cp $HOME/src/oscar_source/oscar_mcmaster/build/tmp/*.war
$CATALINA_BASE/webapps
cd $HOME/src/oscar_source/oscar_mcmaster/database/mysql
Note: For the following set of commands, you need to replace ****** with a secure password.
Remember this password as it will be required to administer the database.
Note: Only run one of the following two database creation commands!
Option 1: Users that wish to use Ontario’s billing subsystem should run the following command
(Note: we have used Ontario’s billing system):
Option 2: Whereas users who wish to use British Columbia’s billing subsystem should run this
command
Note: OSCAR users that are from neither Ontario nor BC can run either of the above commands
(you must run one of them), then you will need to adjust the billing system according to your own
location.
sudo cp $HOME/src/oscar_source/oscar_mcmaster/install/oscar_mcmaster.properties
$CATALINA_HOME
16
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
3. Next, the oscar.properties file needs to be localized for your specific configuration.
sudo vi $CATALINA_HOME/oscar.properties
Note: Specific configuration variables to consider for modification may include the following (but
please review all properties for your own situation):
ii) Now make one of this special changes according to your region, either Ontario or BC, as follows:
• Ontario users will probably want to adjust the following (Warning do not put any blank spaces at
the end of any line!). In our case we have used Ontario.
• BC users will probably want to adjust the following to match their environment
billregion=BC
NEW_BC_TELEPLAN=yes
CDM_ALERTS=250,428,4280
COUNSELING_CODES=18220,18120,17220,17120,16220,16120,13220,12220,12120,00120
phoneprefix = 613-
pathnet_url= # supply the Location of Pathnet DLL
pathnet_username= # supply User to access the system
pathnet_password= # supply User?s Password
4. If you didn’t change the default location for the documentation directories in the properties file, you will
need to create the appropriate directories.
cd $HOME/src/oscar_source/oscar_mcmaster/database/mysql
mysql -uroot -p****** oscar_mcmaster ### will bring you to the mysql database prompt
18
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Part 7: Drugref2/3
In this section, I’ll show how to download and install Drugref2 from Google code site. To do this, perform
the following procedure:
Mercurial package is required to download drugref2. To install it issues the following command:
ii) Next, we need to install and learn Maven which for Ubuntu or Debian is a simple:
1. Now using your own username and password for mysql, create drugref database as follows:
2. Next, change or adjust memory settings for Java to allow for the increased load, if you haven’t done
so. Not so surprising if you follow this howto and install on the same machine that is serving Oscar
your JVM will be sucking back 800 MB of memory, 500 of it Heap.
19
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
3. Next, create a unencrypted http connector in Tomcat if you don't already have one typically port 8080
or 8180
Alternatively, you can get a local copy of the drugref2 repository with this command:
6. To build Drugref2: navigate to the drugref2 directory that you just downloaded and issue the
command:
$ cd drugref2
$ mvn clean install
cd $HOME/drugref2/target/
cd $CATALINA_BASE/webapps/drugref2/WEB-INF/classes/
vi drugref.properties
and then adjust the "db_user" and "db_password" to match what you used in Part 6 above to
create the drugref schema for MySQL, as follows:
db_user=root
db_password=******
db_url=jdbc:mysql://127.0.0.1:3306/drugref
db_driver=com.mysql.jdbc.Driver
sudo vi $CATALINA_HOME/oscar.properties
and comment out your current "drugref_url" by placing a # mark ahead of the line;
#drugref_url = http://localhost:8001
RX3=yes
drugref_url = http://yourtomcatip:port/drugref2/DrugrefService
drugref_url = http://localhost:8080/drugref2/DrugrefService
12. To populate the database with the drug data, open your browser and navigate to the server. If you
installed on a local desktop version of Ubuntu it is as follows:
21
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 6
Note: It will take awfully long time to render the data to the browser!
13. If you get tired you can check the progress from MySQL server:
Note: if you get 15 rows of table names you are still on the right track.
Note: Time to head for that overdue coffee break NOTHING will seem to happen (except for the page
loading symbol) for almost an hour so get a coffee. When you get back you should get the results
rendered to the browser as shown in Fig. 7.
22
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 7
1. To test the connection, open your favorite web browser and go to the web address of your server as
shown below. You should see the OSCAR login page, see Fig. 8. http://localhost:8080/oscar or login
using secure connection: https://localhost:8443/oscar or https://192.168.83.231:8443/oscar
23
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Note: Your browser may complain about your unofficial or uncertified certificate self-signed certificate.
You can ignore these warnings and avoid them in the future by accepting and installing the certificate
on your workstation. The instruction for doing this is browser specific and beyond the scope of this
document, however, for Firefox 3, below is a simple howto:
Note: on the This Connection is Untrusted page, click I Understand the Risk link, and then click
Add Exception… button. Final click Get Certificate button, followed by Confirm Security Exception
button
Note: If you can login, as shown in Fig. 9, then you have successfully installed a plain OSCAR and
you can start playing with it.
24
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Warning! The first thing you will need to do once you login is to change your primary passwords from
the defaults, i.e. "mac2002". This expires exactly one month from the installation date.
3. To change your primary password, click Pref -> Change Your Password, see Fig. 10.
Fig. 10
25
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Note: you need to enter a good password complexity for your password, see Fig. 11.
Fig. 11
4. Next, we need to activate Rx3, when logged into Oscar. Again from Fig. 10, click Set To Use Rx3
link and then click the check box "Use Rx3" and hit the Submit button, see Fig. 12.
Fig. 12
Note: When done, click the icon to close the window, and then click the Update button when you
get back to Fig. 10
5. For added security for your production environment you will need to secure your installation further
and apply proper firewall/router configuration. For securing your network, please check our
Firewall/Router article using IPCop:
Install Guide IPCop Firewall/Router for Network Security with Spam and Virus Protection
26
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
the database
the properties file
the document upload directory
the eforms directory
1. Our recommendation is to automatically backup the database nightly, then use rsync to move all the
files, including the database dump to a remote machine for the sake of safety and risk management.
2. First, create a database backup directory, and change the permissions so that only the root user can
read the contents.
3. Now we will create a script that we can use to backup the database and create an archive of all the
dynamic files on the system. As the archive file of the uploaded files will become quite large over time,
we’ll only keep two copies on hand at any given time. You can, of course, configure your system to
keep more if you like.
sudo vi /usr/local/backups/backupOSCAR.sh
5. In this file, put the following lines (replacing the ****** with your actual MySQL database password):
#!/bin/sh -e
#
/usr/bin/mysqldump –add-drop-table -uroot -p****** oscar_mcmaster >
/usr/local/backups/backupOSCAR-`date +%F`.sql
/bin/gzip -f /usr/local/backups/backupOSCAR-`date +%F`.sql
/bin/mv /usr/local/backups/backupOscarFiles.tar.gz
/usr/local/backups/backupOscarFiles.older.tar.gz
/bin/tar cfz /usr/local/backups/backupOscarFiles.tar.gz
/usr/local/tomcat/webapps/OscarDocument/oscar_mcmaster
/usr/local/tomcat/oscar_mcmaster.properties
27
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
7. We’ll configure Ubuntu to run the command every day. This is done by creating a cron job for the
script we just made. Run the following command:
sudo crontab –e
8. And add to the existing file an entry so that the command looks like below:
Note: You’ve now configured a daily backup of the MySQL OSCAR database. This backup will run at
5 minutes after 4 am, each morning. Each backup file will be created in the /usr/local/backups
directory and will be time stamped based on the day it was created.
9. You will be able to see the contents of the backup directory with the command:
sudo ls /usr/local/backups
Fig. 13
10. These backup files are also viewable/downloadable via the AdminÆAdministrative page as
shown in Fig. 14.
28
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 14
Scroll down and under the oscarBackup heading click oscarDatabase/Document Download link, to
access the page shown in Fig. 15.
Fig. 15
29
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
12. Finally, for safety and disaster recovery sake; let’s move the backup files, and the backup database to
a remote machine. This is accomplished by running the following command, and replacing username
with a valid username for the remote machine, and replacing domainname with the FQDN or IP of the
remote host:
13. We’re done with configuring OSCAR backup and restore tasks.
• add users and configure their security and optionally their schedules
• configure your clinic information
• import your patient demographic records
• localize your billing templates and update the system to the latest fees schedule
• configure electronic access to your labs
• configure your prescription pad
• add some forms and eforms
Many of these activities are intuitive to configure and most are described in the user guide which is
available on the OSCAR Canada web site. In the next two sections, we will go through a couple simple
tasks to get you started.
2. Select from the menu Admin Æ Select Forms., under oscarEncounter heading. This will open a
window which allows you to add and remove the forms that are available via the patient’s Encounter
window, as shown in Fig. 16.
30
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 16
3. Highlight Discharge Summary from the Selected Forms list, and click <<Delete button. Add the
following forms from the All Available Forms list:
• Annual
• Annual V2
• CHF
• Growth 0-36m
• Growth Charts
• ImmunAllergies
• Lab Req 2007
• Mental Health
• MMSE
• PeriMenopausal
• Risk Assessment
• Rourke
• Rourke2006
• Self Efficacy
• T2Diabetes
• Vascular Tracker
Note: to make your task easier, hold down the Ctrl key and click each selection desired and then
finally, click the Add>> button.
4. When done with your selection(s), click the Close button to exit the Select Forms window.
5. These forms will now be viewable via the Encounter page of each patient.
31
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
• INR
• Hypertension
• HIV
• Diabetes
These flowsheets are enabled by configuring the disease registry. To do this, perform the following
procedure:
1. First, login to OSCAR if you haven’t done so, and then select Admin Æ then under oscarEncounter
heading click Customize Disease Registry Quick List, see Fig. 17.
Fig. 17
Next, click Edit Quick List Æ default, and then click the Continue button, see Fig. 18.
Fig. 18
32
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
2. Now enter each of the icd9 codes for the following items and select Add (select Close when you are
finished), see Fig. 19:
Fig. 19
Note: when done click the Close button twice to exit the oscarDXResaerch window.
3. And now, to enable a flowsheet for a specific patient, you will select from the patient’s Encounter
Æ Dx Registry Æ Quick List window the appropriate condition.
Note: The appropriate flowsheet will now be enabled on the Encounter page (you will need to
refresh/reload the Encounter page to see the Flowsheet under the Measurements heading.
5. We’re done with this lab session for time being – however, do come around to check updates on this
install guide.
Note: This is a work in progress; please do come back and check on the status of the lab manual.
33
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
14. You have now completed the lab session on installation of OSCAR CMS on Ubuntu 10.04 LST
Desktop.
15. Stay tuned and, keep checking this site and article for more updates as we’ll be updating this lab
manual with more goodies.
16. Search the web with Google search and keep reading for hints on what to do next.
For those in the process of moving OSCAR EMR to the latest version – perform the following procedure:
cd /usr/local/backups
3. Now, let’s create a backup script to backup our entire OSCAR installation. Using your favorite Text
editor, create a new "fullBackupOSCAR.sh" file
vi extendedBackupOSCAR.sh
#!/bin/sh -e
oscarname=extended.$installation.backup
backupdir=$backup/$oscarname-`date +%F`
sudo ./extendedBackupOSCAR.sh
Warning! if the update goes horribly wrong, it is essential that you can roll back your server to what
you had before.
http://tech.oscarpei.net/2010/05/how-to-switch-oscar-to-new-server.html
http://tech.oscarpei.net/2009/06/how-to-upgrade-oscar-to-latest-version.html
Therefore, before you can add a new provider, you must look through the existing providers to see what
your last provider ID number was.
1. Login to your OSCAR EMR web admin console with Admin user credentials.
2. Next, click on the Admin tab and then from the following ADMINISTRATIVE PAGE, under Provider
heading,
3. Click the ‘Search / Edit / Delete Provider Records’ link to access a” Search a Provider” window
4. Now, click on the "Search" button without typing any name in the box, to get the full list of providers
in the database, as shown in Fig. 20. As can be observed, we have two providers listed.
35
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 20
5. From Fig. 20, click on the ‘ID’ heading to put the ID numbers in numerical order – if you not yet done
so (each heading allows you to sort the database by each of the heading titles when clicked)
6. After noting your last provider ID number, decide what the ID number will be for the new provider and
write it down, in this case let use '000001'
8. Click on Add a Provider Record link, to access Add a Provider page shown in Fig. 21. Complete all
the required fields and then click on the Add Provider Record button.
Username: szulu
Password: mac2002#1
Login Pin: 1001
36
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 21
37
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
9. When done, and no error encountered, you should be presented with “Successful Addition of a
Provider Record”. Click on the Back link.
10. Now, click again on the ‘Search / Edit / Delete Provider Records’ link to access a “Search a
Provider” window. Click on the Search button again to verify that our newly added provider record is
indeed added, and as can be observed, it is, see Fig. 22.
Fig. 22
13. Login to your OSCAR EMR web admin console with Admin user credentials, if you haven’t done so.
14. Next, click on the Admin tab and then from the following ADMINISTRATIVE PAGE, under Security
heading,
15. Click the ‘Search / Edit / Delete Security Records’ link to access a “SEARCH SECURITY
RECORDS” window
38
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
16. Now, click on the "Search" button without typing any name in the box, to get the full list of Security in
the database, and verity that the user has not been added to the Security. Click on the Back arrow
when done.
17. Still under the Security heading, click on the Add a Login Record link, to access Add a Login User
page shown in Fig. 23. From under Provider No.:, click on the drop-down menu and select Shaka
Zulu, and the complete all the required fields and then click on the Add Record button.
Username: szulu
Password: mac2002#1
Login Pin: 1001
Fig. 23
Note: you should see a confirmation “Successful Addition of a Login User Record”.
19. Still under the Security heading, click on the Assign a Role to Provider link, to access Provider-
Role List page shown in Fig. 24. From the row containing provider Shaka Zulu, under the Role
column, click on the drop-down menu and select "doctor". Click on the Add button to assign this
role to Dr. Zulu.
39
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 24
Fig. 25
40
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
25. Now logout and login as provider Dr. Shaka Zulu with following credentials:
Username: szulu
Password: mac2002#1
Login Pin: 1001
• If all is OK, you should be logged in as Dr. Zulu as shown in Fig. 26.
Fig. 26
26. To complete this section add the following providers: Receptionist, and a Nurse, and repeat all the
steps to allow them to login to the OSCAR EMR web console
1. Login to your OSCAR EMR web admin console with Admin user credentials.
41
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
2. Next click on the Search tab at the top, as shown in Fig. 27.
Fig. 27
3. From the Fig. 28, you have the option to search for the patient from the system or create one;
however, it’s always a good idea to search the patient record first. Once done with search and
confirming that the patient is not on the list, then you can go ahead him/her.
4. To create a new patient record, click on the “Create a new Demographic” link.
Fig. 28
42
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
5. From Fig. 29, ADD A DEMOGRAPHIC RECORD page, you have the option to search for the patient
or add record by completing the required fields. When done click on the Add Record button.
Fig. 29
6. If all is OK and you have no error, you’ll be taken to the page shown in Fig. 30, which shows a
“Successfully Addition of a Demographic Record”. You have the option to click Go To record link,
Close this Window or Back to Demographic Search Page.
Note: You may add as many Demographic records as desired for this lab session.
43
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Fig. 30
7. When you click Go To record link, you’ll be taken to the record you just created as shown in Fig. 31.
Here, you have option produce PDF files of the new patient.
Fig. 31
8. Now from Fig. 31, click on the Back button to be taken to the “Successfully Addition of a
Demographic Record”. From there click on the Close this Window link to close the window.
44
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
1. Login to your OSCAR EMR web admin console as user Emily Jones (ejones), with above
credentials, as shown in Fig. 32.
Fig. 32
2. Click on the appropriate date using the CALENDAR button on the upper left corner
45
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
3. Clicking on the desired time will open a window to enter appointment details as shown on Fig. 33.
• In the Last Name box, type part of the patients last name and click on the Search button or hit the
enter key
• From the list generated, click on the grey demographic number for the desired patient
• Change the length of the appointment in the Duration box, if needed, from the default of 15 min to
30, 45, 60 min etc.
• Finally, fill in the reason for the appointment and click Add Appointment button.
Fig. 33
7. Click on the Demographic ID for the correct patient to access the ‘Patient’s Detail Record”
46
April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
Alternatively,
8. If the patient has an appointment, click on the M beside the patient’s name on the Appointment screen
9. Clicking "BILLING HISTORY" shows a list of the encounters that have been billed with date, bill
type, provider and comment column
10. Clicking on the date will allow you to view what was billed for each encounter
11. Only billed encounters that have NOT been submitted to OHIP can be unbilled and re-billed
Call us today:
Email: info@globalopenversity.org. URL: www.globalopenversity.org
References
This document has been modified and adapted for our internal lab use from the original instructions by
David Daley by Peter Hutten-Czapski and is freely licensed under the Creative Commons Attribution-
Share Alike 3.0 Unported License.
Troubleshooting
1. Configuring Oscar on Ubuntu — Family Medicine I_T_ group (MySQL Database Connector)
http://it.oscarmcmaster.org/howto-s/configuring-oscar-on-ubuntu
2. 6_1 Basic Oscar 9_12 install (oscarusermanual):
http://sites.google.com/site/oscarusermanual/-oscar-emr/6-0-installing-oscar/installing-oscar-on-
ubuntu-10-4ltc-lucid
3. Troubleshooting OSCAR 9.12 Drugref installation and setup on Ubuntu 10.04 LTS:
http://wiki.gnumed.de/bin/view/Gnumed/DrugRef
-----------------------------------------------
Kefa Rabah is the Founder of Global Technology Solutions Institute. Kefa is knowledgeable in several
fields of Science & Technology, Information Security Compliance and Project Management, and
Renewable Energy Systems. He is also the founder of Global Open Versity, a place to enhance your
educating and career goals using the latest innovations and technologies.
http://creativecommons.org/licenses/by-nc-sa/3.0/