Upgrading to latest Source Only, Community Edition

This procedure manually upgrades your Source Only, manually installed, KnowledgeTree Community edition installation to the latest version of KnowledgeTree Community edition, using the Source Only package, on generic Windows systems, and on Unix-like operating systems.

Note: KnowledgeTree Source Only packages contain the KnowledgeTree application and installation instructions. You will need to be familiar with installing and configuring all required components.

Warning!

This is an unsupported upgrade. We recommend that you use the KnowledgeTree Community edition stack installer. The Community edition stack installer installs PHP, MySQL, and Apache, and includes the external applications required for running KnowledgeTree Community edition.

Pre-requisites:

Perform the following steps:

Note: The source package is independent of the operating system.

$ mv knowledgeTree /path/to/your/html/directory/

Note: Review your configuration if the pre-checkup script fails.

Unix

Step 1: Create a database

$ mysqladmin -p create dms

Step 2: Create and populate the tables

$ mysql -p dms < sql/mysql/install/structure.sql

$ mysql -p dms < sql/mysql/install/data.sql

Step 3: Create the database users

Note: The database users and passwords must match the ones in the config.ini

$ mysql -p dms < sql/mysql/install/user.sql

Windows

Note: Locate the MySQL applications on your system; then, use the path to these

applications in the commands below.

Step 1: Create a database

x:\> mysqladmin -u root -p create dms

Step 2: Create and populate the tables

X:\> mysql -u root -p dms < sql/mysql/install/structure.sql

X:\> mysql -u root -p dms < sql/mysql/install/data.sql

Step 3: Create the database users

Note: The database users and passwords must match the ones in the config.ini

$ mysql -u root -p dms < sql/mysql/install/user.sql

Default settings are:

[db]

dbHost           = localhost

dbName           = dms

dbUser           = dms

dbPass           = dmspassword

dbPort                  = default

dbAdminUser          = dmsadmin

dbAdminPass          = admin

Note: The installation setup script will not show the account name for

Windows users because there is no commonly available way to do this.

The user needs to know what the account name is.

Unix: ’chown -R nobody.nogroup var'

Windows:  Check the folder’s Permissions and Security tabs (Right click on the

folder; then, select Properties.)

Note: Checkup alerts you to errors. Review the steps above to fix any errors.

Note: A default Admin user – username admin and password admin – is set up during

installation. The default admin user login allows initial access to KnowledgeTree.

This initial login has no relation to the two MySQL accounts created at installation.

Note: KnowledgeTree’s file indexing and other features require the use of external

programs. We recommend that you use the package and configuration management

facilities of your operating environment to install these applications – for example,

using the rpm or apt-get tools on Linux systems. Indexing is automatically installed

when you install KnowledgeTree Community Edition using the Community Edition

Stack Installer. You can download the Community Edition Stack Installer from the

KnowledgeTree website.

Note: For more information on starting OpenOffice as a background task, go to

http://www.openoffice.org.

Unix: E.g.

nohup soffice -headless -invisible -accept='socket,host=localhost,port=8100;urp' &

Windows: E.g.

soffice -headless -invisible -accept='socket,host=localhost,port=8100;urp'

(Change the port as required and ensure that it corresponds with the

config.ini setting.)

Note: Please consult the documentation on Xvbf for more details on usage for your

operating system.

Run /opt/ktdms/knowledgeTree/bin/scheduler.php as a background process:

Unix:  Edit the cron. To do this, add the following:

1 * * * * * /path to php/php -Cq /opt/ktdms/knowledgeTree/bin/scheduler.php

Windows:  Configure the Windows Scheduler to run the script in the

background once a minute.

Unix:

cd /opt/ktdms/knowledgeTree/bin/luceneserver

nohup java -jar ktlucene.jar&

Windows:

Start a command prompt: java -jar ktlucene.jar

Note: This process will fail if the command prompt does not remain active.

Alternative Step: To run the Document Indexer as a background service, use

the JavaService wrapper from http://forge.objectweb.org/projects/javaservice/