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. (if you don't want to users in SQL database) Go to you web server and |
46 |
check if you got autorization request. If you did, you also have |
47 |
.htusers in same directory in which is .index.php |
48 |
|
49 |
edit .htusers file to add users. You can do that by calling adduser.pl |
50 |
script. If you press just enter for password or enter auth_pop3 |
51 |
docman will user e-mail address to connect to pop3 server and check |
52 |
password on it. For that e-mail address must be in following form: |
53 |
|
54 |
pop3login@pop3server.mydomain |
55 |
|
56 |
E-mail addresses are not used for anything else right now, so it's safe |
57 |
to enter invalid e-mail address it that's valid pop3 account. But, that |
58 |
WILL change, so you are warned! |
59 |
|
60 |
7. (alternative to 6 if your users are in SQL database) change $gblUsers |
61 |
in .docman.conf to $gblUsers = "htusers_sql"; |
62 |
|
63 |
Download php-dbi class from http://pil.dk/downloads/dbi.tar.gz and |
64 |
untar it in docman's directory |
65 |
|
66 |
cd /home/html/docman |
67 |
tar xvfz dbi.tar.gz |
68 |
|
69 |
Construct SQL query which returns login, full name, password and |
70 |
email from your tables(s). If you don't have some of that data, replace |
71 |
them with literal strings. |
72 |
|
73 |
e.g. if your table is called my_users with columns who in which |
74 |
is login and column pw in which is plain text password you |
75 |
can use following query to get requested format: |
76 |
select who,'Auth user',pw,'nobody@com' from my_users |
77 |
|
78 |
Enter that SQL query under $dbi_sql in .docman.conf |
79 |
|
80 |
Construct $dbi in .docman.conf in following format: |
81 |
|
82 |
$dbi = "driver:database:user:password" |
83 |
|
84 |
driver can be: pgsql, mysql, oracle or odbc (as supported by php-dbi), |
85 |
database is name of database in which are your users and user/password |
86 |
is credentials for user which connects to database |
87 |
|
88 |
8. (optional) You can create file named .info.inc in /home/httpd/html |
89 |
directory for some kind of motd file. You can use html markup in it |
90 |
also! |
91 |
|
92 |
9. (optional) Copy docman.conf into /home/httpd/html/.docman.conf and |
93 |
edit values which override default values in docman.php |
94 |
|
95 |
10. if you want to upload files which are bigger than 2Mb increase |
96 |
upload_max_filesize to more than 2Mb in php.ini. If you still get |
97 |
errors on files bigger than 8Mb increase post_max_size also. |
98 |
|
99 |
You are ready to go. |
100 |
|
101 |
|
102 |
DIRECTORY AND FILE STRUCTURE |
103 |
---------------------------- |
104 |
|
105 |
Breakout of files in /home/httpd/docman/: |
106 |
|
107 |
docman.php - main docman php file (to be installed as DirectoryIndex) |
108 |
|
109 |
docman.conf - configuration file which will be copied in document |
110 |
root of site |
111 |
|
112 |
auth_pop3.php - authorization module ($gblIncDir in docman.php must point |
113 |
to location of this file) |
114 |
|
115 |
htusers_file.php - module for access to users in .htusers files |
116 |
htusers_sql.php - module for access to users which are in SQL database |
117 |
|
118 |
adduser.pl - perl script for adding of users (you can also add users |
119 |
manually by editing .htusers file) |
120 |
|
121 |
docman.txt - user documentation |
122 |
admin.txt - administrator's documentation |
123 |
|
124 |
contrib/ - directory with optional usefull scripts |
125 |
|
126 |
dbi/ - optional directory for dbi classes is users are stored |
127 |
in SQL database, it will be created after unpacking of |
128 |
http://pil.dk/downloads/dbi.tar.gz |
129 |
|
130 |
Breakout of files in /home/httpd/html/ (root directory of site under docman |
131 |
management): |
132 |
|
133 |
.changelog - changes of files under docman management |
134 |
.htusers - file with users |
135 |
.info.inc - file with MOTD which is included in interface |
136 |
.docman.conf - configuration file for this site |
137 |
|
138 |
Files in each directory under docman management (some of them may be missing, |
139 |
they will be created automatically): |
140 |
|
141 |
.bak/ - directory for backup copies of files |
142 |
.del/ - directory with deleted files |
143 |
.lock/ - directory with lock informations |
144 |
.log/ - directory with changelogs for each file |
145 |
.note/ - directory with notes for files |
146 |
|
147 |
|
148 |
MISC |
149 |
---- |
150 |
|
151 |
You can use document manager behind secure http server (https) simply by |
152 |
installing it. For information take a look at http://www.modssl.org |
153 |
|