openbsd-ports/mail/roundcubemail/pkg
sthen 6e2e171cbc Update to Roundcube 0.9.
Note that database access is now done via PDO, and that for users of
SQLite this requires a change to sqlite3 - see the package readme for
update instructions.
2013-04-16 13:37:22 +00:00
..
DESCR
PLIST Update to Roundcube 0.9. 2013-04-16 13:37:22 +00:00
README Update to Roundcube 0.9. 2013-04-16 13:37:22 +00:00

$OpenBSD: README,v 1.2 2013/04/16 13:37:23 sthen Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

Standard Roundcube installation/upgrade
=======================================
See ${INSTDIR}/INSTALL and ${INSTDIR}/UPGRADING
for more information.

If upgrading from a version before 0.9, note that database access is now
done via PDO.

If you are using MySQL or PostgreSQL you will need to ensure that the
relevant package (php-pdo_mysql or php-pdo_pgsql) is installed and
enabled. If you are using SQLite, you will need to convert the
database from sqlite2 to sqlite3, for example (adjusting filenames
if necessary):

# cd /var/www/roundcubemail/db
# mv sqlite.db old_sqlite.db
# sqlite old_sqlite.db .dump | sqlite3 sqlite.db


Setup with httpd from OpenBSD base system
=========================================
With Apache, AllowOverride settings are required on the ${INSTDIR}
directory. You can configure this as follows:

# ln -s ../modules.sample/roundcubemail.conf \
        ${PREFIX}/conf/modules
# /etc/rc.d/httpd restart


Setup with other web servers
============================
Review the .htaccess files as you may need to use them as a template to
adjust various PHP settings in ${SYSCONFDIR}/php-${MODPHP_VERSION}.ini

With clients using certain versions of Internet Explorer, cache-control
headers must be adjusted for file downloads to work correctly over HTTPS.
Roundcube does this automatically but requires that the HTTPS variable
is passed to PHP. This is normally set by Apache mod_ssl, but not by
other servers; it will show as an environment variable in a phpinfo()
call if you want to check.

If this is not present it will need adding as a FastCGI parameter.
For nginx, you can do this by setting 'fastcgi_param HTTPS on' in the
appropriate location{} block for HTTPS.