$Header: /cvsroot/phptsmadmin/phpTSMadmin/INSTALL,v 1.5 2008/01/15 10:50:41 wurley Exp $

* Requirements

  phpTSMadmin is a PHP5 application. It wont work on PHP4. If you are using CentOS 4 or RedHat
  Enterprise Linux v4, then you can get PHP5 from the centosplus repository.

  The requirements below are those used by RedHat Enterprise Linux v5.0 system. It is quite
  possible that other versions of these components, or other distributions of Linux will also
  work as well.

  If you encounter any problems with other versions, then drop us an email with
  the error messages, what you did and what you expected, and if we need to make some code changes
  to get it to work, then we'll take a look.

  * Apache 2.0.x
  * PHP 5.1.x
  * TSM Client 5.x (our tests were done on a 5.4.1 TSM server).

* Additional Requirements that are optional.

  We also use a fantastic tool called JpGraph, that takes care of the Gantt charts. It is recommended that
  you download and install that tool. You can get JpGraph at:

  http://www.aditus.nu/jpgraph

  You'll need at least v2.x our testing was with 2.3.

  Once downloaded, untar jpgraph in the libs directory, then update your config.php to reflect the path.

* Installation

  These steps assume that you have installed, configured and running:
  * Linux server,
  * Apache installed, configured and running,
  * PHP installed, configured if necessary and running with apache,
  * TSM client installed, configured and working.
  * JpGraph (if you choose to use it - which you should).

  1. Download the latest version.
     You can download phpTSMadmin from sourceforge. http://phpTSMadmin.sf.net

  2. Unpack the tar files in an appropriate directory.
     cd /var/www/phpTSMadmin (or any other directory that you choose)
     tar xzf phpTSMadmin-XXXX.tgz

  3. Configure your webserver.
     Find the sample apache config file in the contrib directory. Place that in
     your /etc/httpd/conf.d directory.

     Edit the sample apache config file as appropriate and restart your web server.

     Also make sure that in your php.ini configuration file, you have set "memory_limit" to
     at leat 16M. If this is set too low, then your grantt charts will fail to be created
     and your apache error log will have "Allowed memory size of X bytes exhausted" error
     messages.

  4. Copy config.php.example in the config directory to config/config.php and edit to
     suite your environment.
     Edit the phpTSMadmin's config.php file, making sure you define:
     * TSM client configuration
     * Jpgraph path

  5. Make the following directories.
     mkdir htdocs/tmp; chmod 777 htdocs/tmp

  6. Then, point your browser to your phpTSMadmin URL.

* For help
  Drop me an email phptsmadmin-devel@lists.sourceforge.net.
