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).