PGM3 Installation and Troubleshooting
Webfrontend PGM3 -- Installation and Troubleshooting
Description
Pgm3 is one of the webfrontends of the project FHEM. It is based on PHP. Pgm3 is a part of this project. It does not run without it. Look at http://fhem.de for further descriptions like installing FHEM and the licenses.
Download
pgm3 is included in the subversion of FHEM. Look at http://fhem.de for instructions how to get the current version. pgm3 is NOT included within the function updatefhem of FHEM.
Screenshots
Screenshots including a short description are there: http://martin.htsv.net/fhz/screenshots.html
Installation
It should be very easy to install this webfrontend!
Use the package-manager from your distribution like apt/yast and install the following packages:
-- apache2 -- apache2-mod_php5 -- php5-gd -- php5 -- gd #>= 2.0.1, not needed with debian -- gnuplot
After that create a directory in the home directory of your apache. That ist normally /srv/www/htdocs or /var/www
>> mkdir /srv/www/htdocs/pgm3 or >> mkdir /var/www/pgm3
copy everything from the tree of fhem (included in the fhem-tar)
>> cp -pr fhem/webfrontends/pgm3/* /srv/www/htdocs/pgm3/ or >> cp -pr fhem/webfrontends/pgm3/* /var/www/pgm3/
Think at the rights. Everything should have the rights of your webserver. That is normally wwwrun.www or www-data.www-data
>> chown -R wwwrun.www /srv/www/htdocs/pgm3 or >> chown -R www-data.www-data /var/www/pgm3
Start your apache with e.g.
>> /etc/init.d/apache2 start or >> rcapache2 start
Check the ports and the paths in config.php of pgm3
Point your Browser to e.g. http://localhost/pgm3 and enjoy it :-)
After the first start you will get some pictures with error messages (only for FHT, HMS(T/TF/WD/MG) and KS300). There you can read which entry in the fhem.cfg is needed for the required logfiles (see Screenshots [1] ). You should give pgm3 own logfiles as described on the error messages. Only then you will have everytime a full window. pgm3 will cut the files as described by logrotate in the config.php.
Restart FHEM after changing the fhem.cfg. After a couple of minutes you will see the desired pictures ( see Screenshots).
Look at the other configurations in the config.php for other toys (e.g. tail).
The following devices are automatically supported: FHT, HMS100(T/TF/WD/W/MG/RM100-2), FS20, KS300, WS300, CUL_WS(S300TH). It is possible to install UserDefs, that mean that you can define every other device (or type like Ping-Tests) by yourself.
Troubleshooting
Normally there should be no problems. If something seems to be wrong then check the following:
-- Rights: Everything should have the rights of your webserver. The directory <pgm3>/tmp must be writeable by the webserver. -- type on the console in your working directory "php5 index.php" and "cd include;php5 fs20.php". If there is a php problem or problems with graphic functions then you will get some error messages -- be sure to have the following entry in your /etc/php.ini: extension=gd.so -- some older systems don't find the TrueTypeFonts (no pictures on screen). In this case change in the config.php the path to them (absolut).