This document describes how to set up and use new features in Confixx Professional 3.2 (01) IMAP (02) AWstats (03) suPHP (04) Custom mail quota (05) New SpamAssassin Options (06) HTTPD specials with regular expressions IMAP ==== Confixx 3.2 WebMail supports IMAP. Mail user can create IMAP folders and move e-mail messages between them. Drafts, Sent and Trash folders are available by default. To configure Conrfixx for using IMAP, perform these steps: 1. Install the IMAP server. Confixx 3.2 Webmail has been tested on Courier (http://www.courier-mta.org) and Dovecot (http://dovecot.org) IMAP servers, but most other IMAP servers should also work with Confixx 3.2. 2. Convert Confixx mailboxes to Maildir format. Most IMAP servers require Maildir format to be used for mail boxes. By default, Confixx uses mailbox format. To convert Confixx mailboxes to Maildir format, run the admin/contrib/convert_mb2md.pl script. 3. Set up MTA to deliver mail to Maildir. To set up, for exapmle, Procmail (http://www.procmail.org), specify the parameter DEFAULT=$HOME/Maildir/ in the /etc/procmailrc file. 4. Run the admin.pl script to turn on IMAP. Next time mail users log in into Confixx WebMail, they can use the advantages of IMAP. AWstats ======= AWstats (http://awstats.sourceforge.net) is a web log analyzer software, similar in functionality to Webalizer (http://www.mrunix.net/webalizer). Currently AWstats is configured to analyze only web server logs. You can use both Webalizer and AWstats at the same time. Installation 1. Install AWstats 2. Turn it on in admin.pl: A. Run the admin.pl script. B. Select AWstats in the list of available options. C. Provide the information required by Confixx. suPHP ===== suPHP provides a way to run php scripts with user credentials securely, like CGI scripts. It is considered to be more secure than mod_php, but a little slower in operation. All php security options, such as open_basedir and safe_mode, become unnecessary if you use suPHP. To install suPHP, perform these steps: 1. install mod_suphp 2. upload the mod_suphp file to Apache 3. run the admin.pl utility and select suPHP in the list of available options 4. after the next time Confixx runs the confixx_updatescript.pl script (it is run once a minute), unload the mod_php file from Apache. When you are using suPHP instead of mod_php, you can set custom php settings for domains using httpd specials. For example, if you wish to set a memory limit of 16 Mb for one of your domains, specify "php_admin_value memory_limit 16M" in the httpd special. A line memory_limit=16M" is appended to the domains php.ini file. To make advanced configuration of php use the following parameters in the confixx_main.conf file: o $php_engine Can be either 'mod_php' or 'suphp'. Specify suphp if you wish to use suPHP. NOTE: only one engine can be used with Confixx, otherwise it may not work. o $php_ini_dir This is a directory where the php.ini files for user domains and for confixx webpanel itself are stored. This is a required parameter if suPHP is used. For confixx webpanel php,ini files, set $php_ini_dir/php.ini For user websites set $php_ini_dir/$user/php.ini NOTE: this path has to be within /etc/ or /usr/local/etc directories. Only for suPHP o $php_special You can specify 1 or 0. If you set 1. Confixx parses httpd specials for php_admin_flag and php_admin_value and appends the settings into the domain php.ini files. If you set 0, nothing is changed. Only for suPHP o $php_ini_file This is a required parameter if suPHP is used. Confixx copies this file into the $php_ini_dir/$user directory and appends user specific information into the corresponding user php.ini file. Only for suPHP Custom mail quota ================= Now end users can set up custom soft and hard quota for their mail boxes by selecting User->E-mail->Mail Quota in their Confixx interface. This feature is available to the end users if Confixx administrator provides the "Mail Quota" service to a reseller, and reseller in turn provides it to his or her users. Administrator can change mail quota for users with custom mail quota settings by selecting Admin->Settings->Quota in his Confixx panel. More SpamAssassin Options ========================= Now end users can change SpamAssassin options from their Confixx panel by selecting User->E-mail->SpamAssassin. End users and mailbox owners can change ANY SpamAssassin settings and options by switching to "Advanced Mode". Set SpamAssassin options the same way this is done in the SpamAssassin text configuration file. HTTPD specials with regular expressions ======================================= By using regular expressions in httpd specials you can fully control what Confixx writes in users’ virtual hosts. There are one-line and multi-line substitutions. One-line substitutions have the following format: #// For example, the following expression: #/DocumentRoot/ DocumentRoot - allows to change the DocumentRoot directory of the virtual host. Multi-line regular expressions have the following format: #// #// replacement #/ For example, the following expression: #// #/<\/IfModule>/ - removes all SSL settings written by Confixx into the vhost file NOTE: Do not forget the tag; without it, nothing will be replaced. You can use the "Test" button in the administrator panel to test your regular expressions.