Académique Documents
Professionnel Documents
Culture Documents
1.0 Introduction 1
1
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
1.0 Introduction
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.
Debian 5 or Lenny is based on the 2.6.25 Linux kernel. For the desktop, Lenny supports both KDE 3.5.9
and GNOME 2.20.1.1. It also includes the most recent versions of many popular end-user software
applications. These include: Firefox 3.01, OpenOffice 2.4.1, and Evolution 2.22.3.1. Lenny is also
excellent for developer. It all includes the best developer and server programs. For example, Lenny
comes with glibc 2.7 and Samba 3.2.
For networking, Lenny will include full support for the IPv6 networking protocol and NFSv4 (Network File
System). On the server side, Lenny is also expected to have LFS (Large File Support). With this,
applications will have access to the largest files supported by the operating system and file system rather
than an application-bound arbitrary file size limits. In general, Debian 5 is an outstanding Linux
distribution. Since Debian is, in turn, the foundation of many other distributions, such as Ubuntu and its
family of Linux distributions; MEPIS; and Xandros, this bodes well for all of Linux.
1
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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. Apache configuration file is located at: /etc/apache2/apache2.conf and your web folder is
/var/www.
2
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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.
Fig. 1
3
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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:
mysql>exit
BYE
netadmin@debian5:~$
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.
4
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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.
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 Debian 5 Lenny
5
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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.
In Ubuntu distro installation can either be done in desktop or command line. However, for Debian, a
command-line install is recommended.
6
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
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):
# dpkg -i openemr_3.2.0-1_all.deb
Note: incase you encounter and any with this initial command, the run:
# apt-get install -f
.....
......
Creating config file /etc/php5/cli/php.ini with new version
Setting up imagemagick (7:6.3.7.9.dfsg2-1~lenny4) ...
Setting up openemr (3.2.0-1) ...
Configuring OpenEMR
Configuring Apache for OpenEMR
Added entries to apache configuration to secure directories with patient
information.
Placed backup of your original apache configuration file to
/etc/apache2/httpd.conf.BAK
Configuring PHP for OpenEMR
We changed the following setting(s) in your php configuration file at
/etc/php5/apache2/php.ini :
(We have placed a backup of your php configuration at
/etc/php5/apache2/php.ini.BAK)
Successfully set max_execution_time = 60
Successfully set max_input_time = 90
Successfully set display_errors = Off
Successfully set log_errors = On
Successfully set post_max_size = 30M
Successfully set upload_max_filesize = 30M
Restarting Apache service
--------------------------------------------------
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.
7
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.
8
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
Fig. 4
$ man openemr
9
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
10
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.
11
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.
12
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.
13
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.
14
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.
15
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.
16
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.
17
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.
18
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.
19
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
20
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
4. Click on the Administration link Æ Others link, from here you can perform other functionalities
like: Language, Forms, Logs and Database related activities.
5. Take your time and continue with the same sequence of getting yourself acquainted with the
openEMR layout and functionalities.
Call us today:
Email: info@gtechsi.org. URL: www.gtechsi.org
21
April 2007, Kefa Rabah, Global Technology Solutions Institute, Vancouver Canada
-----------------------------------------------
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.