Troubleshooting

Contents  Previous 

Troubleshooting


Browser Does not Display KnowledgeTree

If you get a browser error, do the following:

1.ensure that Apache and MySQL are running

 

2.uninstall KnowledgeTree; then, reinstall. Ensure that you are providing the correct path, database, and password information

 

3.check the community websites for known issues, FAQ's, etc. at http://www.knowledgetree.com

 

System message Advises Fatal Error in dispatcher.inc.php; or, Fatal Error in Permission.inc

To resolve this issue:

ensure that MySQL is running;
ensure that the 'dbPort' parameter in config.ini is correct.

 

Calling a Command Line Script Produces Memory Allocation Error

To resolve this issue, edit the php.ini and ensure that the memory_limit is set to -1.

 

File Types of Documents are not Being Resolved Correctly

After adding a document you may notice that the file type is not resolved correctly. This is either because the file is not of a known type, or the path to the file type resolution database is incorrect. To resolve this issue, ensure that the fileinfo extension is installed, and that the magicDatabase setting in the config.ini is correct.

 

Database Incompatible Error Message on Login Page After Upgrading

The database must be upgraded when upgrading the KnowledgeTree installation; failure to upgrade the database prevents login, and a system message advises that the database is incompatible. The Upgrade Installers include a Database Upgrade Wizard to automate database upgrades as part of the system upgrade. For Source Only upgrades, follow the instructions in Upgrade.txt in the Docs directory of the Source Only Package, or check the upgrade instructions on the KnowledgeTree website.

 

Upgrade Failure may be Caused by Incorrect Permissions Settings

When upgrade fails, check that permissions are set correctly - for example, the presence of unwritable log files can cause Upgrades to fail to a non-repairable state. To resolve this issue, please ensure that permissions do not prevent upgrade installs before you start the upgrade.

 

Some Functionality is Not Available After Upgrade

To resolve this issue, is it necessary to always reread the plugin list from the file system after upgrading your KnowledgeTree installation.

 

Upgrading the KnowledgeTree 2.0.7 Database Fails

This issue is due to the documents.full_path referring to a path in the documentRoot that does not exist - the storage location has moved, and 2.0.7 deals with directories differently to the way the upgrade scripts expect it to work. As a result, downloads do not work once the upgrade has been applied. A patch is available at the following location:

http://forge.knowledgetree.com/snippet/detail.php?type=snippet&id=2

 

This code can run on a database that has been upgraded from 2.0.7 to 3.3.x. However, because it does require the system to already be in a 3.3.x state, it is not possible to include it in the Upgrade Scripts - it must be executed as a separate step.

 

Issues When Upgrading KnowledgeTree Versions older than KnowledgeTree 3.4.*

When upgrading KnowledgeTree versions older than Version 3.4 Commercial Edition, a system issue prevents the plugin paths, stored in the database, from seamlessly updating as part of the back up and restore procedure for this type of upgrade. The plugin paths have to be updated in one of the following ways:

 

manually - open the database dump (dump.sql) and edit the paths manually. You could search for all references to the KnowledgeTree path - e.g. for Windows: C:/Program Files/ktdms - and change these to your new path.

 

automatically - if you are sufficiently familiar with MySQL, post a support request to obtain SQL queries for update these paths automatically.

 

 

Don't see what you're looking for? Try the following:

Review the Release Notes for your version for the latest upgrade/install notes.

 

Request assistance from KnowledgeTree Support Commercial Editions Only

Note: See the KnowledgeTree Wiki for more information on Getting Support.

 

Use KnowledgeTree's Issue Management System to request new features, or tell us about an error.

How do I use KnowledgeTree's Issue Management System?

 

Post your questions (and answers) at the KnowledgeTree Community Forum.

 

 


© 2008, 2009 KnowledgeTree Inc. - Document Management Software
This work is licensed under a Creative Commons Attribution 3.0 License.
addThis