6 |
When designing <a href="new_directory_layout.html">New Directory Layout</a> |
When designing <a href="new_directory_layout.html">New Directory Layout</a> |
7 |
special care has been taken to enable migration from docman v1.x as easy |
special care has been taken to enable migration from docman v1.x as easy |
8 |
as possible. However, you will need to move and edit some files, but most |
as possible. However, you will need to move and edit some files, but most |
9 |
of your existing directory will be left untact (and if fact, it will |
of your existing directory will be left intact (and if fact, it will |
10 |
become |
become |
11 |
<a href="new_directory_layout.html#repository">repository directory</a>, |
<a href="new_directory_layout.html#repository">repository directory</a>, |
12 |
so you will have to remove it from your web server's scope). |
so you will have to remove it from your web server's scope). |
13 |
</p> |
</p> |
14 |
|
|
15 |
|
<h3>Upgrade existing repository</h3> |
16 |
|
|
17 |
|
<p>If your currnet (v1.x) repository is called <tt>/home/httpd/html</tt> and |
18 |
|
new one is <tt>/home/httpd/repository</tt> you would have to do following: |
19 |
|
<small>(this assumes that you are going to use virtual hosts to host new |
20 |
|
repository. If you would rather user path to <tt>docman.php</tt> script |
21 |
|
path to separate installations <a href="#upgrade_path">look below</a>)</small> |
22 |
|
<ul> |
23 |
|
|
24 |
|
<li>move old repository out of web server scope |
25 |
|
<pre> |
26 |
|
mv /home/httpd/html /home/httpd/repository |
27 |
|
</pre> |
28 |
|
|
29 |
|
<li>create new web server exported directory and install docman it it |
30 |
|
<small>(if you keep name <tt>html</tt> you won't need to change |
31 |
|
Apache <tt>httpd.conf</tt>)</small> |
32 |
|
<pre> |
33 |
|
mkdir /home/httpd/html |
34 |
|
ln -s /home/httpd/docman2/docman.php /home/httpd/html/index.php |
35 |
|
ln -s /home/httpd/docman2/html/docman.css /home/httpd/html/docman.css |
36 |
|
</pre> |
37 |
|
You might want to add <tt>index.php</tt> to your Apache |
38 |
|
DirectoryIndex instead of existings <tt>.index.php</tt>. |
39 |
|
|
40 |
|
<li>move files to new realm locations |
41 |
|
<pre> |
42 |
|
mv /home/httpd/html/.docman.conf \ |
43 |
|
/home/httpd/docman2/realm/http_virtual_host.conf |
44 |
|
</pre> |
45 |
|
|
46 |
|
<li>move htusers file |
47 |
|
<pre> |
48 |
|
mv /home/httpd/html/.htusers \ |
49 |
|
/home/httpd/docman2/realm/http_virtual_host.htusers |
50 |
|
</pre> |
51 |
|
|
52 |
|
<li>move include_php file |
53 |
|
(<small><i>optionally</i> if you are using one</small>) |
54 |
|
<pre> |
55 |
|
mv /home/httpd/html/.tree.php \ |
56 |
|
/home/httpd/docman2/realm/http_virtual_host.tree.php |
57 |
|
</pre> |
58 |
|
|
59 |
|
<li>create trustee file |
60 |
|
(<small><i>optionally</i>, also read <a href="trustee.html">trustee |
61 |
|
documentation</a></small>) |
62 |
|
<pre> |
63 |
|
cp /home/httpd/docman2/realm/localhost.trustee \ |
64 |
|
/home/httpd/docman2/realm/http_virtual_host.trustee |
65 |
|
vi /home/httpd/docman2/realm/http_virtual_host.trustee |
66 |
|
</pre> |
67 |
|
</ul> |
68 |
|
</p> |
69 |
|
|
70 |
|
<a name="upgrade_path"> |
71 |
|
<h3>Upgrade v1.x repository to v2.x using script path</h3> |
72 |
|
|
73 |
|
<big>FIX</big> |
74 |
|
|
75 |
<A name="docman_conf"> |
<A name="docman_conf"> |
76 |
<h3>master configuration file</h3> |
<h3>master configuration file</h3> |
77 |
|
|
81 |
of your docman installation. |
of your docman installation. |
82 |
</p> |
</p> |
83 |
<p>This file is by default located at <tt>/etc/docman.conf</tt> and you |
<p>This file is by default located at <tt>/etc/docman.conf</tt> and you |
84 |
can add configration options to it which you want to use on <b>all docman |
can add configuration options to it which you want to use on <b>all docman |
85 |
installtions</b> on that particular machine. |
installations</b> on that particular machine. |
86 |
</p> |
</p> |
87 |
|
|
88 |
<big>FIX</big> |
<big>FIX</big> |
101 |
at <tt>cvs.linux.hr</tt>. This will <b>not</b> overwrite your realm |
at <tt>cvs.linux.hr</tt>. This will <b>not</b> overwrite your realm |
102 |
files, but you should checkout only stable versions (which has tag |
files, but you should checkout only stable versions (which has tag |
103 |
in form <tt>v[major]_[minor]</tt> if current stable docman is |
in form <tt>v[major]_[minor]</tt> if current stable docman is |
104 |
<tt>docman-major.mintor.tar.gz</tt>) if you don't feel adventurous. |
<tt>docman-major.minor.tar.gz</tt>) if you don't feel adventurous. |
105 |
|
|
106 |
<h3>First time check-out</h3> |
<h3>First time check-out</h3> |
107 |
|
|
111 |
$ cvs -d :pserver:anonymous@cvs.linux.hr:/cvsroot co -r2.x docman2 |
$ cvs -d :pserver:anonymous@cvs.linux.hr:/cvsroot co -r2.x docman2 |
112 |
</pre> |
</pre> |
113 |
|
|
114 |
<h3>If you allready have check-out from CVS</h3> |
<h3>If you already have check-out from CVS</h3> |
115 |
|
|
116 |
<pre> |
<pre> |
117 |
$ cd /home/httpd/docman2 |
$ cd /home/httpd/docman2 |