KnowledgeTree Document Management System On Ubuntu 7.10 Server

This guide will walk you through installing the KnowledgeTree Document Management System on Ubuntu 7.10 Server.  This guide does not include any pictures.  I just felt with this type of install, that they were not warranted.

Please note that this installation is performed on a base install of Ubuntu 7.10.  Since the KnowledgeTree stack installer contains its own versions of Apache and MySQL, it will cause problems on an existing LAMP server.

With that warning out of the way, let's begin.

After you have installed Ubuntu 7.10 Server (remember - a base installation; do not install Apache or MySQL), we need to perform a few steps to get the system ready.

Edit sources.list

In this step, I will edit out the CD-ROM from the sources.list configuration. You do not have to perform this step, I just don't like using the CD for software installations.

sudo nano /etc/apt/sources.list

The section that we are looking for will read:

deb cdrom:[Ubuntu-Server 7.10 _Gutsy Gibbon_ - Release i386 (20071016)]/ gutsy main restricted

Add a "#" in front of that line so that it reads:

# deb cdrom:[Ubuntu-Server 7.10 _Gutsy Gibbon_ - Release i386 (20071016)]/ gutsy main restricted

Press "Ctrl o" to write out the changes and "Ctrl x" to exit nano.

With that done, you need to update sources.list. This can be done by typing:

sudo apt-get update

After the update has finished, you will want to ensure that you have the most recent updates for your server. Run the following command to perform the upgrade:

sudo apt-get upgrade

Finally, you can install openssh-server, so that the rest of the installation can be performed remotely.

sudo apt-get install openssh-server

The rest of this tutorial can be performed remotely using an SSH client, such as PuTTY

In order to use the email functionality with KnowledgeTree, you will want to install an SMTP server. For this guide, I will use Sendmail.

sudo apt-get install sendmail

When prompted, type "y" to install Sendmail and its dependencies. There should be a total of nine packages installed, including:

liblockfile1 m4 make procmail sendmail sendmail-base sendmail-bin sendmail-cf sensible-mda

Obtaining And Installing KnowledgeTree

You are now ready to get the KnowledgeTree installer. I like to work out of the tmp directory for installations such as this. To get there, enter the following command:

cd /tmp/

Use the following command to get the KnowledgeTree installer. At the time of writing this article, the most recent version stood at 3.4.6.

sudo wget http://internap.dl.sourceforge.net/sourceforge/kt-dms/ktdms-oss-3.4.6-linux-installer.bin

Before the installation can begin, you need to change the permissions on the installer to allow it to run. Run the following command:

sudo chmod +x ktdms-oss-3.4.6-linux-installer.bin

With that done, it is time to begin installing KnowledgeTree. To do this, run:

sudo ./ktdms-oss-3.4.6-linux-installer.bin

The following text is how the installation process will play out. You will be prompted during the installation enter information pertinent to your environment. These entries are in red text..

Do you accept this license? [y/n]:
Enter y and press enter
Please specify the directory where KnowledgeTree Document Management System OSS will be installed
Installation directory [/opt/ktdms]: Enter for default
----------------------------------------------------------------------------
MySQL Root Password
Initial password for the DMS root user account
created during the MySQL database installation.
Password : Enter a password of your choosing
Re-enter : Re-enter the same password
----------------------------------------------------------------------------
MySQL User Password
Initial password for the DMS user account
created during the MySQL database installation.
Password : Enter a password of your choosing
Re-enter : Re-enter the same password
----------------------------------------------------------------------------
DB Port
Please enter the port for your MySQL database.
MySQL database Port [3306]: Enter for default
----------------------------------------------------------------------------
WebServer Port
Please enter the port that Apache will listen to by default.
Apache Web Server Port [8080]: Enter for default
----------------------------------------------------------------------------
SSL Support
Do you wish to install SSL support?
Install SSL support [y/n]: This is a personal choice, but since this setup is for home use, I will enter "n", so that SSL is not enabled.
----------------------------------------------------------------------------
Help us make KnowledgeTree a better product
Please help us improve KnowledgeTree by telling us a bit about yourself.We will use this information to more effectively tailor KnowledgeTree for your industry,organization size,and,if you agree,to notify you of news about KnowledgeTree and its family of products.
[1] Yes, I want to register with KnowledgeTree
[2] No, I prefer to skip registration
Please choose an option [1] : Again, this is a personal choice. For the tutorial, I will enter "2" for no.
Please Note: We will not share your information with 3rd parties without your consent nor will we send you information not directly related to KnowledgeTree products and services.Please see our Privacy and Data Retention Policies for more information
----------------------------------------------------------------------------
Setup is now ready to begin installing KnowledgeTree Document Management System OSS on your computer.
Do you want to continue? [Y/n]: "Y" to proceed
----------------------------------------------------------------------------
Setup has finished installing KnowledgeTree Document Management System OSS on your computer.
View Readme file? [Y/n]? Again, this is a personal choice. For the tutorial, I will enter "n" for no.
Open Online Release Notes [Y/n]: Again, this is a personal choice. For the tutorial, I will enter "n" for no.
Launch KnowledgeTree DMS now? [Y/n]: Enter "y" to launch KnowledgeTree

If you are using KnowledgeTree locally, you can open a browser and go to http://127.0.0.1:8080 to reach the dashboard. If you are using KnowledgeTree remotely, you can get to the dashboard by using the server's IP address, such as http://192.168.1.115:8080

The default login information is as follows:
Username: admin
Password: admin

You may also choose your language here, if English (which is the default) is not your native language.

Configure Email Functionality

In order to get the email functionality working, we need to edit the [email] section of the config.ini. Run the following command:

sudo nano /opt/ktdms/config.ini

Enter your password when prompted.

Once you are in the config.ini file, you can easily find the section to edit by using the search function. Press "CTRL W" and on the search line enter:

enter emailServer = none

Now change this to read:

emailServer = /usr/sbin/sendmail

Press "Ctrl o" to write out your changes and "Ctrl x" to exit nano.

Now, if you refresh the KnowledgeTree dashboard, the email warning will be gone.

Starting And Stopping KnowledgeTree

You can control KnowledgeTree with the following commands:

sudo/opt/ktdms/./dmsctl.sh start
sudo /opt/ktdms/./dmsctl.sh stop
sudo /opt/ktdms/./dmsctl.sh restart

I prefer not to have to do this though, so you can add a command to your crontab and have it run automatically on boot. If you would prefer this, use the following command:

sudo crontab -e

Paste the following line into your crontab:

@reboot /opt/ktdms/./dmsctl.sh start

One thing you will notice though, is that KnowledgeTree asks for your MySQL password when starting. To get around this (if security is not a concern), you can edit the dmsctl.sh file in your KnowledgeTree directory.

sudo nano /opt/ktdms/dmsctl.sh

In the dmsctl.sh file, find the following section:

MYSQL_PASSWORD=""

Now change it so that it reads along the following lines:

MYSQL_PASSWORD="MySQL root password you created during the installation"

Press "Ctrl o" to write out your changes and "Ctrl x" to exit nano.

To test and ensure that everything is working as it should be you can reboot and KnowledgeTree should start automatically.

If you want to test this, run the following command:

sudo shutdown -r now

Links For Administration Guides And Assistance

Administration and Configuration
KnowledgeTree Forums
Backing up and restoring KnowledgeTree