1 |
<h1>Installation instructions</h1> |
<h1>Installation instructions</h1> |
2 |
|
|
3 |
|
<p><small>Just <a href="upgrade.html">upgrading from v1.x</a> or |
4 |
|
<a href="upgrade.html#cvs">updating to latest v2.x version</a>? |
5 |
|
</small> |
6 |
|
</p> |
7 |
|
|
8 |
<ol> |
<ol> |
9 |
<li>You will need <a href="http://www.apache.org/">Apache</a> web server |
<li>You will need <a href="http://www.apache.org/">Apache</a> web server |
10 |
(it should work with version 1.3 or 2.0, but it's not tested on 2.0) |
(it should work with version 1.3 or 2.0, but it's not tested with 2.0) |
11 |
and <a href="http://www.php.net/">php</a> version 4.x installed and |
and <a href="http://www.php.net/">php</a> version 4.x installed and |
12 |
configured for docman to work. |
configured for docman to work. |
13 |
<small><a href="faq.html#php3">related FAQ question</a></small> |
<small><a href="faq.html#php3">related FAQ question</a></small> |
14 |
<li>Get latest version of Document Manager from |
<li>Get latest version of Document Manager from |
15 |
<a href="http://www.rot13.org/~dpavlin/docman2.html"> |
<a href="http://www.rot13.org/~dpavlin/docman.html"> |
16 |
http://www.rot13.org/~dpavlin/docman2.html</a> |
http://www.rot13.org/~dpavlin/docman.html</a> |
17 |
|
|
18 |
<li>Go to installation directory (which <b>shouldn't be</b> under your web |
<li>Go to installation directory (which <b>shouldn't be</b> under your web |
19 |
server's DocumentRoot) and untar distribution |
server's DocumentRoot) and untar distribution |
36 |
to correct all instructions. |
to correct all instructions. |
37 |
|
|
38 |
<li>Go to directory which you want to have under Document Manager control |
<li>Go to directory which you want to have under Document Manager control |
39 |
(this directory also shouldn't be accessible from your web server tree) |
(this directory also <b>shouldn't be</b> accessible from your web server |
40 |
|
tree) |
41 |
<pre> |
<pre> |
42 |
cd /home/httpd/repository |
cd /home/httpd/repository |
43 |
</pre> |
</pre> |
62 |
<a name="docman_conf"> |
<a name="docman_conf"> |
63 |
<li>Copy docman <a href="upgrade.html#docman_conf">master configuration</a> |
<li>Copy docman <a href="upgrade.html#docman_conf">master configuration</a> |
64 |
file to <tt>/etc/docman.conf</tt>. If you |
file to <tt>/etc/docman.conf</tt>. If you |
65 |
want, you can change location of that file on top of <tt>docman.php</tt> |
want, you can change location of that file (so it's not in <tt>/etc</tt>) |
66 |
|
on top of <tt>docman.php</tt> |
67 |
but that will break automatic cvs update |
but that will break automatic cvs update |
68 |
<small>(see <a href="upgrade.html#cvs">upgrade via CVS</a>)</small> |
<small>(see <a href="upgrade.html#cvs">upgrade via CVS</a>)</small> |
69 |
<pre> |
<pre> |
70 |
cp /home/httpd/docman2/docman.conf /etc/docman.conf |
cp /home/httpd/docman2/docman.conf /etc/docman.conf |
71 |
</pre> |
</pre> |
72 |
You can also enter values for <tt>$fsRealmDir</tt> (normally |
If you haven't installed docman in <tt>/home/httpd/docman2</tt> change |
73 |
|
<tt>$gblIncDir</tt> to your installation directory. |
74 |
|
<br>You can also enter values for <tt>$fsRealmDir</tt> (normally |
75 |
set to <tt>$gblIncDir/realm</tt>) there (and to some location |
set to <tt>$gblIncDir/realm</tt>) there (and to some location |
76 |
which is not your docman installation). |
which is not your docman installation). |
77 |
|
|
93 |
to point to <tt>/home/httpd/http_virtual_host</tt>. |
to point to <tt>/home/httpd/http_virtual_host</tt>. |
94 |
|
|
95 |
<br>How to do that is beyond scope of this document. Please examine |
<br>How to do that is beyond scope of this document. Please examine |
96 |
<a href="http://www.apache.org">Apache documentation</a>. |
<a href="http://httpd.apache.org/docs-project/">Apache documentation</a>. |
97 |
|
|
98 |
<br>If you don't want to use virtual hosts for docman installation, your |
<br>If you don't want to use virtual hosts for docman installation, your |
99 |
realm will be called the same as ServerName. |
realm will be called the same as ServerName. |
114 |
Go to you web server <tt>http://http_virtual_host/</tt> and you should get |
Go to you web server <tt>http://http_virtual_host/</tt> and you should get |
115 |
authorization request. If you want to add |
authorization request. If you want to add |
116 |
<a href="trustee.html#anonymous">anonymous access</a> (without |
<a href="trustee.html#anonymous">anonymous access</a> (without |
117 |
login and password) skip to <a href="#truestee">trustee</a> section. |
login and password) skip to <a href="#trustee">trustee</a> section. |
118 |
|
|
119 |
<br>Edit <tt>realm/http_virtual_host.htusers</tt> file to add users. |
<br>Edit <tt>realm/http_virtual_host.htusers</tt> file to add users. |
120 |
You can do that by calling <tt>adduser.pl</tt> script with name of |
You can do that by calling <tt>adduser.pl</tt> script with name of |
144 |
anymore. This feature is not tested in version 2.0. Look out!</i></p> |
anymore. This feature is not tested in version 2.0. Look out!</i></p> |
145 |
|
|
146 |
<br>Download php-dbi class from |
<br>Download php-dbi class from |
147 |
<a href="http://pil.dk/downloads/dbi.tar.gz"> |
<a href="http://pil.dk/downloads/"> |
148 |
http://pil.dk/downloads/dbi.tar.gz</a> and |
http://pil.dk/downloads/dbi*.tar.gz</a> and |
149 |
untar it in docman's directory |
untar it in docman's directory |
150 |
<pre> |
<pre> |
151 |
cd /home/httpd/docman2 |
cd /home/httpd/docman2 |