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

Annotation of /admin.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (hide annotations)
Tue Mar 27 10:54:02 2001 UTC (23 years 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 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.3 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 dpavlin 1.2 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 dpavlin 1.3 You are ready to go.
71 dpavlin 1.1
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