1 |
dpavlin |
1.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 |
dpavlin |
1.2 |
9. if you want to upload files which are bigger than 2Mb increase |
64 |
|
|
upload_max_filesize to more than 2Mb in php.ini. If you still get |
65 |
|
|
errors on files bigger than 8Mb increase post_max_size also. |
66 |
|
|
|
67 |
|
|
10. You are ready to go. |
68 |
dpavlin |
1.1 |
|
69 |
|
|
|
70 |
|
|
DIRECTORY AND FILE STRUCTURE |
71 |
|
|
---------------------------- |
72 |
|
|
|
73 |
|
|
Breakout of files in /home/httpd/docman/: |
74 |
|
|
|
75 |
|
|
docman.php - main docman php file (to be installed as DirectoryIndex) |
76 |
|
|
auth_pop3.php - authorization module ($gblIncDir in docman.php must point |
77 |
|
|
to location of this file) |
78 |
|
|
|
79 |
|
|
adduser.pl - perl script for adding of users (you can also add users |
80 |
|
|
manually by editing .htusers file) |
81 |
|
|
|
82 |
|
|
docman.txt - user documentation |
83 |
|
|
admin.txt - administrator's documentation |
84 |
|
|
|
85 |
|
|
Breakout of files in /home/httpd/html/: |
86 |
|
|
|
87 |
|
|
.changelog - changes of files under docman management |
88 |
|
|
.htusers - file with users |
89 |
|
|
.info.inc - file with MOTD which is included in interface |
90 |
|
|
|
91 |
|
|
Files in each directory under docman management (some of them may be missing, |
92 |
|
|
they will be created automatically): |
93 |
|
|
|
94 |
|
|
.bak/ - directory for backup copies of files |
95 |
|
|
.del/ - directory with deleted files |
96 |
|
|
.lock/ - directory with lock informations |
97 |
|
|
.log/ - directory with changelogs for each file |
98 |
|
|
.note/ - directory with notes for files |
99 |
|
|
|
100 |
|
|
|
101 |
|
|
MISC |
102 |
|
|
---- |
103 |
|
|
|
104 |
|
|
You can use document manager behind secure http server (https) simply by |
105 |
|
|
installing it. For information take a look at http://www.modssl.org |
106 |
|
|
|