Mac OS X Server 10.2: How to Configure WebMail to Enable Searching

This document describes how to set up WebMail to enable searching.
This applies to SquirrelMail 1.2.7 as installed with Mac OS X Server 10.2 and 10.2.1, and to SquirrelMail 1.2.8 as installed in Mac OS X Server 10.2.2.

If you have enabled WebMail, are using it to access mail from Apple Mail Server, and have found that the WebMail search function fails to find email messages that it should, there is a simple configuration change you can make to fix the issue.

If you have not made any changes to the SquirrelMail configuration file since installing Mac OS X Server 10.2 (either via running the /etc/squirrelmail/config/conf.pl script or by editing the config file /etc/squirrelmail/config/config.php), you can simply replace the old config with the new one by typing these two commands from the Terminal application:

#sudo mv /etc/squirrelmail/config/config.php /etc/squirrelmail/config/config.php.old

#sudo cp /etc/squirrelmail/config/config_default_apple.php /etc/squirrelmail/config/config.php

If you have made changes to the squirrelmail config file since installing Mac OS X Server 10.2, you can edit the /etc/squirrelmail/config/config.php config file and make a simple change. Using your preferred text editor as root, find the line in /etc/squirrelmail/config/config.php that reads:

$imap_server_type = "other";

Change it to:

$imap_server_type = "macosx";

Save the file.

You can also use the command-line tool to update the configuration:

sudo /etc/squirrelmail/config/conf.pl

You may also need to use a text editor to fix up /etc/squirrelmail/config/config.php after saving the configuration change. Refer to the help item entitled "New: Configuring WebMail" for important information about running the interactive conf.pl script to configure WebMail. (When reading that help item, note that the paths that read "/etc/squirrelmail/conf/..." are incorrect; they should read "/etc/squirrelmail/config/...)
Published Date: Oct 11, 2016