INSTALL.txt
5.52 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
KnowledgeTree Installation Notes
--------------------------------
* KnowledgeTree requires the following software to run:
- 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
* Move the knowledgeTree folder to the directory it is going to be served from:
$ mv knowledgeTree /path/to/your/html/directory/
* Configure your web server to access the KnowledgeTree system.
Due to the many different configuration possibilities, these can not
all be discussed here. Please consult the KnowledgeTree Wiki system
at http://wiki.knowledgetree.com/ to see what others have done
on your platform, and discuss the pros and cons of various options on
the KnowledgeTree Forums at http://forums.knowledgetree.com/
* Check the pre-installation checkup:
If your knowledgeTree installation is at http://localhost/, go to:
http://localhost/setup/
* Set up the database
On a Unix-like system, the command line tools can generally be used:
- Create a database:
$ mysqladmin -p create dms
- Create and populate the tables:
$ mysql -p dms < sql/mysql/install/structure.sql
$ mysql -p dms < sql/mysql/install/data.sql
- Create the database users
$ mysql -p dms < sql/mysql/install/user.sql
These tools may requite the setting of the user (-u username) and of
a password (-p, and you will be asked for the password).
Using other tools is beyond the scope of this document. Consult the
KnowledgeTree Wiki at http://wiki.knowledgetree.com/ to see how
others have approached this on your platform.
* Configure your installation in config/config.ini:
- The default configuration will determine many settings on your
installation automatically, and this is the preferred method of
running KnowledgeTree. Please do not manually set these settings
unless you know what you are doing.
- The default configuration uses the database username and password
in the user.sql file mentioned above, use the local host for the
database, and use the database named 'dms'. If you follow the
examples above in setting up the database, this means KnowledgeTree
should be fully configured to start working.
- However, you should change this once you've performed your initial
evalution of KnowledgeTree for the security of your documents.
- The following settings in config/config.ini control the
database connectivity, and can be set as shown:
[db]
dbHost = localhost
dbName = dms
dbUser = myuser
dbPass = mypassword
* Check permissions on the folders
- The "var" folder in the root of the KnowledgeTree
installation MUST be able to be written to by your web server.
- The pre-configuration checkup will display the user which must be
able to write to these folders.
- The remaining folders should preferably not be able to be written
to by your web server.
- eg.
If your web server is running as user "nobody" and group "nogroup"
then cd to the files directory and type:
*nix: 'chown -R nobody.nogroup var'
Windows: Check the permissions and security tabs
* Check the post-installation checklist:
If your knowledgeTree installation is at http://localhost/, go to:
http://localhost/setup/
And click on "Post-installation checkup".
* Login:
- in a web browser go to your KnowledgeTree installation via the web
- default user is "admin" with password "admin"
* Register the standard plugins.
- in a web browser go to "DMS Administration" , then "Miscellaneous",
then "Manage Plugins"
- click "Reread plugins" to load the list of available plugins.
- enable the plugins as required.
* Please note: *
Fulltext indexing of files (e.g. checking their contents) needs to be
activated from this menu or the full-text search WILL NOT work.
External applications
---------------------
The file indexing and other facilities of KnowledgeTree make use of
external applications to perform their jobs.
For the Windows platform, these are:
. catdoc - http://www.45.free.net/~vitus/ice/catdoc/
. xpdf - http://www.foolabs.com/xpdf/
. InfoZip unzip and zip - http://www.info-zip.org/
Installing these packages is beyond the scope of this document - please
consult the KnowledgeTree Wiki at http://wiki.knowledgetree.com/
to see how others have approached this on your platform. We recommend
that you use the appropriate package management procedures for
installing these packages on your system to ensure ease of maintenance
and upgrade.
NOTE: if you install the packages outside of the path normally searched
by your operating system (e.g. in c:\antiword or /usr/local/bin) you will
need to specify the _full_ path to the actual applications (e.g.
/usr/local/bin/pdftotext).
Troubleshooting
---------------
Please make sure that your KnowledgeTree installation passes all the
pre- and post-installation checkups first.
Refer to the Frequently Asked Questions list on the KnowledgeTree Wiki
at http://wiki.knowledgetree.com/
Ask on the KnowledgeTree forums on http://forums.knowledgetree.com/.
If you have found a bug, please report it to the KnowledgeTree bug
reporting system at http://issues.knowledgetree.com/.
Upgrading
---------
Refer to docs/UPGRADE.txt
KnowledgeTree Document Management System
Web page: http://www.knowledgetree.com/
Wiki: http://wiki.knowledgetree.com/
Forums: http://forums.knowledgetree.com/
Bug reporting: http://issues.knowledgetree.com/
$Id$