/[docman]/admin.txt
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 /admin.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations)
Tue Mar 27 10:54:02 2001 UTC (21 years, 10 months ago) by dpavlin
Branch: MAIN
CVS Tags: r1_5
Changes since 1.2: +5 -2 lines
File MIME type: text/plain
support for per-site configuration file docman.conf

1 Document Manager Administration manual
2
3
4 INSTALATION INSTRUCTIONS
5 ------------------------
6
7 1. get latest version of Document Manager from
8 http://www.rot13.org/~dpavlin/docman.html
9
10 2. go to installation directory (which doesn't have to be under your web
11 server) and untar distribution
12
13 cd /home/httpd/docman
14 tar xvfz docman-*.tar.gz
15
16 If you decide to install docman in some other directory, change
17 $gblIncDir to that directory in docman.php!
18
19 3. go to directory which you want to have under Document Manager control
20 (this directory needs to be accessable from your web server tree)
21
22 cd /home/httpd/html
23
24 chmod that directory so that web server can write in it.
25
26 chown nobody /home/httpd/html
27
28 4. make a symlink from that directory to file which will be directory index
29
30 ln -s /home/httpd/docman/docman.php /home/httpd/html/.index.php
31
32 5. add new DirectoryIndex entry to your apache configuration file. If your
33 apache has config files in /etc/httpd/conf/httpd.conf find a line
34 like
35
36 DirectoryIndex index.html index.htm
37
38 and add .index.php at the end.
39
40 DirectoryIndex index.html index.htm .index.php
41
42 It is important that new directory index file begins with dot -- that
43 ensures that files won't be visible from Directory Manager interface.
44
45 6. Go to you web server and check if you got autorization request. If you
46 did, you also have .htusers in same directory in which is .index.php
47
48 7. edit .htusers file to add users. You can do that by calling adduser.pl
49 script. If you press just enter for password or enter auth_pop3
50 docman will user e-mail address to connect to pop3 server and check
51 password on it. For that e-mail address must be in following form:
52
53 pop3login@pop3server.mydomain
54
55 E-mail addresses are not used for anything else right now, so it's safe
56 to enter invalid e-mail address it that's valid pop3 account. But, that
57 WILL change, so you are warned!
58
59 8. (optional) You can create file named .info.inc in /home/httpd/html
60 directory for some kind of motd file. You can use html markup in it
61 also!
62
63 9. (optional) Copy docman.conf into /home/httpd/html/.docman.conf and
64 edit values which override default values in docman.php
65
66 10. if you want to upload files which are bigger than 2Mb increase
67 upload_max_filesize to more than 2Mb in php.ini. If you still get
68 errors on files bigger than 8Mb increase post_max_size also.
69
70 You are ready to go.
71
72
73 DIRECTORY AND FILE STRUCTURE
74 ----------------------------
75
76 Breakout of files in /home/httpd/docman/:
77
78 docman.php - main docman php file (to be installed as DirectoryIndex)
79 auth_pop3.php - authorization module ($gblIncDir in docman.php must point
80 to location of this file)
81
82 adduser.pl - perl script for adding of users (you can also add users
83 manually by editing .htusers file)
84
85 docman.txt - user documentation
86 admin.txt - administrator's documentation
87
88 Breakout of files in /home/httpd/html/:
89
90 .changelog - changes of files under docman management
91 .htusers - file with users
92 .info.inc - file with MOTD which is included in interface
93
94 Files in each directory under docman management (some of them may be missing,
95 they will be created automatically):
96
97 .bak/ - directory for backup copies of files
98 .del/ - directory with deleted files
99 .lock/ - directory with lock informations
100 .log/ - directory with changelogs for each file
101 .note/ - directory with notes for files
102
103
104 MISC
105 ----
106
107 You can use document manager behind secure http server (https) simply by
108 installing it. For information take a look at http://www.modssl.org
109

  ViewVC Help
Powered by ViewVC 1.1.26