Chapter 6 Mail Access Administration
» Table of Contents |  |  | » Glossary | | | » Index | | |
| | |
| ||
| ||
Table of Contents
- POP Mail Server Administration
- IMAP Mail Server Administration
- IMP Webmail Administration
- Accessing the IMP Webmail Administration Menu
- Enabling and Disabling IMP Webmail
- Managing Mail Server Settings
- Modifying the Mail Server List
- Managing Mailbox Settings
- Managing Compose Settings
- Managing Message Settings
- Managing Logging Settings
- Managing Preference Driver Settings
- Managing Miscellaneous IMP Settings
- Managing Horde Settings
- Managing Turba Settings
- Using IMP Upgrade Tools
- Accessing IMP Webmail
- Additional Webmail Documentation
Using the Internet Express Administration utility, you can manage the following mail access components:
Post Office Protocol (POP) based on the Qualcomm POP Mail Server (Section : POP Mail Server Administration)
Cyrus IMAP Server and University of Washington IMAP Servers (Section : IMAP Mail Server Administration)
The Internet Messaging Program (IMP) to implement an IMAP-based Webmail system (Section : IMP Webmail Administration)
The Post Office Protocol (POP) server is primarily an offline e-mail processing system. Offline e-mail processing systems typically download e-mail from the e-mail server to the e-mail client, usually a PC, and optionally leave no copies of the e-mail on the server. The primary advantage of this offline e-mail processing system is that it is inexpensive, reliable, and in common use.
Internet Express supports the pop (POP Version 2) and popper (POP Version 3) servers. As defined in the /etc/services file, pop uses port 109 and popper uses port 110. You can enable only one server for each port.
For instructions on specifying mailbox access for the POP mail server, see Section : Configuring Mailbox Access. For information on viewing the server log, see Section : Viewing the POP Mail Server Log.
For information on tuning your system to improve the performance of your mail server, see http://h30097.www3.hp.com/docs/internet/TITLE.HTM
To control the POP3 server, follow these steps:
From the Administration utility Main menu, choose Manage Components.
Under Mail on the Manage Components menu, choose POP Server.
From the POP Server Administration menu, choose Enable/Disable the POP3 Server.
If the server is currently enabled, you can disable the server by clicking on Disable.
If the server is currently disabled, you can enable the server by clicking on Enable.
The Internet Express installation places two entries in the /etc/inetd.conf file to enable the POP mail servers, as follows:
|
pop stream tcp nowait root /usr/bin/pop2 popper pop3 stream tcp nowait root /usr/bin/popper popper |
|
To disable the POP2 server, remove or comment out the pop entry in the /etc/inetd.conf file.
Whenever you modify the /etc/inetd.conf file, you must send a HUP signal to the inetd process to reread the file. To determine the process ID of inetd and send the HUP signal to that process, enter the following command (note the use of the backward single quotation marks):
|
# kill -HUP `/sbin/init.d/bin/getpid /usr/sbin/inetd` |
|
To control the poppassd server, follow these steps:
Under Mail on the Manage Components menu, choose POP Server.
From the POP Server Administration menu, choose Enable/Disable the POPPASSD Server.
If the server is currently enabled, you can disable the server by clicking on Disable.
If the server is currently disabled, you can enable the server by clicking on Enable.
The Internet Message Access Protocol (IMAP) allows a client to access and manage e-mail messages on a server in much the same way as they can when messages are stored in local mailboxes. IMAP also allows offline clients to synchronize with the server. Internet Express complies with IMAP4 RFC 1730 and includes the following features:
Creating, deleting, and renaming mailboxes
Checking for new messages and removing messages
Setting and clearing flags
RFC 822 and MIME parsing
Searching
Selective fetching of message attributes
IMAP supports online, offline, and disconnected (not offline) e-mail processing. With online e-mail processing, messages arrive at, and are stored on, the e-mail server. When e-mail clients manipulate messages, the e-mail and the client folders remain on the e-mail server. Online processing allows users to access their e-mail from more than one e-mail client. For example, a user can access e-mail from a PC in his or her office and, later, from a laptop during a meeting, or from another PC at home in the evening.
With disconnected e-mail processing, an e-mail client connects to the e-mail server, makes a copy of selected messages, and then disconnects from the e-mail server. The e-mail client can later reconnect and synchronize with the e-mail server. With disconnected processing, a message's primary copy remains on the server; with offline e-mail processing, no message copy is kept.
Disconnected e-mail processing also synchronizes message status between the server and the client's message cache when the e-mail client subsequently reconnects to the server. Disconnected processing allows users to manipulate messages and folders while completely disconnected from the e-mail server and even the network.
Online and disconnected e-mail systems complement each other, and users can alternate between them. However, because offline operation implies deletion of messages from the e-mail server after the messages are copied to the client machine's local disk, neither online nor disconnected e-mail systems are compatible with offline operation.
Although you can install both the University of Washington IMAP Server (UW-IMAP) and the Cyrus IMAP Server subsets, you can enable only one of these servers at a time because they use the same standard IMAP port number. Enabling the Cyrus IMAP Server automatically disables the UW-IMAP Server.
For instructions on specifying mailbox access for the IMAP server, see Section : Configuring Mailbox Access. For information on viewing the mail log, see Section : Viewing the IMAP Server Log
For information on tuning your system to improve the performance of your mail server, see:
|
http://h30097.www3.hp.com/docs/internet/TITLE.HTM |
|
No special administration tasks are normally needed to set up a user to use the UW-IMAP server, but if the user had been using mail folders in the mh format, convert the folders to UNIX "From-style" folders using the /usr/dt/bin/mailcv -A command. (To read the mailcv(1) reference page, use the man n mailcv command.) The user's mail client might need to be configured to specify the directory that contains the mail folders. For example, if the mail folders are in a subdirectory of the user's home directory (that is, username/mail), then the user might need to configure the IMAP mail client to specify the mail folder directory as mail/.
To set up a UNIX user for Cyrus IMAP mail, you must create a Cyrus INBOX folder for the user, establish an IMAP alias for the user, and then convert the user's existing mail folders (if any) to the Cyrus format (see Section : Converting IMAP Mail Folders).
If you plan to serve more than 500 users with Cyrus IMAP mail, consider partitioning the users to improve performance. You can specify a partition as an additional parameter when using the cm command to create the user's INBOX folder (user.username directory). See the cyradm(1) reference page for more information on partitioning users.
To create a Cyrus INBOX folder and IMAP alias for a user, follow these steps:
Review the cyradm(1) reference page.
As root, enter the following command:
# /usr/local/bin/cyradm localhostEnter the password. (The system assumes that the user ID is the ID of the user running the command.)
localhost password: passwordEnter the following command to create the Cyrus INBOX folder. The user name (for example, duke) must exist in the /etc/passwd file with default protections set so that any new files or directories created are owned by the user.
localhost> cm user.dukeThis folder will display as INBOX to an IMAP mail client, but exists on the server as user.duke. All mail folders created by duke will be children of user.duke.
Exit the localhost shell:
localhost> Ctrl/DAdd an IMAP alias for user duke to the /var/adm/sendmail/aliases file:
duke: duke@IMAP
To enable the IMAP alias to take effect, enter the newaliases command:
# newaliases
To read existing mail using an IMAP mail client when a Cyrus IMAP Server is in use, the user'sTru64 UNIX existing mail folders must be converted to the Cyrus format. The mail conversion utility, /usr/dt/bin/mailcv, can convert UNIX (“From style”) folders to the Cyrus format and vice versa. When converting from UNIX folders to Cyrus folders, the target folder must exist. You can create folders by using a mail client or the cyradm utility (see cyradm(1)).
To convert from UNIX (“From style”) folders to IMAP folders, enter the following command:
|
/usr/dt/bin/mailcv [-evdt] -I [-f foldername | directoryname] [user | user.folder] |
|
To convert IMAP folders to UNIX (“From style”) folders, enter the following command:
|
mailcv [-vd] -U [-f foldername newfoldername ] |
|
For example, to convert the tree of UNIX (“From style”) folders for user duke into a tree of Cyrus IMAP folders, starting at directory bar, enter the following command:
|
% /usr/dt/bin/mailcv -I -t -f ./bar duke
|
|
The following table describes the options for the mailcv command:
| Option | Description |
|---|---|
| -e | When used with the -I option, suppresses delivery of duplicate messages |
| -d | Deletes messages as they are converted |
| -f | Specifies the name of the folder to be converted |
| -I | Indicates the resulting folder format will be IMAP |
| -t | Converts a tree (directory hierarchy) of folders |
| -U | Indicates the resulting folder format will be UNIX ("From" style) |
| -v | Use verbose mode |
| Option | Description |
|---|---|
| directoryname | Name of top-level directory in a hierarchy of mail directories to be converted; use with the -t option |
| foldername | Name of folder to be converted |
| newfoldername | Name of new folder (after conversion) |
| user | User's account name (for example, duke) |
| user.folder | Subfolder name (for example, duke.misc) |
To control the Cyrus IMAP Server, follow these steps:
From the Administration utility Main menu, choose Manage Components.
Under Mail on the Manage Components menu, choose Cyrus IMAP Server.
From the IMAP Server Administration menu, choose Enable/Disable the Cyrus IMAP Server.
If the server is currently enabled, you can disable it by clicking on Disable.
If the server is currently disabled, you can enable it by clicking on Enable.
To control the University of Washingon IMAP Server, follow these steps:
From the Administration utility Main menu, choose Manage Components.
Under Mail on the Manage Components menu, choose UW IMAP Server.
From the IMAP Server Administration menu, choose Enable/Disable the UW IMAP Server.
If the server is currently enabled, you can disable it by clicking on Disable.
If the server is currently disabled, you can enable it by clicking on Enable.
You can configure the Secure Sockets Layer (SSL) to enable encrypted communication between a mail client and the UW-IMAP Server. Support for SSL/TLS is built into the IMAP server and is enabled by the presence of the /usr/ssl/certs/imapd.pem certificate file. If this certificate file is present, the IMAP server will advertise STARTTLS capability. Mail clients that support TLS (e.g., Pine or Microsoft Outlook Express 6) will run STARTTLS and use encrypted communications.
If the /usr/ssl/certs/imapd.pem certificate file is present, the IMAP server can be configured to use SSL. Follow these steps:
Add a line to /etc/services similar to the following line:
imaps 993/tcp
Add a line to /etc/inetd.conf similar to the following line:
imaps stream tcp6 nowait root /usr/bin/imapd imapd
Make the inetd daemon reread its configuration,Tru64 UNIX as follows for the following releases:
On Tru64 UNIX Version 5.1 and later:
# inetd -h
On Tru64 UNIX systems prior to Version 5.1:
# kill -HUP `cat /var/run/inetd.pid`
To create the /usr/ssl/certs/imapd.pem certificate file, you must get a key and certificate from a certificate authority. If you are running the Internet Express Secure Web Server and have enabled SSL for the Web Server, you might be able to use this key and certificate for the IMAP server. For example,
|
|
|
For information on configuring the UW-IMAP Server to use SSL, see the section titled “SSL Installation” in:
|
http://www.washington.edu/imap/documentation/SSLBUILD.html |
|
The entries in the server log file are generated from data in the /var/adm/syslog.dated directories.
To view the Cyrus IMAP or UW IMAP server log file:
Under Mail on the Manage Components menu, choose either the Cyrus IMAP Server or UW IMAP Server. You may have one or both installed.
Note: Although you can install both the UW-IMAP Server and the Cyrus IMAP Server subsets, you can enable only one of these servers at a time because they use the same standard IMAP port number. Enabling the Cyrus IMAP Server automatically disables the UW-IMAP Server.
From the IMAP Server Administration menu, choose View Cyrus IMAP Server Log Server or View UW IMAP Server Log, depending on which server has been enabled.
IMP (Internet Messaging Program) Webmail provides access to IMAP and POP3 mail accounts through a Web interface. Users with an IMAP or POP3 account on a system accessible from the IMP program can view their mail from anywhere they have Web access.
IMP is installed by the IAEIMP subset, which requires a public instanceSecure Web Server of the (IAEAPCH) and PostgreSQL (IAEPSQL). In addition, you should have an IMAP server configured (may be the same system running IMP). To view the IMP pages, users must have a browser capable of running JavaScript and that allows cookies.
The IMP installation is composed of three parts: the Horde Application framework, the Turba addressbook/contact management program, and IMP Webmail. Configuration files for the three parts are located in three directories, /usr/internet/horde/config, /usr/internet/horde/imp/config, and /usr/internet/horde/turba/config. These files will be saved during an upgrade installation of the IAEIMP subset.
| |
| |
| |
| Note: The number of users that IMP can serve is partially limited by your configuration of PostgreSQL. If you would like to serve a large number of users with IMP, you might need to increase the number of processes that PostgreSQL's postmaster is allowed to manage. For information on increasing the number of processes, see Section : Scaling PostgreSQL. |
| |
| |
| |
This section discusses the following IMP Webmail administration tasks that you perform from the Internet Express Administration utility:
Access the IMP Webmail Administration menu (Section : Accessing the IMP Webmail Administration Menu)
Enable and disable IMP Webmail (Section : Enabling and Disabling IMP Webmail)
Manage Mail Server Settings (“Managing Mail Server Settings”)
Modify Mail Server List (Section : Modifying the Mail Server List)
Manage Mailbox Settings (Section : Managing Mailbox Settings)
Manage Compose Settings (Section : Managing Compose Settings)
Manage Message Settings (Section : Managing Message Settings)
Manage Logging Settings (Section : Managing Logging Settings)
Manage Preference Driver Settings (Section : Managing Preference Driver Settings)
Manage Miscellaneous IMP Settings (Section : Managing Miscellaneous IMP Settings)
Manage Horde Settings (Section : Managing Horde Settings)
Manage Turba Settings (Section : Managing Turba Settings)
Use IMP Upgrade Tools (Section : Using IMP Upgrade Tools)
Access IMP Webmail (Section : Accessing IMP Webmail)
Access additional IMP Webmail documentation (Section : Additional Webmail Documentation)
To access the IMP Webmail administration menu:
From the Internet Express Administration utility Main menu, choose Manage Components.
From the Manage Components menu, under Mail, choose IMP Webmail. The IMP Webmail Administration menu is displayed (Figure 6-1).
From the IMP Webmail Administration menu, choose Enable/Disable IMP Webmail. The Enable/Disable IMP page is displayed (Figure 6-2). Initially, the status message indicates that IMP is enabled and the Disable button will appear on the screen. (If IMP is disabled, the message and button text changes accordingly.)
Click on the Enable button (or Disable button). A success message is displayed upon completion.
Figure 6-2 shows the screen after IMP Webmail is enabled.
The Mail Server Settings form (Figure 6-3) allows you to change the general mail server settings used by IMP to determine what mail server to connect to, as well as what mail folders are accessible to the user.
To modify the mail server settings, follow these steps:
From the IMP Webmail Administration menu, choose Mail Server Settings.
The Mail Server Settings form is displayed (Figure 6-3).
Select the desired settings by clicking on the appropriate checkbox. These settings are defined in Table 6-1.
Click Submit to make the necessary changes. A status message is displayed when the changes are completed.
Table 6-1 IMP Mail Server Settings
| Setting | Description |
|---|---|
| Use server list | Select shown to display a list of servers for users to select on the IMP login page. Select hidden to use the default server defined by the preferred mechanism or by the order of the server list defined in the servers.php file. Select none to use the default server unless overridden by some other means. |
| Allow server change | Select this property to allow users to type a server name if Use server list is set to none. |
| Allow protocol change | Select this property to allow users to select the mail server's protocol (imap/pop) if Use server list is set to none. |
| Allow port change | Select this property to allow users to enter the mail server's port if Use server list is set to none. |
| Show dotfiles | Select this property to show files beginning with a period (“ . ”) in the folder list. |
| Enable following folder hierarchies | Enter a space-separated list of any folder hierarchies to include which are not shown by default. For example, #shared/ #news/#ftp/#public/. Your mail server must be separately configured to serve these hierarchies. |
The Modify Mail Server List form (Figure 6-4) allows you to edit the IMP mail server definitions. Use this form to access the list of predefined servers that users can choose if using the server list (see Section : Managing Mail Server Settings), or determine the default server when the user is not permitted to choose. See the Use server list settings in the Mail Server Settings form to configure what options for the user.
From this form, you can perform the following tasks:
Add a server name (Section : Adding a Mail Server)
Modify settings for a server (Section : Modifying a Mail Server)
Delete a server from the list (Section : Deleting a Mail Server)
When you click the Add button on the Modify Mail Server List form, a new menu (Figure 6-5) is displayed. Use this menu to define the settings described in Table 6-2.
To add a mail server to the list, follow these steps:
From the IMP Webmail Administration menu, choose Modify Mail Server List.
The Modify Mail Server List form (Figure 6-4) is displayed.
Enter the name of the new server in the New Server Name field. Optionally, select an existing server from the Existing Server list. The new entry will be added before the selected server. If no server is selected, the new server will be added to the end of the list.
Click Add. A new form is displayed (Figure 6-5).
Fill out the form. Table 6-2 defines the settings.
Click Submit to make the necessary changes. A status message is displayed when the changes are complete.
Table 6-2 IMP Mail Server List Settings
| Setting | Description |
|---|---|
| Key | A unique identifier for this server entry. If this key begins with an underscore character, “_”, then it is treated as a prompt. As a prompt, the Name will be displayed in the server list, but no other server information is required, and the prompt may not be selected as a server by the user. |
| Name | Enter the text displayed to the user. This should also be unique and have some meaning to the user. |
| Server | Enter the hostname of the mail server. |
| Protocol | Enter the protocol type of the server. For example imap, pop3, imap/ssl, imap/ssl/novalidate-cert, and so on. Note, If you are using a self-signed server certificate with imap/ssl or pop3/ssl then you must also specify the novalidate-cert option to tell the c-client to ignore the lack of a valid Certificate Authority (CA) on the certificate. |
| Port | Enter the port for the mail service. 143 or 110 are the most common values. |
| Folders | If you wish to restrict users to a subfolder, enter the path here. Common values would be mail/ for UW-IMAP or INBOX. for Cyrus IMAP. |
| Namespace | Enter a path to remove from mailbox names for presentation purposes. A common value for Cyrus IMAP servers is INBOX. This may cause confusion between shared folders and personal folders if they share the same name. |
| Maildomain | Enter the default hostname to use after the @ for the from address when sending mail. This value will also be used to complete unqualified addresses in the compose window. This property can be useful when the server sending and receiving mail is different. |
| SMTP Host | If the mailer type is set to smtp, then enter this host for outbound SMTP connections. This will override all other configuration values. |
| Realm | Append this value to user names for preferences and Horde authentication. This can be used to prevent clashes on virtual host setups. |
| Preferred | Enter a space separated list of hosts on which this server entry should be default. Use this if you use the same server.php file on different machines. If the hostname of the IMP machine does not match any preferred settings in the file, then the first entry in the file is considered default. |
To modify a mail server in the list, follow these steps:
From the IMP Webmail Administration menu, choose Modify Mail Server List.
The Modify Mail Server List form is displayed.
Click the name of the mail server to be modified from the Existing Servers list (Figure 6-4), and click Modify. On the form that is displayed, change the desired settings. Table 6-2 defines the settings.
Click Submit. A status message is displayed when complete.
To delete a mail server from the list, follow these steps:
From the IMP Webmail Administration menu, choose Modify Mail Server List.
The Modify Mail Server List form is displayed.
In the Existing Servers list, click the name of the server to be deleted and click Delete.
Click Submit. A status message is displayed when complete.
The Mailbox Settings form (Figure 6-6) allows you to specify various configurations used to construct the IMP Mailbox page. To modify these parameters, choose Mailbox Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-3.
To modify the mailbox settings, follow these steps:
From the IMP Webmail Administration menu, choose Mailbox Settings.
The Mailbox Settings form is displayed (Figure 6-6).
Fill out the form. Table 6-3 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when completed.
Table 6-3 IMP Mailbox Settings
| Setting | Description |
|---|---|
| Date format | Enter the format used in the mailbox's Date field for messages sent on days other than today. The format will be used in a call to the PHP strftime function. See the PHP documentation for more information. |
| Time format | Enter the format used in the mailbox's Data field for messages sent today. Like the value for Date format, this should match the syntax for the PHP strftime function. |
| Max length of From field | Indicates the maximum number of characters in the mailbox's From field, that is truncated to this many characters for display purposes. |
| Max length of Subject field | The mailbox's Subject field that will be truncated to this many characters for display purposes. |
| From field links to | The mailbox's From field for each message can act as a link for users to either read the message (message) or compose a message to that address (compose). Select the appropriate value or none for no link. |
| Show legend | Select this item to display a legend bar at the bottom of the mailbox. This explains colors that correspond to different kinds of messages (read, unread, deleted, and so on). |
| Show attachment information | If selected, the information on attachments will be shown in the mailbox window. This can slow performance especially on larger installations |
The Compose Settings form (Figure 6-7) allows you to specify various configurations used to construct the IMP Compose page. To modify these settings, choose Compose Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-4.
To modify the compose settings, follow these steps:
From the IMP Webmail Administration menu, choose Compose Settings.
The Compose Settings form is displayed (Figure 6-7).
Fill out the form. Table 6-4 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-4 IMP Compose Settings
| Setting | Description |
|---|---|
| Allow setting Cc: header | Select to allow users to set the Cc: heading. |
| Allow setting Bcc: header | Select to allow users to set the Bcc: heading. |
| Date format | Specify a format string to be passed to the PHP strftime function to display the date in the compose window header. |
| Allow requesting return receipt | Select to users to request return receipts |
| Enable popup for special characters | Select to provide a link to a special characters pop-up window. |
| Provide sentmail folder selection | Select to provide a menu in the compose window, so a user can select a folder to save the sent messages. Otherwise, the messages will be saved according to user preference settings. |
The Message Settings form (Figure 6-8) allows you to specify settings used to display and send messages. To modify these settings, choose Message Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-5.
To modify the message settings, follow these steps:
From the IMP Webmail Administration menu, choose Message Settings.
The Message Settings form is displayed (Figure 6-8).
Fill out the form. Table 6-5 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-5 IMP Message Settings
| Setting | Description |
|---|---|
| Prepend header | Select to include the contents of /usr/internet/horde/imp/config/header.txt in the header of all messages sent. |
| Append trailer | Select to include the contents of /usr/internet/horde/imp/config/trailer.txt at the end of every message sent. |
| Filtering configuration file | To enable filtering of messages, enter the path to a file containing words to be filtered. This should be relative to the /usr/internet/horde/imp directory. |
| Filtering replacement string | Enter a string to replace words filtered out of messages. |
| Allow viewing of message source | Select to provide a link in the message window, so users can view the entire raw message. |
| Allow all messages to be resumed | Select to resume all messages in the mailbox. Otherwise only messages marked as drafts can be resumed. |
The Logging Settings form (Figure 6-9) allows you to specify how to log Horde/IMP actions. To modify these settings, choose Logging Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-6.
To modify the logging settings, follow these steps:
From the IMP Webmail Administration menu, choose Logging Settings.
The Logging Settings form is displayed (Figure 6-9).
Fill out the form. Table 6-6 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-6 IMP Logging Settings
| Setting | Description |
|---|---|
| Enabled | Select to enable IMP logging of events. |
| Driver | If logging is enabled, choose the driver type from the selection list. The file driver type will log in to a text file. The syslog driver type will log in to the syslog facility. The sql driver type will use a database table to store logs. |
| Name | Enter the type of logging you are using:
|
| Level | Click the level of messages to log. The selected setting logs all messages at its level or above. |
| Identifier | Enter the identifier to use in the logs. |
| SQL parameters | If you use the sql driver for logging, you must enter more information on the database to use. This should be a connection string with the basic syntax, phptype://username:password@protocol+hostspec:port/database_name. phptype is required, but most other parts are optional. See comments in /usr/local/lib/php/DB.php, parseDSN function for other variations on this syntax. For example, pgsql://hordemgr:mypass@tcp+localhost:5432/horde will connect to the PostgreSQL database horde on localhost port 5432 using a TCP socket and the user hordemgr with password mypass. |
The Preference Driver Settings form Figure 6-10 allows you to define the settings for storing and retrieving user preferences. To modify these settings, choose Preference Driver Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-7.
To modify the preference driver settings, follow these steps:
From the IMP Webmail Administration menu, choose Preference Driver Settings.
The Preference Driver Settings form is displayed (Figure 6-10).
Fill out the form. Table 6-7 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-7 Preference Driver Settings
| Setting | Description |
|---|---|
| Driver | Click the appropriate preference driver to use. Supported values are none (use system defaults and not save any user information), session (user preferences are saved using sessions and are only valid during this login), or sql (use a database to save preferences so they persist for a user between logins). The rest of the options are required only if you are using the sql driver. |
| Database type | Enter the type of database server you are using. The only supported setting is pgsql for a PostgreSQL database. |
| Host | Enter the hostname of the database server. This defaults to localhost. |
| Username | Enter the database user name to use to connect. Changing this entry will change only the IMP settings and not the database permissions. |
| Password | Enter the password for the user specified above. This will change only the IMP configuration and not that of the database. |
| Database name | Enter the name of the database containing the preference table. |
| Preference table | Enter the name of the table containing preference data. |
The Miscellaneous IMP Settings form (Figure 6-11) contains other IMP settings. To modify these settings, choose Miscellaneous IMP Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-8.
To modify the miscellaneous settings, follow these steps:
From the IMP Webmail Administration menu, choose Miscellaneous IMP Settings.
The Miscellaneous IMP Settings form is displayed (Figure 6-11).
Fill out the form. Table 6-8 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-8 Miscellaneous IMP Settings
| Setting | Description |
|---|---|
| Allow usage of folders | Clearing this box will restrict users to their inbox and not allow them to use any other folders including sent-mail or postponed folders. Selecting it will allow them to use mail folders. |
| Alternate login URL | Enter the URL of a login screen to be used instead of IMP's default. |
| Alternate logout URL | Enter the URL of a logout screen for users. |
The Horde Settings form (Figure 6-12) contains Horde settings. To modify these settings, choose Horde Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-9.
To modify the Horde settings, follow these steps:
From the IMP Webmail Administration menu, choose Horde Settings.
The Horde Settings form is displayed (Figure 6-12).
Fill out the form. Table 6-9 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-9 Horde Settings
| Setting | Description |
|---|---|
| Display Help Links | Select this box to display help links on the user's pages. |
| PHP error level | Click the value to use in the PHP error_reporting function to configure the amount and types of PHP errors displayed on the user's screen. For more information, see: |
| Max execution time (sec) | Enter the number of seconds allowed for a PHP script to execute before returning a fatal error. Setting this to 0 means there is no limit. |
| Session name | Enter the name for the session shared by all Horde applications. |
| Use SSL URLs | When generating full URLs, specify whether to use https or http as the protocol. Never will never use SSL, Always will always generate https URLs, and Auto will attempt to autodetect which method to use. |
| Compress pages | If selected, then pages over a certain size will be compressed and sent to the user's browser as gzip-encoded data. This will– increase CPU usage but can dramatically decrease the size of pages resulting in faster delivery of information, especially over slower connections. |
| Umask | Enter the umask value (octal value) to run as. This affects the permissions of temporary files created. |
| Temporary directory | Enter this value to override the system default and PHP's upload_tmp_dir value, set either in the php.ini configuration or php_value directive in httpd.conf, for the temporary directory. Session information and temporary attachment files are stored there. |
| Enable cache | Click the cache driver to use. A value of none disables the Horde cache. |
| Cache directory | If using a cache, then enter the directory to use to store cached objects. |
| Mailer type | Click the mailer type to send mail. Valid options are sendmail or smtp. |
| Mailer location | If using sendmail, enter the path to sendmail (for example, /usr/bin/sendmail). If using smtp, enter the smtp server (for example, smtp.example.com). |
| Let browser cache stylesheet | If selected, a user's browser can cache the generated stylesheets. This can speed execution and download time but requires the user to manually refresh to see any style changes you make. |
The Turba Settings form Figure 6-13) allows you to enable Turba and configure database parameters to access user's addressbooks. To modify these settings, choose Turba Settings from the IMP Webmail Administration menu. You will be presented with the fields described in Table 6-10.
To modify the Turba settings, follow these steps:
From the IMP Webmail Administration menu, choose Turba Settings.
The Turba Settings form is displayed (Figure 6-13).
Fill out the form. Table 6-10 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-10 IMP Turba Settings
| Setting | Description |
|---|---|
| Enabled | If selected, enables access to Turba contacts manager. If not selected, users will not have access to their addressbook. |
| Database Type | Enter the type of the database server. The only supported value is pgsql for a PostgreSQL database. |
| Protocol | Enter the protocol to use to access the database server. Common values are tcp or unix. |
| Hostname | If using the tcp protocol, enter the hostname of the database server. |
| Port | If using the tcp protocol, enter the port of the database. The standard value for PostgreSQL setups is 5432. |
| Username | Enter the database user with permission to access the necessary tables. |
| Password | Enter the password for the database user with permission to access the necessary tables. |
| Database Name | Enter the name of the database containing the addressbook table. |
| Table | Enter the name of the table containing addressbook entries. If you create your own table, ensure it matches the schema defined in /usr/internet/horde/turba/scripts/drivers/turba.sql. |
Starting with Internet Express Version 5.9, the configuration syntax and database schema requirements of Horde and IMP have changed. After doing the upgrade installation, you will have a working installation of IMP, but most of your previous configurations and all stored user information (preferences and contact lists) will not be available. This information must be converted to the new formats.
There are two menus provided in the IMP Webmail Administration section of the Administration Utility. Use them to convert your new configuration and data to match your old settings and data.
Upgrade Configurations (Section : Upgrading IMP Configurations).
Upgrade Database (Section : Upgrading IMP Databases).
Use the Upgrade Configurations menu to convert your new configurations to match old settings with the exception of settings in IMP's html.php3 configuration file. If you wish to customize the colors and fonts used by IMP, you will need to manually modify the following files:
/usr/internet/horde/config/html.php
/usr/internet/horde/imp/config/html.php
To run the Upgrade Configuration script, follow these steps:
The Upgrade Database form (Figure 6-14) allows you to convert any user information stored in PostgreSQL tables for previous installations (Internet Express Version 5.8 and earlier) to match the new schema. Customize the table fields as necessary. The defaults should be adequate except for the new table names that you may want to change. Table 6-11 describes the settings on this menu.
To upgrade the IMP Database, follow these steps:
From the IMP Webmail Administration menu, choose IMP Upgrade Tools.
The IMP Upgrade Tools menu is displayed.
Choose Upgrade Database.
The Upgrade Database form is displayed (Figure 6-14).
Fill out the form. Table 6-11 describes the settings.
Click Submit to make the necessary changes. A status message is displayed when complete.
Table 6-11 IMP Database Upgrade Settings
| Setting | Description |
|---|---|
| Database Info These values should refer to the current database containing the Horde/IMP tables. The new tables will be added to this database. | |
| Database Name | Enter the name of the database. The default installation uses database horde. |
| Username | Enter the PostgreSQL user with access to the Horde/IMP tables. |
| Password | Enter the password for the PostgreSQL user with access to the Horde/IMP tables. |
| Host | Enter the hostname of the PostgreSQL server |
| Port | Enter the port of the PostgreSQL server if non-standard. |
| Address Table | |
| Convert Address Table? | Select if you want to convert the table containing user's addressbooks and contact lists. |
| Current Address Table | Enter the name of the addressbook table used for Internet Express installations prior to Version 6.0. |
| New Address Table | Enter the name of the new table to be created. This table must either be empty or not exist for the conversion to take place. |
| Preference Table | |
| Convert Preference Table? | Select if you want to convert the table containing all user's preferences. |
| Current Preference Table | Enter the name of the preference table used for Internet Express installations prior to Version 6.0. |
| New Preference Table | Enter the name of the new table to be created. This table must either be empty or not exist for the conversion to take place. |
Enter http://hostname/imp/ in the address bar of your Web browser. The IMP login form is displayed.
Enter your user name and password. Then depending on the configuration, you might need to select or enter information for your IMAP server.
Click the Login button. Your inbox is displayed.
For additional documentation covering installation and configuration, see the contents of /usr/internet/horde/docs, /usr/internet/horde/imp/docs and /usr/internet/horde/turba/docs.
For further information, visit the IMP Webmail FAQ page:
|
http://www.horde.org/faq/ |
|
Also visit the main IMP Web site:
|
http://www.horde.org |
|