Difference between revisions of "OpenEMR 4.1 Windows Installation"

From OpenEMR Project Wiki
 
(7 intermediate revisions by 2 users not shown)
Line 2: Line 2:


First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5.  Many windows users have had success with the XAMPP package, which includes MySQL, Apache, and PHP.  XAMPP can be downloaded from: http://www.apachefriends.org/en/xampp-windows.html
First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5.  Many windows users have had success with the XAMPP package, which includes MySQL, Apache, and PHP.  XAMPP can be downloaded from: http://www.apachefriends.org/en/xampp-windows.html
(<b>use [http://tenet.dl.sourceforge.net/project/xampp/XAMPP%20Windows/1.7.3/xampp-win32-1.7.3.exe XAMPP version 1.7.3] or less; OpenEMR is not compatible with 1.7.4.</b>)
:*(<b>use [http://tenet.dl.sourceforge.net/project/xampp/XAMPP%20Windows/1.7.3/xampp-win32-1.7.3.exe XAMPP version 1.7.3] or less; OpenEMR is not compatible with 1.7.4 or greater</b>)
 
:*(<b>if using WampServer,then recommend WampServer version 2.0; OpenEMR is not compatible with versions greater than 2.0</b>)
:'''(Ensure PHP is configured with [[FAQ#What_are_the_correct_PHP_settings_.28can_be_found_in_the_php.ini_file.29_.3F|these settings]])'''
:*'''(Ensure PHP is configured with [[FAQ#What_are_the_correct_PHP_settings_.28can_be_found_in_the_php.ini_file.29_.3F|these settings]])'''
 
:*''('''If not using the XAMPP package''', then ensure when configuring MySQL for OpenEMR, STRICT_MODE must be disabled.  This can be done using the MySQL Server Instance Configuration wizard or in the my.cnf file.  You can check the setting in an existing MySQL instance by executing '''SHOW VARIABLES;''' in the MySQL Command Line Client and checking the value of SQL_MODE.  For more details see: http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html)''
:''('''If not using the XAMPP package''', then ensure when configuring MySQL for OpenEMR, STRICT_MODE must be disabled.  This can be done using the MySQL Server Instance Configuration wizard or in the my.cnf file.  You can check the setting in an existing MySQL instance by executing '''SHOW VARIABLES;''' in the MySQL Command Line Client and checking the value of SQL_MODE.  For more details see: http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html)''
:*'''If using php version 5.4+, ensure you also install the most recent [[OpenEMR_Patches|OpenEMR Patch]] after installation.'''


= Installing OpenEMR =
= Installing OpenEMR =
Line 29: Line 29:


'''3.''' The next page is 'OpenEMR Setup' 'Step 2'. It has a list of options used to setup the database, along with OpenEMR user and OpenEMR path information.
'''3.''' The next page is 'OpenEMR Setup' 'Step 2'. It has a list of options used to setup the database, along with OpenEMR user and OpenEMR path information.
:Most users will just need to enter a 'Initial User Password' for the OpenEMR User and a 'Password' for the sql user(these fields are circled in red in below screenshot). Some users may also have to enter the password of the 'root' user in the mysql server. (screenshot below)
:Most users will just need to enter a 'Initial User Password' for the OpenEMR User and a 'Password' for the sql user(these fields are in red rectangles in below screenshot). Some users may also have to enter the password of the 'root' user in the mysql server. (screenshot below)
[[File:Install-V4_0-3.png|link=]]
[[File:V4.0 5.png|link=]]




Line 60: Line 60:
:OpenEMR after installation: (screenshot below)
:OpenEMR after installation: (screenshot below)
[[File:Login-V4_0-1.png|link=]]
[[File:Login-V4_0-1.png|link=]]


== Download and install most recent patch ==
== Download and install most recent patch ==
Instruction to do this can be found on the [[OpenEMR_Patches|OpenEMR Patches]] page.
Instruction to do this can be found on the [[OpenEMR_Patches|OpenEMR Patches]] page.


<br>
= Using OpenEMR =
:See the [[OpenEMR_4.1_Users_Guide|OpenEMR 4.1 User Guide]]
<br>


Support:<br>
Support:<br>
http://sourceforge.net/projects/openemr/forums
http://sourceforge.net/projects/openemr/forums
[[Category:Installation]][[Category:Windows Package]]

Latest revision as of 22:25, 11 January 2015

Required Software Installation

First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5. Many windows users have had success with the XAMPP package, which includes MySQL, Apache, and PHP. XAMPP can be downloaded from: http://www.apachefriends.org/en/xampp-windows.html

  • (use XAMPP version 1.7.3 or less; OpenEMR is not compatible with 1.7.4 or greater)
  • (if using WampServer,then recommend WampServer version 2.0; OpenEMR is not compatible with versions greater than 2.0)
  • (Ensure PHP is configured with these settings)
  • (If not using the XAMPP package, then ensure when configuring MySQL for OpenEMR, STRICT_MODE must be disabled. This can be done using the MySQL Server Instance Configuration wizard or in the my.cnf file. You can check the setting in an existing MySQL instance by executing SHOW VARIABLES; in the MySQL Command Line Client and checking the value of SQL_MODE. For more details see: http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html)
  • If using php version 5.4+, ensure you also install the most recent OpenEMR Patch after installation.

Installing OpenEMR

Downloading the package

1. Download OpenEMR from sourceforge:

http://downloads.sourceforge.net/openemr/openemr-4.1.0.zip (MD5 sum: 2f76afe5abd1eeb9f161c6aaff096098)

2. Extract the downloaded OpenEMR archive, change the name of the directory openemr-4.1.0 to just openemr, and then move this directory to your webserver root directory. Refer to your webserver documentation to obtain your webserver root directory. For example, if your using XAMPP, then the webserver root directory is in the \xampp\htdocs directory.

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. It should tell you all your file system permissions are good, and have a 'Continue' button on the bottom of the form. If it does, Click the 'Continue' button. Otherwise, If there are errors on this screen, then follow instructions to fix. (screenshot below)

Install-V4 0-1.png


2. The next page is 'OpenEMR Setup' 'Step 1', which asks whether setup should create the database.

Leave the setting set to 'Have setup create the database', and click the 'Continue' button. (screenshot below)

Install-V4 0-2.png


3. The next page is 'OpenEMR Setup' 'Step 2'. It has a list of options used to setup the database, along with OpenEMR user and OpenEMR path information.

Most users will just need to enter a 'Initial User Password' for the OpenEMR User and a 'Password' for the sql user(these fields are in red rectangles in below screenshot). Some users may also have to enter the password of the 'root' user in the mysql server. (screenshot below)

V4.0 5.png


4. The next page is 'OpenEMR Setup' 'Step 3'. On this page you should see logs of OpenEMR connecting and creating the database.

At the bottom of the page, it should read 'Next step will install and configure access controls (php-GACL).' Click the 'Continue' button. (screenshot below)

Install-V4 0-4.png


5. The next page is 'OpenEMR Setup' 'Step 4'. On this page, OpenEMR configures access controls (php-GACL).

You should see logs of OpenEMR installing and configuring php-GACL. you should see 'Success!' in green lettering four times. At the bottom of the page, it should read 'Next step will configure PHP.'. Click the 'Continue' button. (screenshot below)

Install-V4 0-5.png


6. The next page is 'OpenEMR Setup' 'Step 5'. On this page is displayed recommendations of how to configure your php.ini config file.

Read and follow the instructions carefully. At the bottom of the page, it should read "Next step will configure Apache web server.". We suggest you print this screen for future reference. Click the 'Continue' button. (screenshot below)

Install-V4 0-6.png


7. The next page is 'OpenEMR Setup' 'Step 6'. On this page is displayed recommendations and warnings regarding directories Apache should NOT allow the outside world to see, as these directories contain Protected Health Information.

Read and follow the instructions carefully. We suggest you print this screen for future reference. Click the 'Continue' button. (screenshot below)

Install-V4 0-7.png


8. The next page is 'OpenEMR Setup'. This is the final configuration page.

This final installation screen gives additional instructions. This information is personalized for your setup, 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)

Install-V4 0-8.png


OpenEMR after installation: (screenshot below)

Login-V4 0-1.png

Download and install most recent patch

Instruction to do this can be found on the OpenEMR Patches page.


Using OpenEMR

See the OpenEMR 4.1 User Guide


Support:
http://sourceforge.net/projects/openemr/forums