INSTALL.txt 3.53 KB
KnowledgeTree Installation Notes
--------------------------------

*  Ensure that you have PHP, MySQL and Apache installed and configured.
   - Check that the following PHP configuration options are set appropriately in php.ini:
		error_reporting  =  E_ALL & ~E_NOTICE
		file_uploads = On
		upload_tmp_dir = C:\PHP\uploadtemp
		upload_max_filesize = 2M
		session.use_cookies = 1
		magic_quotes_gpc = On
		magic_quotes_runtime = Off
		
*  Move the knowledgeTree folder to the directory it is going to be served from:
   $ mv knowledgeTree /path/to/your/html/directory/

*  Create a database:
   $ mysqladmin -p create dms

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

*  Configure your installation by changing the following attributes in config/environment.php:
   - The fileSystemRoot property should point to the directory you installed the KnowledgeTree in eg.
		$default->fileSystemRoot  = "C:\Documents and Settings\michael\Desktop\php\knowledgeTree";
		
   - The serverName property should be the name of the webserver you're accessing the KnowledgeTree from eg.
   		$default->serverName = "localhost";
   		
   - If the KnowledgeTree is not install in the root of your webserver, ie. you access the KnowledgeTree via a URL like 
     http://localhost/knowledgeTree, you must set the rootUrl property appropriately.
     Eg. If your webserver root is "c:\myWebServerRoot" and you install KnowledgeTree into that directory (ie. 
     $default->fileSystemRoot = "c:\myWebServerRoot\knowledgeTree") then you must set your as follows:
        $default->rootUrl  = "/knowledgeTree";
     
   - If your webserver is SSL enabled then set this to true (in most cases this will be false) eg.
        $default->sslEnabled = false;
        
   - Set the database properties to point to your MySQL installation
		$default->dbUser           = "root";
		$default->dbPass           = "pass123";
		$default->dbHost           = "localhost";
		$default->dbName           = "release112";

*  Check permissions on the Documents folder
   - The "/Documents" folder MUST be able to be written to by your web server.
     If your web server is running as user "nobody" and group "nobody" (apache default)
     then cd to the files directory and type:

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

*  Login:
   - in a web browser goto http://$default->serverName/$default->rootUrl/
   - default user is "admin" with password "admin"

*  Setting System Settings:
   - Click on 'Admin'.
   - Select System Settings.
   - Check that the values are the same as the ones in your environment.php
     (Note: If you are not using LDAP you can leave these settings as is)
   - Click 'Update' to save these settings.
   
Troubleshooting
---------------

Refer to docs/FAQ.txt.


Upgrading
---------

In order to upgrade your KnowledgeTree installation, perform the following tasks:
- Run the appropriate database upgrade scripts against your database.  If you are upgrading more than one version, multiple 
  upgrade scripts will need to be executed.
  eg. if you're upgrading from version 1.1.2 to version 1.2.2, the following upgrade scripts need to be executed:
  - sql/mysql/upgrade/1.1.2-to-1.2.0.sql
  - sql/mysql/upgrade/1.2.0-to-1.2.1.sql
  - sql/mysql/upgrade/1.2.1-to-1.2.2.sql
  
-  Upgrade your application code, by unpacking the latest download into your webroot directory.


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

$Id$