/[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

Diff of /doc/upgrade.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1.1.1 by dpavlin, Sat Jul 20 14:46:56 2002 UTC revision 1.3 by dpavlin, Sun Jul 28 13:04:34 2002 UTC
# Line 6  Line 6 
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    
# Line 21  which basically sets just <tt>$gblIncDir Line 81  which basically sets just <tt>$gblIncDir
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>
# Line 41  New preferred way to upgrade is to use C Line 101  New preferred way to upgrade is to use C
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    
# Line 51  password:      [just enter] Line 111  password:      [just enter]
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
Legend:
Removed from v.1.1.1.1  
changed lines
  Added in v.1.3
  ViewVC Help
Powered by ViewVC 1.1.26