KnowledgeTree Community Edition

From wiki.vincentkong.com
Jump to: navigation, search

Paper icon.png Main article: Document Management System

Contents

Installing KnowledgeTree from universal installer

Download from http://sourceforge.net/projects/kt-dms/files/ 

$ tar -zxvf kt-ce-linux-universal-installer-3.7.tgz
$ ./knowledgetree-community.sh

Go to http://localhost/knowledgetree to continue setup.

When finish configuring KnowledgeTree, login using the credentials: admin/admin

Starting KnowledgeTree service

The KnowledgeTree services need to be started to allow for optimal functioning of the search, indexing and pdf generation. To start the services, execute the dmsctl.sh shell script in the KnowledgeTree directory from a terminal. 

cd /usr/share/knowledgetree-ce
sudo ./dmsctl.sh start

Troubleshooting

Packages have unmet dependencies on Ubuntu 10.04 

The following packages have unmet dependencies:
  knowledgetree-ce: Depends: swftools but it is not installable
E: Broken packages

Resolution 

$ add-apt-repository "deb http://archive.canonical.com/ lucid partner"
$ apt-get update

Installing KnowledgeTree from source

PHP extension requirements

  • IconV
  • MySQL
  • cURL
  • XMLRPC
  • Multi Byte Strings
  • LDAP
  • JSON
  • Open SSL

Notepad icon.png Note: Bolded extension were not available by default

Install missing PHP extensions 

$ apt-get install php5-curl
$ apt-get install php5-xmlrpc
$ apt-get install php5-ldap (optional)

Download and extract

Download and extract kt-src-oss-3.7.0.2.tgz from http://sourceforge.net/projects/kt-dms/files/ 

$ mkdir /opt/knowledgtree
$ cd /opt/knowledgetree
$ tar -zxvf kt-src-oss-3.7.0.2.tgz

Setup path and permissions

Set permission with read/write for www-data

  • Configuration File: /opt/knowledgetree/config/config.ini
  • Document Directory: /opt/knowledgetree/var/Documents
  • Log Directory: /opt/knowledgetree/var/log
  • Temporary Directory: /opt/knowledgetree/var/tmp
  • Cache Directory: /opt/knowledgetree/var/cache
  • Uploads Directory: /opt/knowledgetree/var/uploads
  • Var Directory: /opt/knowledgetree/var

Notepad icon.png Note: Defining directories outside of KnowledgeTree home directory doesn't seem to work properly

Change system generate database password

Modify setup/wizard/config/databases.xml

Run KnowledgeTree configuration wizard

After setting up KnowledgeTree inside Apache run http://localhost/knowledgetree from the browser.

Setting up the scheduler

The scheduler takes care of managing and running tasks or batch jobs at regular intervals in the background. To setup add the following to the cron job: 

 */5 * * * * /usr/bin/php /opt/knowledgetree/bin/scheduler.php > /dev/null

Troubleshooting

Errors found in ./var/log/ktYYYY-mm-dd.root.log.txt log.

Output: sh: : Permission denied

Solution: define the php binary in System Administration.

  1. Go to Administration » System Configuration » General Settings » External Binaries
  2. Set Path to binary for php to /usr/bin/php

Connect error: Connection refused

Solution: if using virtual hosting for KnowledgeTree, overwrite Internal Server IP

  1. Go to Administration » System Configuration » General Settings » Server Settings
  2. Set Internal Server IP to virtual domain name e.g. knowledgetree.domain.com

Configuring KnowledgeTree

Disable/enable plugins

Example: To disable Drop Documents Plugin

  1. Log in as Administrator
  2. Click on Administration menu
  3. Click on Miscellaneous » Manage plugins
  4. Uncheck the Drop Documents Plugin check box

Allow anonymous users to log in

  1. Go to Administration  » System Configuration  » General Settings
  2. Check True for the Anonymous Login

Knowledgetree anonymous login.jpg

Make folder readable to anonymous users

For the folder e.g. Public,

  1. Go to Actions on this folder  » Permissions
  2. Click on Edit permission
  3. Add Role:Everyone with Read and Folder Details checked

Knowledgetree folder permission.jpg

Disable AJAX Dashboard

AJAX dashboard allows users to drag the dashlets to change the Dashboard display. Default is 'True'. To disable:

  1. Go to Administration  » System Configuration  » General Settings
  2. Scroll down to KnowledgeTree » Use AJAX Dashboard
  3. Check 'False'

Change custom favicon

Copy the custom favicon.ico to the directories: 

/opt/knowledgetree
/opt/knowledgtree/resources

  1. Go to Administration  » System Configuration  » User Interface Settings
  2. Scroll down to User Interface
  3. Make changes to Company Logo, Company Logo Title, and Company Logo Width

Notepad icon.png Note: Logo height must be 50px tall

Edit ./config/config.ini 

; Main logo
mainLogo = ${rootUrl}/resources/docs_logo.png
; the logo's width in pixels
mainLogoWidth = 300px
; ALT text - for accessibility purposes.
mainLogoTitle = Vincent Kong Knowledge Management Systems
; URL on the main logo
mainLogoUrl = ${rootUrl}

Edit template

Edit ./templates/kt3/standard_page.smarty

Change logging level

  1. Go to Administration » System Configuration » General Settings
  2. Scroll down to KnowledgeTree section

KnowledgeTree WebDAV Server

Log for KTWebDAV not being written

Edit /opt/knowledgetree/ktwebdav/lib/KTWebDAVServer.inc.php. In the function ktwebdavLog change the following: 

$logger = &Log::singleton('file', '../../var/log/ktwebdav-' . date('Y-m-d') . '.txt', $ident, $conf);

to 

global $default;

$logger = &Log::singleton('file', $default->logDirectory . '/ktwebdav-' . date('Y-m-d') . '.txt', $ident, $conf);

NetDrive doesn't work

Problem:

Can't upload, delete, save, change file names using NetDrive.

Solution:

NetDrive doesn't send a USER-AGENT header with request. Edit /lib/KTWebDAVServer.inc.php, change: 

$this->ktwebdavLog("Unknown client. SafeMode needed.", 'info', true);
return false;

to 

if ($this->safeMode == 'off') {
    $this->ktwebdavLog("Unknown client with SafeMode Off.", 'info', true);
    return true;
}
else {
    $this->ktwebdavLog("Unknown client. SafeMode needed.", 'info', true);
    return false;
}

References

Retrieved from "/wiki/KnowledgeTree_Community_Edition"
Personal tools
MY WEBSITES