Nitix OS v4.x Installation Instructions

From KnowledgeTree Community

Jump to: navigation, search
KnowledgeTree Installation Notes
--------------------------------

*  KnowledgeTree 3 beta works correctly with Nitix 4.x+ with:
   -  Webserver Enabled
   -  MySQL 4.0 or above with INNODB support installed in NVS

*  Create a team for the KnowledgeTree setup ("knowledge" in this example)

*  Move the knowledgeTree folder contents to the team's WWW directory:
   $ mv knowledgeTree/* /home/knowledge/Files/WWW

   or

   Copy files using Samba to \\server\knowledge\WWW\

*  Configure your web server to access the KnowledgeTree system.

   Nitix requires a small modification to the PHP initiation file to work
   correctly with the PATH_INFO based navigation system.

   Create a file called php.ini in \\server\knowledge\ or 
   /home/knowledge/Files/.  In this file, include the line:

   cgi.fix_pathinfo=1

*  Check the pre-installation checkup:

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

       http://localhost/~knowledge/setup/

*  Install NVS in Nitix to allow for a MySQL 4.0+ installation

   - Download the Nitix Virtual Server from http://www.nitix.com/
   - Follow the NVS instructions to install
   - Turn off the Nitix MySQL 3.23 server
   - Download and install the MySQL 4.0+ rpm files
   
*  Configure your installation in config/config.ini:
   - 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:
        [db]
        dbHost           = localhost
        dbName           = release206
        dbUser           = myuser
        dbPass           = mypassword

*  Check permissions on the folders
   - The "var" 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.

   - cd to the Files directory and type:

     'chown -R knowledge:knowledge var'


*  Check the post-installation checklist:

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

       http://localhost/~knowledge/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"


File Indexing
-------------

The file indexing facilities of KnowledgeTree make use of external
programs to perform their jobs.

At the moment, the "catdoc" package
(http://www.45.free.net/~vitus/ice/catdoc/) contains all the external
programs you need.  Installing this package is beyond the scope of this
document - please consult the KnowledgeTree Wiki at
http://support.ktdms.com/confluence/ to see how others have approached
this on your platform. 

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

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

Refer to the Frequently Asked Questions list on the KnowledgeTree Wiki
at http://support.ktdms.com/confluence/

Ask on the KnowledgeTree forums on http://forum.ktdms.com/.

If you have found a bug, please report it to the KnowledgeTree bug
reporting system at http://support.ktdms.com/.

Known Issues
------------

Currently the BETA is presenting problems in some of the navigation.
The following workaround has been found:

Insert the following lines in /config/dmsDefaults.php:

$_SERVER['PATH_INFO'] = $_SERVER['ORIG_PATH_INFO'];
$_SERVER['PHP_SELF'] .= $_SERVER['ORIG_PATH_INFO'];


Upgrading
---------

Refer to docs/UPGRADE.txt



KnowledgeTree Document Management System
Web page: http://www.ktdms.com/
Wiki: http://support.ktdms.com/confluence/
Forums: http://forum.ktdms.com/
Bug reporting: http://support.ktdms.com/

Nitix Web page: http://www.nitix.com/
Nitix Knowledgebase: http://www.nitix.com/kb/
Retrieved from "http://www.knowledgetree.org/Nitix_OS_v4.x_Installation_Instructions"
Personal tools