/[docman2]/doc/upgrade.html
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Contents of /doc/upgrade.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations)
Sun Jul 28 13:04:34 2002 UTC (21 years, 8 months ago) by dpavlin
Branch: MAIN
CVS Tags: HEAD
Changes since 1.2: +60 -0 lines
File MIME type: text/html
step-by-step upgrade instructions

1 <h1>Upgrade<h1>
2
3 <h2>From docman v1.x</h2>
4
5 <p>
6 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
8 as possible. However, you will need to move and edit some files, but most
9 of your existing directory will be left intact (and if fact, it will
10 become
11 <a href="new_directory_layout.html#repository">repository directory</a>,
12 so you will have to remove it from your web server's scope).
13 </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">
76 <h3>master configuration file</h3>
77
78 <p>New in docman version 2 is master configuration file (
79 <a href="install.html#docman_conf">see installation instructions</a>)
80 which basically sets just <tt>$gblIncDir</tt> which is root directory
81 of your docman installation.
82 </p>
83 <p>This file is by default located at <tt>/etc/docman.conf</tt> and you
84 can add configuration options to it which you want to use on <b>all docman
85 installations</b> on that particular machine.
86 </p>
87
88 <big>FIX</big>
89
90 <p>
91 For now, you will have to examine
92 <a href="new_directory_layout.html">New Directory Layout</a> and
93 <a href="install.html">Installation instructions</a> because this
94 part hasn't been completed yet.
95 </p>
96
97 <a name="cvs">
98 <h2>To latest version from CVS</h2>
99
100 New preferred way to upgrade is to use CVS checkout from repository
101 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
103 in form <tt>v[major]_[minor]</tt> if current stable docman is
104 <tt>docman-major.minor.tar.gz</tt>) if you don't feel adventurous.
105
106 <h3>First time check-out</h3>
107
108 <pre>
109 $ cvs -d :pserver:anonymous@cvs.linux.hr:/cvsroot login
110 password: [just enter]
111 $ cvs -d :pserver:anonymous@cvs.linux.hr:/cvsroot co -r2.x docman2
112 </pre>
113
114 <h3>If you already have check-out from CVS</h3>
115
116 <pre>
117 $ cd /home/httpd/docman2
118 $ cvs update -r2.x
119 </pre>
120

  ViewVC Help
Powered by ViewVC 1.1.26