INSTALL

Buderus EMS Webinterface 
(c) 2014 by Michael Moosbauer

THIS IS FREE SOFTWARE! PLEASE SEE THE TERMS AND CONDITIONS
OF THE GENERAL PUBLIC LICENSE IN THE "COPYING"-FILE!

This is the PHP Web Frontend that makes the features of the
ems-collector daemon accessible through HTTP.

This work relies heavily of the ems-collector written by 
Danny Baumann. Thanks to him for his excellent work.

NOTE: This version is NOT designed to be made available in the 
      public internet! PLEASE MAKE SURE THAT ALL FILES ARE
      ONLY ACCESSIBLE IN YOUR LOCAL NETWORK OR IN A PASSWORD-
      PROTECTED ENVIRONMENT! 
      Otherwise any bad guy will be able to reconfigure your
      heating system!!

Installation is not straightforward, as you need an PHP enabled
local webserver. Some experience with PHP-based websites is 
highly recommended.

You need:

1. Working EMS-Tools. If your INSTALL-procedure succeeded there,
   the installation of the web-frontend should be quite easy.

2. You have to ensure that the webserver can write to /tmp and to
   the subdirectory "graph" below your webspace in order to generate
   the graphics. If you changed these dirs, these apply, of course.

3. The webserver must be allowed to execute the scripts in the
   scripts dir of the ems-tools distribution. Either allow the
   server sudo-ing them, or adjust the permissions respectively 
   (remove the sudo in the a_emshk.php then).

4. If you think you are ready, copy the content of the www/ folder in your
   webspace.

5. Adjust the database credentials in sensor_utils.php and in config.php,
   if not yet done.

6. Navigate with your webbrowser to the webspace and open the
    index.php file (if that does not happen automatically).

7. If something does not work, check the webserver log
   for details.