Gentoo Installation Instructions

From KnowledgeTree Community

Contents 1 Requirements 2 Pre-Installation 3 Installation 4 Post-Install 4.1 Mysql Configure 4.2 webapp-config 4.3 Apache Config 4.4 Edit Config 4.5 Verify Config 4.6 Login 4.7 Enhance Security 5 Post-Upgrade 6 Indexing

Requirements

• From the knowledgetree installation notes for version 3

Note: Apache 1.3 or above MySQL 4.1.6 or above, with InnoDB support PHP 4.3.0 or above, but not yet PHP 5.0

Pre-Installation

• Unmask php4

echo "=dev-lang/php-4.4.4-r6 ~x86" >> /etc/portage/package.keywords

• Unmask knowledgetree

echo "=www-apps/knowledgetree ~x86" >> /etc/portage/package.keywords
echo "=app-text/catdoc ~x86" >> /etc/portage/package.keywords

Installation

1. Emerge Php4 #emerge =php-4.4.4-r6
2. Emerge the Package # emerge knowledgetree
3. Emerge catdoc # emerge catdoc
4. Emerge pstotext # emerge pstotext - Note: Must have "X" set in USE variable in /etc/make.conf

Post-Install

Mysql Configure

1. Follow the instructions on this wiki, to tune MySQL
2. Start mysql # /etc/init.d/mysql start
3. Set your mysql password $ mysqladmin -uroot password put a new secure password here!
4. Login to mysql mysql -uroot -p
5. Create a database: $ mysqladmin -p create dms;
6. Create and populate the tables: $ mysql -uroot -p dms < /var/www/localhost/htdocs/knowledgetree/sql/mysql/install/structure.sql
7. The default permissions given to the users in user.sql are far too liberal. Edit the file, replacing the '*' with 'dms.*' # vi /var/www/localhost/htdocs/knowledgeTree/sql/mysql/install/user.sql
8. Create the users schema $ mysql -uroot -p dms < /var/www/localhost/htdocs/knowledgetree/sql/mysql/install/user.sql
9. Create the data schema $ mysql -uroot -p dms < /var/www/localhost/htdocs/knowledgetree/sql/mysql/install/data.sql

webapp-config

• Install gallery using webapp-config

webapp-config -I -s <http_server> -h <installation_host> -d <installation_dir> --user=<owner> <what_to_install>

• A short explanation of webapp-config's parameters
• -I - install
• -s - <http_server>
  • Use webapp-config --list-servers to see supported web servers.
• -h - <installation host>
  • which vhost to install onto
• -d <installation_dir>
  • what directory to install to, this will result in vhost/htdocs/installation_dir
• --user=<owner>
  • the user owning the gallery
• <what to install>
  • what application to install
• --pretend
  • use pretend at first to verify that you haven't mocked something up
• So, as root execute the command as you choose.

Apache Config

• Create a directory configuration for knowledgeTree in Apache (This gives .htaccess files in the knowledgeTree folder the ability to run any apache runtime configuration directive!) # vi /etc/httpd/conf.d/knowledgeTree.conf

Add the following lines and save/quit:

<Directory "/var/www/localhost/htdocs/knowledgetree">
AllowOverride All
</Directory>

Edit Config

• Update the [email] section, setting the emailServer variable equal to your organization's SMTP server
• Update the paths in the [indexer] section
  • xls2csv = /usr/local/bin/xls2csv
  • pdftotext = /usr/bin/pdftotext
  • catppt = /usr/local/bin/catppt
  • pstotext = /usr/bin/pstotext
  • catdoc = /usr/local/bin/catdoc

• As long as you are at it, following this article to help keep your application secure

Verify Config

• Browse to the checkup page and make sure everything is green http://localhost/knowledgetree/setup

Login

• Log in to knowledgeTree and change the admin password http://localhost/knowledgeTree

User: admin
Pass: admin

Enhance Security

• Move Sensitive Files
• Review the Security Primer

Post-Upgrade

If you upgrade from the 2.0.7 version that has been available on Gentoo you will also get the appropriate upgrade instructions by webapp-config

• Please do not forget to backup your database befor you upgrade!*

The upgrade process is not guaranteed to give you a fully upgraded database.

Indexing

Portage handles the dependencies. So 'catdoc', 'catppt', as well as 'pstotext' will be installed prior to knowledgetree if they were not available on the system.