KnowledgeTree Installation Notes
--------------------------------

*  KnowledgeTree requires the following software to run:
   -  Apache 1.3 or above
   -  MySQL 4.0 or above with INNODB support
   -  PHP 4.3.0 or above, but not yet PHP 5.0


*  Move the knowledgeTree folder to the directory it is going to be served from:
   $ mv knowledgeTree /path/to/your/html/directory/


*  Check the pre-installation checkup:

   If your knowledgeTree installation is at http://localhost/, go to:

       http://localhost/setup/

*  Set up the database
   - Create a database:
     $ mysqladmin -p create dms

   - Create and populate the tables:
     $ mysql -p dms < sql/mysql/install/structure.sql
     $ mysql -p dms < sql/mysql/install/data.sql

   - Create the database perfor
     $ mysql -p dms < sql/mysql/install/user.sql


*  Configure your installation in config/environment.php:
   - The default configuration will determine many settings on your
     installation automatically, and this is the preferred method of
     running KnowledgeTree.  Please do not manually set these settings
     unless you know what you are doing.
   - The default configuration uses the database username and password
     in the user.sql file mentioned above, use the local host for the
     database, and use the database named 'dms'.  If you follow the
     examples above in setting up the database, this means KnowledgeTree
     should be fully configured to start working.
   - However, you should change this once you've performed your initial
     evalution of KnowledgeTree for the security of your documents.
   - The following settings in config/environment.php control the
     database connectivity, and can be set as shown:
        $default->dbUser           = "myuser";
        $default->dbPass           = "mypassword";
        $default->dbHost           = "localhost";
        $default->dbName           = "release206";


*  Check permissions on the folders
   - The "Documents" folder in the root of the KnowledgeTree
     installation MUST be able to be written to by your web server.
   - The "log" folder in the root of the KnowledgeTree installation MUST
     be able to be written to by your web server.
   - The pre-configuration checkup will display the user which must be
     able to write to these folders.
   - The remaining folders should preferably not be able to be written
     to by your web server.

   - eg.
     If your web server is running as user "nobody" and group "nogroup"
     then cd to the files directory and type:

     *nix: 'chown -R nobody.nogroup Documents log'
     Windows: Check the permissions and security tabs


*  Check the post-installation checklist:

   If your knowledgeTree installation is at http://localhost/, go to:

       http://localhost/setup/

   And click on "Post-installation checkup".


*  Login:
   - in a web browser go to your KnowledgeTree installation via the web
   - default user is "admin" with password "admin"


Troubleshooting
---------------

Please make sure that your KnowledgeTree installation passes all the
pre- and post-installation checkups first.

Refer to docs/FAQ.txt.

Ask on the KnowledgeTree forums.


Upgrading
---------

Refer to docs/UPGRADE.txt


Jam Warehouse � Smart Business Innovation
Phone: +27 21 4477440
Fax: +27 21 4477449
Email: info@jamwarehouse.com
Web: http://www.jamwarehouse.com/

$Id: INSTALL.txt,v 1.10 2005/06/16 15:55:42 nbm Exp $
