Difference between revisions of "OpenEMR Development Version Windows Installation"

From OpenEMR Project Wiki
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''1.''' Install and configure MySQL, Apache (or another PHP-capable webserver), and PHP5 (PHP4 is also supported).  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
= Required Software Installation =


'''2.''' Download the daily OpenEMR development version snapshot:
:First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP. 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
:http://opensourceemr.com/cvs/openemr-cvs.zip (MD5SUM of file is [http://opensourceemr.com/cvs/openemr-windows-md5.txt Here].) (Confirm date of snapshot [http://opensourceemr.com/cvs/date-cvs.txt Here].)


'''3.''' Extract the downloaded OpenEMR archive 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 1.7.0, then the webserver root directory is in the \xampp\htdocs directory.
:'''(Ensure PHP is configured with [[FAQ#What_are_the_correct_PHP_settings_.28can_be_found_in_the_php.ini_file.29_.3F|these settings]])'''


'''4.''' Open up web-browser and point it to the installation script at: http://localhost/openemr/setup.php
:''('''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)''


: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)
= Installing OpenEMR =
http://www.sparmy.com/pics/screenshot50_3.jpg


== Downloading the package ==
'''1.''' Download the daily OpenEMR development version snapshot:
:https://six.openemr.io/files/openemr-cvs.zip (MD5SUM of file is [https://six.openemr.io/files/openemr-windows-md5.txt Here].) (Confirm date of snapshot [https://six.openemr.io/files/date-cvs.txt Here].)


:Step 1 ask if you want OpenEMR to create the database. Read and follow the instructions carefully. (screenshot below)
'''2.''' Extract the downloaded OpenEMR archive (ensure the [[unblock zip file on windows|zip file has been unblocked after downloading]]) and then move this directory to your webserver root directoryRefer to your webserver documentation to obtain your webserver root directoryFor example, if your using XAMPP, then the webserver root directory is in the \xampp\htdocs directory.
http://www.sparmy.com/pics/screenshot51_2.jpg
<br>
 
<br>
 
:Step 2 is where you input MySQL database information along with OpenEMR user and OpenEMR path information.  Do not be intimidated by this formMost 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
 
 
:Step 3 configures OpenEMR. (screenshot below)
http://www.sparmy.com/pics/screenshot53_2.jpg
 
 
:Step 4 configures access controls (php-GACL). (screenshot below)
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)
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 informationRead 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
 
 
: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
 


== Configuring the Install through the WEB GUI ==


'''1.''' Open up web-browser and point it to the installation script at http://localhost/openemr .
: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 'Proceed to Step 1' button on the bottom of the form. If it does, Click the 'Proceed to Step 1 button. Otherwise, If there are errors on this screen, then follow instructions to fix. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-1.png|border|link=]]
<br>
<br>
<br>
'''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 'Proceed to Step 2' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-2.png|border|link=]]
<br>
<br>
<br>
'''3.''' The next page is 'OpenEMR Setup' 'Step 2'. It has a list of options used to setup the database, along with OpenEMR user information.
:Most users will just need to enter a 'Password' for the sql user, 'Root Password' for the sql root user, and a 'Initial User Password' for the OpenEMR User. When completed, then click the 'Create DB and User' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-3.png|border|link=]]
<br>
<br>
<br>
'''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, click the 'Proceed to Step 4' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-4.png|border|link=]]
<br>
<br>
<br>
'''5.''' The next page is 'OpenEMR Setup' 'Step 4'. On this page is displayed recommendations of how to configure your php.ini config file.
:Read and follow the instructions carefully. We suggest you print this screen for future reference. Click the 'Proceed to Step 5' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-5.png|border|link=]]
<br>
<br>
<br>
'''6.''' The next page is 'OpenEMR Setup' 'Step 5'. 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 'Proceed to Select a Theme' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-6.png|border|link=]]
<br>
<br>
<br>
'''7.''' The next page is 'OpenEMR Setup' 'Step 6'. This is where select the theme.
:Choose a theme and then click the 'Proceed to Final Step' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-8.png|border|link=]]
<br>
<br>
<br>
'''8.''' The next page is 'OpenEMR Setup' 'Final Step. 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. You can click on the tooltip link at top right of page for more instructions. (screenshot below)
[[File:setup6-9.png|border|link=]]
<br>
<br>
<br>
'''9.''' The first time you see the login page, you will have an opportunity to register in order to receive important announcements, such as security fixes and new release announcements. (screenshot below)
[[File:setup6-10.png|border|link=]]
<br>
<br>
<br>
:OpenEMR login screen: (screenshot below)
[[File:setup6-11.png|border|link=]]
<br>
<br>
'''ALL DONE'''
'''ALL DONE'''




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

Latest revision as of 21:21, 20 December 2022

Required Software Installation

First install and configure MySQL, Apache (or another PHP-capable webserver), and PHP. 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
(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)

Installing OpenEMR

Downloading the package

1. Download the daily OpenEMR development version snapshot:

https://six.openemr.io/files/openemr-cvs.zip (MD5SUM of file is Here.) (Confirm date of snapshot Here.)

2. Extract the downloaded OpenEMR archive (ensure the zip file has been unblocked after downloading) 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 .

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 'Proceed to Step 1' button on the bottom of the form. If it does, Click the 'Proceed to Step 1 button. Otherwise, If there are errors on this screen, then follow instructions to fix. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-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 'Proceed to Step 2' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-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 information.

Most users will just need to enter a 'Password' for the sql user, 'Root Password' for the sql root user, and a 'Initial User Password' for the OpenEMR User. When completed, then click the 'Create DB and User' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-3.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, click the 'Proceed to Step 4' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-4.png


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

Read and follow the instructions carefully. We suggest you print this screen for future reference. Click the 'Proceed to Step 5' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-5.png


6. The next page is 'OpenEMR Setup' 'Step 5'. 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 'Proceed to Select a Theme' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-6.png


7. The next page is 'OpenEMR Setup' 'Step 6'. This is where select the theme.

Choose a theme and then click the 'Proceed to Final Step' button. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-8.png


8. The next page is 'OpenEMR Setup' 'Final Step. 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. You can click on the tooltip link at top right of page for more instructions. (screenshot below)

Setup6-9.png


9. The first time you see the login page, you will have an opportunity to register in order to receive important announcements, such as security fixes and new release announcements. (screenshot below) Setup6-10.png


OpenEMR login screen: (screenshot below)

Setup6-11.png

ALL DONE