Just upgrading from v1.x or updating to latest v2.x version?
cd /home/httpd tar xvfz docman-2*.tar.gzMake a symlink from current version (2.x) to default directory name docman2
ln -s docman-2.x docman2If you decide to install docman in some other directory, change $gblIncDir to that directory in realm/http_virtual_host.conf!
cd /home/httpd/repositorychmod that directory so that web server can write in it.
chown nobody /home/httpd/repositoryIf you use Debian you will want to use www-data user like this: chown www-data /home/httpd/repository
ln -s /home/httpd/docman2/docman.php \ /home/httpd/http_virtual_host/index.php
ln -s /home/httpd/docman2/html/docman.css \ /home/httpd/http_virtual_host/docman.css
cp /home/httpd/docman2/docman.conf /etc/docman.confIf you haven't installed docman in /home/httpd/docman2 change $gblIncDir to your installation directory.
cp /home/httpd/docman2/realm/localhost.conf.dist \ /home/httpd/docman2/realm/http_virtual_host.confMore about realms can be found elsewhere in documentation.
DirectoryIndex index.html index.htmand add index.php at the end.
DirectoryIndex index.html index.htm index.phpHint! You might want to include something like:
<Directory /home/httpd/http_virtual_host> Options +FollowSymLinks </Directory>if you get error "Symbolic link not allowed" in Apache's error.log.
$ cd /home/httpd/docman2 $ ./adduser.pl realm/http_virtual_host.confIf you press just enter for password or enter auth_pop3 docman will use e-mail address to connect to pop3 server and check password on it. For that e-mail address must be in following form: firstname.lastname@example.org
Since I will convert all code to use PEAR, you again have to download php-dbi classes, because they are not included with docman anymore. This feature is not tested in version 2.0. Look out!
cd /home/httpd/docman2 tar xvfz dbi.tar.gzConstruct SQL query which returns login, full name, password and email from your tables(s). If you don't have some of that data, replace them with literal strings.
e.g. If your table is called my_users with columns who in which is login and column pw in which is plain text password you can use following query to get requested format:Enter that SQL query under $dbi_sql in realm/http_virtual_host.conf.
select who,'Auth user',pw,'nobody@com' from my_users
$dbi = "driver:database:user:password"Field driver can be: pgsql, mysql, oracle or odbc (or other if supported by current php-dbi), database is name of database in which are your users and user/password are credentials for user which connects to database.
REMOTE_ADDR=10.0.0.3:Full name:auth_header:email@example.com remote_hostname=myworkstation:Full name:auth_header:firstname.lastname@example.org http_referer=test.foo.bar:Full name:auth_header:email@example.comPlease note that you have to put auth_header in password field and valid options in login field.
You are ready to go.
More info see: New Directory Layout, How to Upgrade from v1.x, Performance tips and Administration manual