Step-By-Step Install Guide OpenEMR On Ubuntu 10.04 LTS
Step-By-Step Install Guide OpenEMR On Ubuntu 10.04 LTS
Step-By-Step Install Guide OpenEMR On Ubuntu 10.04 LTS
1.0 Introduction 1
1
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
1.0 Introduction
In this Hands-on Labs session, we’re going to learn how to install and configure the Linux Ubuntu 10.04
LTS (Lucid Lynx) 64-bit server option which we then use to install openEMR. You can also use the Ubuntu
20.04 LTS Desktop if desired.
OpenEMR is a free Open source, Practice management, Electronic Medical Records, prescription writing
and medical billing application. These programs are also referred to as electronic health records.
OpenEMR is licensed under the General Gnu Public License (General GPL). It is a free open source
replacement for medical applications such as Medical Manager, Health Pro, and Misys. It features support
for EDI billing to clearing houses such as Availity, MD-Online, MedAvant and ZirMED using ANSI X12.
OpenEMR was originally developed by Synitech and version 1.0 was released in June 2001 as MP Pro
(MedicalPractice Professional). Much of the code was then reworked for HIPAA compliance and improved
security, and the product was reintroduced as OpenEMR version 1.3 a year later, in July 2002. You can
install openEMR on Unix-like systems (Linux, UNIX, and BSD systems), Microsoft systems, Mac OS X
and other platforms. In this you’ll learn how to install openEMR on Linux distros that are open source.
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.
Canonical has high hopes that Ubuntu 10.04 LTS (Long Term Support) will easily become the platform of
choice for anybody who intends to build and deploy large-scale enterprise infrastructure deployment,
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 LTS release by Ubuntu. It’s based on open source
Debian GNU/Linux. LTS releases arrive bi-annually and are supported for three years on desktops and
five years for servers of free security and maintenance updates.
1
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
that I’ll show you how to install. You’ll also have opportunity to carryout some lab assignments at the end
of this training. After completion of this lab session, you should have gained enough skills to install and
setup openEMR on Linux Ubuntu 10.04 LTS Server or Desktop.
It’s here assumed that your target computer is connected to the internet as we’re going to make use of
packages download and system upgrade.
After installing the operating system, login to your machine and ensure you perform software updates to
bring your systems up-to-date.
1. From the command line, enter the following commands, one at a time.
# apt-get update
# apt-get -u upgrade
2
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
2. Apache configuration file is located at: /etc/apache2/apache2.conf and your web folder is
/var/www.
3. To check whether PHP is installed and running properly, just create a testinfo.php in your
/var/www folder with phpinfo() function exactly as shown below.
vi /var/www/testinfo.php
<?php
/* testinfo.php */
phpinfo();
?>
1. Again if you didn’t pre-install the MySQL database server, then no worries - the following commands
will install mysql 5 server and mysql 5 client.
Security Warning! By default there is no root password set for MySQL after initial installation, and
therefore, it is important that you set the password for the ROOT account.
3
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 1
2.1 Manually Creating users to use MySQL and Changing Root Password
2. By default mysql creates user as root and runs with no passport. You might need to setup the root
password.
Note: you must never use root password, so you might need to create a user to connect to mysql
database for a PHP script. Alternatively you can add users to mysql database by using a control panel
like Webmin or phpMyAdmin to easily create or assign database permission to users. We will install
Webmin and phpmyadmin during later once we complete basic installation.
4. You can also try remote localhost login as "root" user, as follows:
| information_schema |
| datactrbk |
+--------------------+
2 rows in set (0.07 sec)
mysql>exit
BYE
netadmin@ubuntu:~$
6. That's it! MySQL and phpMyAdmin are ready. Log in with your mysql root password and create users
to connect to database from your PHP script.
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.180), as show in Fig. 2.
5
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 2
You can install Webmin for your server web interface to configure Apache2, MySQL, FTP, DNS servers
and many more. Now we will see how to install Webmin in Ubuntu 10.04 LTS.
5. Now download the latest Webmin using the following command or from here
wget http://prdownloads.sourceforge.net/webadmin/webmin_1.530_all.deb
6. Now we have webmin_1.530_all.deb package install this package using the following
command
# dpkg -i webmin_1.530_all.deb
Note: incase you encounter any difficulties in installing dependency; then issue the command:
# apt-get –f install
Fig. 3
8. We’re also done with installing all the necessary pre-requite packages.
For Debian distro, a command-line install is recommended. However, in Ubuntu distro installation can
either be done in desktop or command line. In this lab session we’ll use command-line option.
2. Change to the download directory and as root user, issue the following command (Note: you’ll be
required to respond to some query, like MySQL password):
7
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Note: incase you encounter and any with this initial command, the run:
3. As can be observed from the above installation process, you can access to OpenEMR by browsing to
http://localhost/openemr, as shown in Fig. 4.
8
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 4
4. Now login with username 'admin' and password 'pass', as shown in Fig. 5. You now take time to
get familiarized with the openEMR layout and functionality. As you can observe I am logged in as an
Administrator.
Note: on the left pane, you have links which allows you to access other openEMR admin
functionalities while on the right-pane; you have access to the current month Calendar, date and
schedule times. From here you can also do some system Search.
9
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 4
$ man openemr
10
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
2. Click on the Calendar link to access the default current Calendar, as shown in Fig. 5. From here you
can search and schedule patients’ for checkup or admission.
Fig. 5
11
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
2. Click on the Patient/Client link Æ Management to access the default current “Search or Add
Patient” pane on the right-pane, as shown in Fig. 6. From here you can search or add patient to the
system.
• Under Management link, you also have access to other links like Current and Summary,
which are currently grayed-out.
Fig. 6
3. Click on the Patient/Client link Æ Visits link, as shown in Fig. 7. From here you can search or
add patient to the system.
• Under Visits link, you also have access to other links like: New Visit, Current, List,
Transact and Chart Tracker. Except, Chart Tracker, all the other links here are
currently grayed-out.
• Click on the Chart Tracker link to access and external “Chart Tracker” window, as shown
in Fig. 7. Fm here you can perform new patient lookup using their ID.
12
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 7
• Under Visit Forms link, you also have access to other links which all are currently grayed-
out.
5. Click on the Patient/Client link Æ Medical Records link. From here you also have access to
other links which all are currently grayed-out.
• Under Fees link, you also have access to other links like: Fee Sheet, Checkout, and
Billing. Except, Billing, all the other links here are currently grayed-out.
13
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
• Now click on the Billing link to access “Billing Report” form. From here can perform all
billing related functionalities.
Fig. 8
5. Click on the Administration link, as shown in Fig. 9 with Facilities link clicked.
• Under Administration link, you also have access to other links like: Facilities, Users,
Practice, Services, Layout, Lists, and ACL.
• From Facilities link Æ Facilities Administrations form, complete all the required fields
under the “New Facility Information”. When done click on the Add button to apply the
changes.
14
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 9
6. Click on the Administration link Æ Users link, as shown in Fig. 10. From here you can add new
users to the system.
• From Users link Æ User Administrations form, complete all the required fields under the
“New User”, select the user type from the under the Access Control. When done click on the
Add button to apply the changes.
15
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 10
7. Click on the Administration link Æ Practices link, as shown in Fig. 11. From here you can add
new other Practices to the system.
• Click Add a Pharmacy link and complete all the required fields. When done click on the
Update button to apply the changes.
16
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 11
8. Click on the Administration link Æ Services link, as shown in Fig. 12. Enter all the required
fields and then either click on the [update] or the [Add as New] link.
17
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 12
9. Click on the Administration link Æ Layouts link, as shown in Fig. 13. From Layouts link Æ
Edit Layout drop down menu, select the desired option.
18
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 13
1. Click on the Administration link Æ Lists link, as shown in Fig. 14. From Lists link Æ Edit
List drop down menu, select the desired option. When done click on the Save button to apply the
changes.
19
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 14
2. Click on the Administration link Æ ACL link, as shown in Fig. 15. From ACL link Æ Access
Control List Administration, select the desired option.
20
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 15
3. Click on the Administration link Æ backuup link, as shown in Fig. 16. From here you can click
on the “Create Backup: button to “create and download a full backup”.
Fig. 16
4. Click on the Administration link Æ Others link, from here you can perform other functionalities
like: Language, Forms, Logs and Database related activities.
2. Click on the Reports link, as shown in Fig. 17 with List link clicked.
• Under Reports link, you also have access to other links like: Clients, Visits,
Financial, General, Insurance, and Blank Forms. These links also have sub-links.
• For example, from Clients link Æ Patient List, which you can use to such patients record.
Fig. 17
22
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
6. Click on the Miscellaneous link, as shown in Fig. 18 with Fax/Scan link clicked.
• Under Miscellaneous link, you also have access to other links like: Pt Notes/Auth,
Fax/Scan, Addr Book, Chart Tracker, Ofc Notes, BatchCom, and Password.
• For example, from Fax/Scan link which you can use fax management.
Fig. 17
23
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
6. Take your time and continue with the same sequence of getting yourself acquainted with the
openEMR layout and functionalities.
Call us today:
Email: [email protected]. URL: www.gtechsi.org
needed to run OSCAR e-Health, 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; how
to setup OSCAR backups using Cron command on your local machine or on a remote off-site server, and
how to restore your backups. Finally, you will learn how to perform some simple configuration tasks on
your as-installed OSCAR server. Upon completion of this course, you should have acquired a capability
and skills that will allow you to plan, design implement and deploy OSCAR e-Health information
management system on a Linux Ubuntu machine
-----------------------------------------------
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.
25
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada