1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/debian/README.Debian Sat Feb 22 01:11:30 2014 +0100
1.3 @@ -0,0 +1,43 @@
1.4 +== Setup web administration frontend ==
1.5 +
1.6 +First, set up /etc/kolab/session_vars.php. On a new installation, with kolabd
1.7 +bootstrapped the following commands should do it:
1.8 +
1.9 + sed -i -e "s@kolabserver.example.com@`grep '^fqdnhostname : ' \
1.10 + /etc/kolab/kolab.conf | gawk '{ print $3 }'`@" /etc/kolab/session_vars.php
1.11 + sed -i -e "s@dc=example,dc=com@`grep '^base_dn : ' \
1.12 + /etc/kolab/kolab.conf | gawk '{ print $3 }'`@" /etc/kolab/session_vars.php
1.13 + sed -i -e "s@PASSWORD@`grep '^php_pw : ' \
1.14 + /etc/kolab/kolab.conf | gawk '{ print $3 }'`@" /etc/kolab/session_vars.php
1.15 + sed -i -e "s@cn=nobody,cn=internal,dc=example,dc=com@`grep '^php_dn : ' \
1.16 + /etc/kolab/kolab.conf | gawk '{ print $3 }'`@" /etc/kolab/session_vars.php
1.17 +
1.18 +Then, to activate the web site, in order of preference,
1.19 +
1.20 + (a) If you have kolabd installed, that package's (SSL-enabled)
1.21 + Apache configuration includes
1.22 + /etc/kolab/kolab-webadmin-apache.conf by default.
1.23 +
1.24 +- or -
1.25 +
1.26 + (b) Set up an SSL virtual host and include
1.27 + /etc/kolab/kolab-webadmin-apache.conf there.
1.28 +
1.29 +- or -
1.30 +
1.31 + (c) Symlink /etc/kolab/kolab-webadmin-apache.conf to
1.32 + /etc/apache2/conf.d/kolab-webadmin. (This is obviously insecure,
1.33 + but good enough for testing.)
1.34 +
1.35 +Reload Apache afterwards in any case.
1.36 +
1.37 + /etc/init.d/apache2 reload
1.38 +
1.39 +== Configuration ==
1.40 +
1.41 +* go to https://example.net/admin/
1.42 +** create an account
1.43 +** create the mailing lists
1.44 +** If you have an internet domain:
1.45 +*** set smarthost/relayhost
1.46 +*** [x] Accept Internet Mail