Difference between revisions of "OpenEMR 3.1 Linux Installation"

From OpenEMR Project Wiki
(Created page with ''''1.''' Install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5 (PHP4 is also supported). We recommend referring to your specific operating system (OS)…')
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''1.''' Install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5 (PHP4 is also supported).  We recommend referring to your specific operating system (OS) documentation for installation of these software packages.
= Required Software Installation (distribution specific) =


'''2.''' Download OpenEMR from sourceforge:
First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5 (PHP4 is also supported).  We recommend referring to your specific operating system (OS) documentation for installation of these software packages.
 
= Installing OpenEMR =
 
== Extracting the Tarball ==
'''1.''' First, Download OpenEMR from sourceforge:
:http://downloads.sourceforge.net/openemr/openemr-3.1.0.tar.gz <small>(MD5 sum: cd0131762e3e2cee4a7eb04689267467)</small>
:http://downloads.sourceforge.net/openemr/openemr-3.1.0.tar.gz <small>(MD5 sum: cd0131762e3e2cee4a7eb04689267467)</small>




'''3.''' Extract the downloaded archive:
'''2.''' Next, Extract the downloaded archive:
:'''tar -pxvzf openemr-3.1.0.tar.gz'''
:'''tar -pxvzf openemr-3.1.0.tar.gz'''




4. Move the extracted directory openemr-3.1.0 to your webserver root directory, and then go to this directory.  Refer to your OS and webserver documentation to obtain you webserver root directory. For example, Mandriva's webserver root directory is /var/www/html, so in mandriva you would use the following commands:
'''3.''' Move the extracted openemr-3.1.0 directory to your webserver root directory, and then go to this directory.  Refer to your OS and webserver documentation to obtain you webserver root directory. For example, Mandriva's webserver root directory is /var/www/html, so in mandriva you would use the following commands:
:'''mv openemr-3.1.0 /var/www/html/openemr'''
:'''mv openemr-3.1.0 /var/www/html/openemr'''
:'''cd /var/www/html'''
:'''cd /var/www/html'''


Some other common webserver root directories are:
* debian: /var/www/
* the FHS: /srv/www/


'''5.''' Modify file permissions (this should be done as root user):
 
== Cleaning up FileSystem Permissions ==
 
'''1.''' Modify file permissions (this should be done as root user):
:'''chmod 666 openemr/library/sqlconf.php'''
:'''chmod 666 openemr/library/sqlconf.php'''
:'''chmod 666 openemr/interface/globals.php'''
:'''chmod 666 openemr/interface/globals.php'''




'''6.''' Modify directory permissions.  We need to make the following directories writable by the webserver username.  The webserver username is dependent on your OS; "apache", "www-data", and "nobody" are some common examples.  Mandriva's webserver username is "apache", so in mandriva you would use the following commands (this should be done as root user):
'''2.''' Modify directory permissions.  We need to make the following directories writable by the webserver username.  The webserver username is dependent on your OS; "apache", "www-data", and "nobody" are some common examples.  Mandriva's webserver username is "apache", so in mandriva you would use the following commands (this should be done as root user):
:'''chown -R apache:apache openemr/documents'''
:'''chown -R apache:apache openemr/documents'''
:'''chown -R apache:apache openemr/edi'''
:'''chown -R apache:apache openemr/edi'''
Line 30: Line 42:




'''7.''' Open up web-browser and point it to the installation script at: http://localhost/openemr/setup.php
== Configuring the Install through the WEB GUI ==
 
'''1.''' Open up web-browser and point it to the installation script at: http://localhost/openemr/setup.php
:The first screen gives some general instructions and ensures file and directory permissions are set up correctly.  Read and follow the instructions carefully.  If there are errors on this screen, then follow instructions to fix. (screenshot below)
:The first screen gives some general instructions and ensures file and directory permissions are set up correctly.  Read and follow the instructions carefully.  If there are errors on this screen, then follow instructions to fix. (screenshot below)
http://www.sparmy.com/pics/screenshot50_3.jpg
http://www.sparmy.com/pics/screenshot50_3.jpg




:Step 1 ask if you want OpenEMR to create the database.  Read and follow the instructions carefully. (screenshot below)
'''2.''' Step 1 asks if you want OpenEMR to create the database.  Read and follow the instructions carefully. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot51_2.jpg
http://www.sparmy.com/pics/screenshot51_2.jpg




:Step 2 is where you input MySQL database information along with OpenEMR user and OpenEMR path information.  Do not be intimidated by this form.  Most users will just need to enter a "Password", however, read and follow the detailed instructions carefully. (screenshot below)
'''3.''' Step 2 is where you input MySQL database information along with OpenEMR user and OpenEMR path information.  Do not be intimidated by this form.  Most users will just need to enter a "Password", however, read and follow the detailed instructions carefully. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot52_3.jpg
http://www.sparmy.com/pics/screenshot52_3.jpg




:Step 3 configures OpenEMR. (screenshot below)
'''4.''' Step 3 configures OpenEMR. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot53_2.jpg
http://www.sparmy.com/pics/screenshot53_2.jpg




:Step 4 configures access controls (php-GACL). (screenshot below)
'''5.''' Step 4 configures access controls (php-GACL). (screenshot below)<br>
http://www.sparmy.com/pics/screenshot54_2.jpg
http://www.sparmy.com/pics/screenshot54_2.jpg




:Step 5 gives detailed instructions to configure PHP.  Read and follow the instructions carefully.  This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)
'''6.''' Step 5 gives detailed instructions to configure PHP.  Read and follow the instructions carefully.  This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot55_4.jpg
http://www.sparmy.com/pics/screenshot55_4.jpg




:Step 6 gives detailed instructions to configure Apache; it basically involves securing directories that will contain sensitive patient information.  Read and follow the instructions carefully.  This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)
'''7.''' Step 6 gives detailed instructions to configure Apache; it basically involves securing directories that will contain sensitive patient information.  Read and follow the instructions carefully.  This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot56.jpg
http://www.sparmy.com/pics/screenshot56.jpg




:The final installation screen gives additional instructions.  This information is personalized for your computer, so we suggest you print this screen for future reference.  At the bottom of the page is your OpenEMR username and password, along with a link to OpenEMR. (screenshot below)
'''8.''' The final installation screen gives additional instructions.  This information is personalized for your computer, so we suggest you print this screen for future reference.  At the bottom of the page is your OpenEMR username and password, along with a link to OpenEMR. (screenshot below)<br>
http://www.sparmy.com/pics/screenshot57_2.jpg
http://www.sparmy.com/pics/screenshot57_2.jpg


Line 67: Line 81:




== Post-install FileSystem Permission Cleanups ==
'''1.''' After installation is finished, then secure files (this should be done as root user):


'''8.''' After installation is finished, then secure files (this should be done as root user):<br>
:'''chmod 644 openemr/library/sqlconf.php'''
:'''chmod 644 openemr/library/sqlconf.php'''
:'''chmod 644 openemr/interface/globals.php'''
:'''chmod 644 openemr/interface/globals.php'''
Line 77: Line 93:
:'''chmod 600 openemr/sql_upgrade.php'''
:'''chmod 600 openemr/sql_upgrade.php'''
:'''chmod 600 openemr/gacl/setup.php'''
:'''chmod 600 openemr/gacl/setup.php'''
'''ALL DONE'''
Support:<br>
http://sourceforge.net/projects/openemr/forums<br>
Author:<br>
Brady Miller<br>
brady@sparmy.com<br>
http://www.bradymd.com/appliance/

Revision as of 00:21, 12 November 2009

Required Software Installation (distribution specific)

First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5 (PHP4 is also supported). We recommend referring to your specific operating system (OS) documentation for installation of these software packages.

Installing OpenEMR

Extracting the Tarball

1. First, Download OpenEMR from sourceforge:

http://downloads.sourceforge.net/openemr/openemr-3.1.0.tar.gz (MD5 sum: cd0131762e3e2cee4a7eb04689267467)


2. Next, Extract the downloaded archive:

tar -pxvzf openemr-3.1.0.tar.gz


3. Move the extracted openemr-3.1.0 directory to your webserver root directory, and then go to this directory. Refer to your OS and webserver documentation to obtain you webserver root directory. For example, Mandriva's webserver root directory is /var/www/html, so in mandriva you would use the following commands:

mv openemr-3.1.0 /var/www/html/openemr
cd /var/www/html

Some other common webserver root directories are:

  • debian: /var/www/
  • the FHS: /srv/www/


Cleaning up FileSystem Permissions

1. Modify file permissions (this should be done as root user):

chmod 666 openemr/library/sqlconf.php
chmod 666 openemr/interface/globals.php


2. Modify directory permissions. We need to make the following directories writable by the webserver username. The webserver username is dependent on your OS; "apache", "www-data", and "nobody" are some common examples. Mandriva's webserver username is "apache", so in mandriva you would use the following commands (this should be done as root user):

chown -R apache:apache openemr/documents
chown -R apache:apache openemr/edi
chown -R apache:apache openemr/era
chown -R apache:apache openemr/custom/letter_templates
chown -R apache:apache openemr/library/freeb
chown -R apache:apache openemr/gacl/admin/templates_c
chown -R apache:apache openemr/interface/main/calendar/modules/PostCalendar/pntemplates/cache
chown -R apache:apache openemr/interface/main/calendar/modules/PostCalendar/pntemplates/compiled


Configuring the Install through the WEB GUI

1. Open up web-browser and point it to the installation script at: http://localhost/openemr/setup.php

The first screen gives some general instructions and ensures file and directory permissions are set up correctly. Read and follow the instructions carefully. If there are errors on this screen, then follow instructions to fix. (screenshot below)

http://www.sparmy.com/pics/screenshot50_3.jpg


2. Step 1 asks if you want OpenEMR to create the database. Read and follow the instructions carefully. (screenshot below)
http://www.sparmy.com/pics/screenshot51_2.jpg


3. Step 2 is where you input MySQL database information along with OpenEMR user and OpenEMR path information. Do not be intimidated by this form. Most users will just need to enter a "Password", however, read and follow the detailed instructions carefully. (screenshot below)
http://www.sparmy.com/pics/screenshot52_3.jpg


4. Step 3 configures OpenEMR. (screenshot below)
http://www.sparmy.com/pics/screenshot53_2.jpg


5. Step 4 configures access controls (php-GACL). (screenshot below)
http://www.sparmy.com/pics/screenshot54_2.jpg


6. Step 5 gives detailed instructions to configure PHP. Read and follow the instructions carefully. This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)
http://www.sparmy.com/pics/screenshot55_4.jpg


7. Step 6 gives detailed instructions to configure Apache; it basically involves securing directories that will contain sensitive patient information. Read and follow the instructions carefully. This information is personalized for your computer, so we suggest you print this screen for future reference. (screenshot below)
http://www.sparmy.com/pics/screenshot56.jpg


8. The final installation screen gives additional instructions. This information is personalized for your computer, so we suggest you print this screen for future reference. At the bottom of the page is your OpenEMR username and password, along with a link to OpenEMR. (screenshot below)
http://www.sparmy.com/pics/screenshot57_2.jpg


Below is a screenshot of OpenEMR after installation. (screenshot below)

http://www.sparmy.com/pics/screenshot58_2.jpg


Post-install FileSystem Permission Cleanups

1. After installation is finished, then secure files (this should be done as root user):

chmod 644 openemr/library/sqlconf.php
chmod 644 openemr/interface/globals.php
chmod 600 openemr/acl_setup.php
chmod 600 openemr/acl_upgrade.php
chmod 600 openemr/sl_convert.php
chmod 600 openemr/setup.php
chmod 600 openemr/sql_upgrade.php
chmod 600 openemr/gacl/setup.php
Retrieved from "https://www.open-emr.org/wiki/index.php?title=OpenEMR_3.1_Linux_Installation&oldid=7194"