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

Diff of /admin.txt

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

revision 1.3 by dpavlin, Tue Mar 27 10:54:02 2001 UTC revision 1.5 by dpavlin, Wed Sep 26 21:33:09 2001 UTC
# Line 42  INSTALATION INSTRUCTIONS Line 42  INSTALATION INSTRUCTIONS
42     It is important that new directory index file begins with dot -- that     It is important that new directory index file begins with dot -- that
43     ensures that files won't be visible from Directory Manager interface.     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  6a. (if you don't want to users in SQL database) Go to you web server and
46     did, you also have .htusers in same directory in which is .index.php     check if you got autorization request. If you did, you also have
47       .htusers in same directory in which is .index.php
48    
49  7. edit .htusers file to add users. You can do that by calling adduser.pl     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     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     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:     password on it. For that e-mail address must be in following form:
# Line 56  INSTALATION INSTRUCTIONS Line 57  INSTALATION INSTRUCTIONS
57     to enter invalid e-mail address it that's valid pop3 account. But, that     to enter invalid e-mail address it that's valid pop3 account. But, that
58     WILL change, so you are warned!     WILL change, so you are warned!
59    
60  8. (optional) You can create file named .info.inc in /home/httpd/html  6b. (alternative to 6a 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    6c. (alternative to 6b you want to authorize users based on IP numbers,
89       client DNS names of HTTP Referarer header (URL from which they accessed
90       docman site). Put $gblUsers = "htusers_header"; in .docman.conf use
91       following form in your .htusers file:
92    
93       REMOTE_ADDR=10.0.0.3:Full name:auth_header:e-mail@foo.bar
94       remote_hostname=myworkstation:Full name:auth_header:e-mail@foo.bar
95       http_referer=test.foo.bar:Full name:auth_header:e-mail@foo.bar
96    
97       Please note that you *have to* put "auth_header" in password field
98       and that valid options for left side of = in login field are:
99       remote_addr, remote_hostname or http_referer.
100    
101    6d. (if you want some combination of 6a, 6b and/or 6c) put in .docman.conf
102       $gblUsers = "htusers_union" and uncomment which htusers auth modules
103       you want to use and in which order
104    
105    7. (optional) You can create file named .info.inc in /home/httpd/html
106     directory for some kind of motd file. You can use html markup in it     directory for some kind of motd file. You can use html markup in it
107     also!     also!
108    
109  9. (optional) Copy docman.conf into /home/httpd/html/.docman.conf and  8. (optional) Copy docman.conf into /home/httpd/html/.docman.conf and
110     edit values which override default values in docman.php     edit values which override default values in docman.php
111    
112  10. if you want to upload files which are bigger than 2Mb increase  9. if you want to upload files which are bigger than 2Mb increase
113     upload_max_filesize to more than 2Mb in php.ini. If you still get     upload_max_filesize to more than 2Mb in php.ini. If you still get
114     errors on files bigger than 8Mb increase post_max_size also.     errors on files bigger than 8Mb increase post_max_size also.
115    
# Line 76  DIRECTORY AND FILE STRUCTURE Line 122  DIRECTORY AND FILE STRUCTURE
122  Breakout of files in /home/httpd/docman/:  Breakout of files in /home/httpd/docman/:
123    
124  docman.php      - main docman php file (to be installed as DirectoryIndex)  docman.php      - main docman php file (to be installed as DirectoryIndex)
125    
126    docman.conf     - configuration file which will be copied in document
127                      root of site
128    
129  auth_pop3.php   - authorization module ($gblIncDir in docman.php must point  auth_pop3.php   - authorization module ($gblIncDir in docman.php must point
130                          to location of this file)                          to location of this file)
131    
132    htusers_file.php - module for access to users in .htusers files
133    htusers_sql.php - module for access to users which are in SQL database
134    
135  adduser.pl      - perl script for adding of users (you can also add users  adduser.pl      - perl script for adding of users (you can also add users
136                          manually by editing .htusers file)                          manually by editing .htusers file)
137    
138  docman.txt      - user documentation  docman.txt      - user documentation
139  admin.txt       - administrator's documentation  admin.txt       - administrator's documentation
140    
141  Breakout of files in /home/httpd/html/:  contrib/        - directory with optional usefull scripts
142    
143    dbi/            - optional directory for dbi classes is users are stored
144                      in SQL database, it will be created after unpacking of
145                      http://pil.dk/downloads/dbi.tar.gz
146    
147    Breakout of files in /home/httpd/html/ (root directory of site under docman
148    management):
149    
150  .changelog      - changes of files under docman management  .changelog      - changes of files under docman management
151  .htusers        - file with users  .htusers        - file with users
152  .info.inc       - file with MOTD which is included in interface  .info.inc       - file with MOTD which is included in interface
153    .docman.conf    - configuration file for this site
154    
155  Files in each directory under docman management (some of them may be missing,  Files in each directory under docman management (some of them may be missing,
156  they will be created automatically):  they will be created automatically):

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.5

  ViewVC Help
Powered by ViewVC 1.1.26