This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
tutorials:horde_groupware [2009/08/07 19:56] razvan |
tutorials:horde_groupware [2020/07/20 09:16] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | = Installing and configuring Horde Groupware = | + | ====== Installing and configuring Horde Groupware |
[[http:// | [[http:// | ||
Line 5: | Line 5: | ||
We've started using Horde Groupware for [[https:// | We've started using Horde Groupware for [[https:// | ||
- | == Install and basic configuration == | + | ===== Install and basic configuration |
The installation and configuration process is complex but quite straightforward. Horde' | The installation and configuration process is complex but quite straightforward. Horde' | ||
Line 13: | Line 13: | ||
I didn't use [[http:// | I didn't use [[http:// | ||
- | === System settings and requirements === | + | ==== System settings and requirements |
- | The following list shows the system configuration and setting and desired features. | + | The following list shows the system configuration and setting and desired features. |
- | * Debian GNU/Linux 5.0 Lenny | + | |
- | * Horde Webmail Groupware | + | * Horde Webmail Groupware |
- | * non-privileged account | + | * non-privileged account |
- | * Apache2 web-server | + | * Apache2 web-server |
- | * MySQL | + | * MySQL |
- | * IMAPS e-mail access | + | * IMAPS e-mail access |
- | * IMAPS login | + | * IMAPS login |
- | * Horde builtin wiki (wicked) | + | * Horde builtin wiki (wicked) |
- | === Required packages === | + | ==== Required packages |
The required Debian packages are listed below. A MySQL server also has to be configured (it need not be on the same system). cvs needs only be installed for CVS-based modules (such as [[http:// | The required Debian packages are listed below. A MySQL server also has to be configured (it need not be on the same system). cvs needs only be installed for CVS-based modules (such as [[http:// | ||
- | * apache2 | + | |
- | * libapache2-mod-php5 | + | * libapache2-mod-php5 |
- | * mysql-client-5.0 | + | * mysql-client-5.0 |
- | * php5 | + | * php5 |
- | * php5-cli | + | * php5-cli |
- | * php-pear | + | * php-pear |
- | * php5-imap | + | * php5-imap |
- | * cvs for CVS-based modules | + | * cvs for CVS-based modules |
=== Download == | === Download == | ||
- | First step is downloading the source package and installing it. You could be running as root or as a normal user. I recommend using a symbolic link for naming purposes. | + | You should [[http:// |
- | + | ||
- | Download link (http:// | + | |
{{{ | {{{ | ||
Line 55: | Line 53: | ||
}}} | }}} | ||
- | === Initial configuration === | + | ==== Initial configuration ==== |
+ | |||
+ | Most installation steps are described in the {{{$HORDE_INSTALL_DIR/ | ||
- | Most installation instructions are to be found in the docs/ | + | First of all a database has to be created. Afterwards, the setup script |
{{{ | {{{ | ||
Line 72: | Line 72: | ||
==== Create database and tables === | ==== Create database and tables === | ||
- | The database configuration should run smoothly. | + | The database configuration |
{{{ | {{{ | ||
razvan@swarm: | razvan@swarm: | ||
+ | [...] | ||
mysql> source groupware.mysql.sql | mysql> source groupware.mysql.sql | ||
ERROR 1044 (42000): Access denied for user ' | ERROR 1044 (42000): Access denied for user ' | ||
Line 87: | Line 88: | ||
}}} | }}} | ||
- | There are some warnings at the beginning but they don't matter. | + | Do not worry about the above errors. The script is ment to be run by the MySQL root user, enabling the creation of the database and user. As I had already created the database and required user, those steps were not needed. |
- | ==== Webroot update | + | === Webroot update === |
- | Because there may be problems detecting webroot (happened to me every time), | + | Because there may be problems detecting |
{{{ | {{{ | ||
Line 101: | Line 102: | ||
}}} | }}} | ||
- | To test the configuration, | + | To test the configuration, |
- | + | ||
- | === Required packages === | + | |
- | + | ||
- | * mysql-client-5.0 | + | |
- | * php5 | + | |
- | * php5-cli | + | |
- | * php-pear | + | |
- | * php5-imap | + | |
- | * cvs for CVS-based modules | + | |
=== Configure authentication == | === Configure authentication == | ||
- | Configure webmail | + | I want IMAPS authentication |
{{{ | {{{ | ||
Line 126: | Line 118: | ||
}}} | }}} | ||
- | By default, Horde Groupware uses IMP's IMAP authentication. The configuration option can be changed by altering the driver configuration option: | + | By default, Horde Groupware uses IMP's IMAP authentication. The configuration option can be changed by altering the {{{'driver' |
{{{ | {{{ | ||
+ | $conf[' | ||
$conf[' | $conf[' | ||
}}} | }}} | ||
- | === Enable HTTPS === | + | ==== Enable HTTPS ==== |
+ | |||
+ | You can configure HTTPS only access to Horde through the use of {{{mod_ssl}}} and {{{mod_rewrite}}} Apache modules. Replace {{{/ | ||
{{{ | {{{ | ||
Line 145: | Line 141: | ||
}}} | }}} | ||
- | === Basic configuration end === | + | ==== That's it! ==== |
- | Congratulations! You have a working instance of Horde Webmail Groupware | + | Congratulations! You now have a working instance of Horde Webmail Groupware. Accessing your base URL ({{{http:// |
- | == Extra configuration and customization == | + | ===== Extra configuration and customization |
- | === Installing wicked === | + | ==== Installing wicked |
- | As mentioned above, wicked (Horde' | + | As mentioned above, wicked (Horde' |
{{{ | {{{ | ||
Line 163: | Line 159: | ||
}}} | }}} | ||
- | As mentioned [http:// | + | As mentioned |
{{{ | {{{ | ||
Line 175: | Line 171: | ||
razvan@swarm: | razvan@swarm: | ||
CVS wicked.mssql.sql | CVS wicked.mssql.sql | ||
- | razvan@swarm: | + | razvan@swarm: |
mysql> source wicked.sql | mysql> source wicked.sql | ||
[...] | [...] | ||
}}} | }}} | ||
- | Run the wicked test.php script (http:// | + | Run the wicked test script ({{{http:// |
{{{ | {{{ | ||
Line 204: | Line 200: | ||
}}} | }}} | ||
- | ==== Enable | + | === Enable |
- | To enable Creole markup, use the configuration menu in the Administrative user interface. | + | To enable |
- | === Customization === | + | ==== Customization |
- | Certain features of Horde can be tuned either at global level, through the use of configuration files, or at user level, through the use of the configuration interface for each user. | + | Certain features of Horde can be tuned either at global level, through the use of configuration files or web user interface, or at user level, through the web user interface. |
- | ==== Setup automatic configuration of default identity ==== | + | === Setup automatic configuration of default identity === |
+ | |||
+ | When using IMP, I like automatic configuration of the {{{Default Identity}}} (sender address). For that I use a postauthentication script, as mentioned [[http:// | ||
+ | |||
+ | Update {{{$HORDE_INSTALL_DIR/ | ||
- | When using IMP, you would like automatic configuration of the Default Identity (sender address). For that we use a postauthentication script, as mentioned [http:// | ||
{{{ | {{{ | ||
$conf[' | $conf[' | ||
}}} | }}} | ||
- | ==== Change default theme ==== | + | === Change default theme === |
- | File to update: $HORDE_INSTALL_DIR/ | + | File to update: |
- | Preference to alter: ' | + | Preference to alter: |
{{{ | {{{ | ||
Line 232: | Line 231: | ||
==== Change default sidebar width === | ==== Change default sidebar width === | ||
- | As the sidebar is quite small, I like updating it from 150 to 200. | + | As the sidebar is quite small, I like updating it from {{{150}}} to {{{200}}} |
- | File to update: $HORDE_INSTALL_DIR/ | + | File to update: |
- | Preference to alter: ' | + | Preference to alter: |
{{{ | {{{ | ||
Line 242: | Line 241: | ||
}}} | }}} | ||
- | ==== IMP - configure default sending charset | + | === IMP - configure default sending charset === |
- | File to update: $HORDE_INSTALL_DIR/ | + | File to update: |
- | Preference to alter: ' | + | Preference to alter: |
{{{ | {{{ | ||
Line 253: | Line 252: | ||
}}} | }}} | ||
- | ==== IMP - disable view of deleted messages | + | === IMP - disable view of deleted messages === |
- | File to update: $HORDE_INSTALL_DIR/ | + | File to update: |
- | Preference to alter: ' | + | Preference to alter: |
{{{ | {{{ | ||
Line 264: | Line 263: | ||
}}} | }}} | ||
- | ==== Configure date and timezone options | + | === Configure date and timezone options === |
- | File to update: $HORDE_INSTALL_DIR/ | + | File to update: |
- | Preferences to alter: ' | + | Preferences to alter: |
{{{ | {{{ | ||
Line 288: | Line 287: | ||
}}} | }}} | ||
- | === UI configuration === | + | ==== UI configuration |
- | ==== User UI configuration | + | === User UI configuration === |
- | A non-admin user can alter his/hers configuration through the Options -> Global Options menu. The user can configure personal information, | + | A non-admin user can alter his/hers configuration through the {{{Options -> Global Options}}} menu. The user can configure personal information, |
- | ==== Administrative UI configuration | + | === Administrative UI configuration === |
- | The administrative UI configuration is enabled through the Administration -> Setup menus. As the admin user is altering | + | The administrative UI configuration is enabled through the {{{Administration -> Setup}}} menus. As the configuration files ({{{conf.php}}} and {{{conf.bak.php}}}) are altered through the web interface, they must be writable by the web server user ({{{www-data}}} for Apache2) (the backup file must be created if it does not exist): |
{{{ | {{{ | ||
Line 306: | Line 305: | ||
}}} | }}} | ||
- | ==== Enable | + | === Enable |
- | The Administration -> Setup -> Wicked menu enable | + | The {{{Administration -> Setup -> Wicked}}} menu enables |
+ | |||
+ | ==== Logging ==== | ||
+ | |||
+ | By default, Horde logs information in {{{/ | ||
+ | |||
+ | {{{ | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | $conf[' | ||
+ | }}} |