Internet Express Version 6.7 for Tru64 UNIX: Internet Express for Tru64 UNIX Administration Guide

Chapter 6 Mail Access Administration

  Table of Contents

  Glossary

  Index

Using the Internet Express Administration utility, you can manage the following mail access components:

POP Mail Server 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

Controlling the POP3 Server

To control the POP3 server, follow these steps:

  1. From the Administration utility Main menu, choose Manage Components.

  2. Under Mail on the Manage Components menu, choose POP Server.

  3. From the POP Server Administration menu, choose Enable/Disable the POP3 Server.

  4. 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.

Controlling the POP2 Server

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`

Controlling the POPPASSD Server

To control the poppassd server, follow these steps:

  1. Under Mail on the Manage Components menu, choose POP Server.

  2. From the POP Server Administration menu, choose Enable/Disable the POPPASSD Server.

  3. 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.

Viewing the POP Mail Server Log

The entries in the server log file are generated from data in the /var/adm/syslog.dated directories.

To view the POP3 or POP2 server log file:

  1. Under Mail on the Manage Components menu, choose the POP Server.

  2. From the POP Server Administration menu, choose View POP Server Log.

IMAP Mail Server Administration

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

Setting Up a UNIX User Account for UW IMAP

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/.

Setting Up a UNIX User Account for Cyrus IMAP

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:

  1. Review the cyradm(1) reference page.

  2. As root, enter the following command:

    # /usr/local/bin/cyradm localhost
  3. Enter the password. (The system assumes that the user ID is the ID of the user running the command.)

    localhost password: password
  4. Enter 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.duke

    This 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.

  5. Exit the localhost shell:

    localhost> Ctrl/D
  6. Add an IMAP alias for user duke to the /var/adm/sendmail/aliases file:

    duke: duke@IMAP
  7. To enable the IMAP alias to take effect, enter the newaliases command:

    # newaliases

Converting IMAP Mail Folders

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:

OptionDescription
-eWhen used with the -I option, suppresses delivery of duplicate messages
-dDeletes messages as they are converted
-fSpecifies the name of the folder to be converted
-IIndicates the resulting folder format will be IMAP
-tConverts a tree (directory hierarchy) of folders
-UIndicates the resulting folder format will be UNIX ("From" style)
-vUse verbose mode

The following table describes the parameters for the mailcv command:

OptionDescription
directorynameName of top-level directory in a hierarchy of mail directories to be converted; use with the -t option
foldernameName of folder to be converted
newfoldernameName of new folder (after conversion)
userUser's account name (for example, duke)
user.folderSubfolder name (for example, duke.misc)

For more information on the modified mailcv command, see the mailcv(1) reference page.

Controlling the Cyrus IMAP Server

To control the Cyrus IMAP Server, follow these steps:

  1. From the Administration utility Main menu, choose Manage Components.

  2. Under Mail on the Manage Components menu, choose Cyrus IMAP Server.

  3. From the IMAP Server Administration menu, choose Enable/Disable the Cyrus IMAP Server.

  4. 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.

Controlling the UW IMAP Server

To control the University of Washingon IMAP Server, follow these steps:

  1. From the Administration utility Main menu, choose Manage Components.

  2. Under Mail on the Manage Components menu, choose UW IMAP Server.

  3. From the IMAP Server Administration menu, choose Enable/Disable the UW IMAP Server.

  4. 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.

Configuring SSL for UW-IMAP

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:

  1. Add a line to /etc/services similar to the following line:

    imaps             993/tcp
    
  2. Add a line to /etc/inetd.conf similar to the following line:

    imaps   stream  tcp6    nowait  root    /usr/bin/imapd  imapd
  3. 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,

# cd /usr/internet/httpd/conf
# cat ssl.key/server.ky ssl.crt/server.crt > /usr/ssl/certs/imapd.pem

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
Note:

When reviewing this information, be aware that the UW-IMAP Server from Internet Express is installed as /usr/bin/imapd and that the IMAP certificate must be installed as /usr/ssl/certs/imapd.pem.

Viewing the IMAP Server Log

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:

  1. 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.

  2. 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 Webmail Administration

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:

Accessing the IMP Webmail Administration Menu

To access the IMP Webmail administration menu:

  1. From the Internet Express Administration utility Main menu, choose Manage Components.

  2. From the Manage Components menu, under Mail, choose IMP Webmail. The IMP Webmail Administration menu is displayed (Figure 6-1).

Figure 6-1 IMP Webmail Administration Menu

IMP Webmail Administration Menu

Enabling and Disabling IMP Webmail

To enable (or disable) IMP:

  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.)

  2. 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.

Figure 6-2 Enable/Disable IMP Webmail Page

Enable/Disable IMP Webmail Page

Managing Mail Server Settings

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:

  1. From the IMP Webmail Administration menu, choose Mail Server Settings.

    The Mail Server Settings form is displayed (Figure 6-3).

    Figure 6-3 Mail Server Settings Form

    Mail Server Settings Form
  2. Select the desired settings by clicking on the appropriate checkbox. These settings are defined in Table 6-1.

  3. Click Submit to make the necessary changes. A status message is displayed when the changes are completed.

Table 6-1 IMP Mail Server Settings

SettingDescription
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 changeSelect this property to allow users to type a server name if Use server list is set to none.
Allow protocol changeSelect this property to allow users to select the mail server's protocol (imap/pop) if Use server list is set to none.
Allow port changeSelect this property to allow users to enter the mail server's port if Use server list is set to none.
Show dotfilesSelect this property to show files beginning with a period (“ . ”) in the folder list.
Enable following folder hierarchiesEnter 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.

 

Modifying the Mail Server List

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.

Figure 6-4 Modify Mail Server List Form

Modify Mail Server List Form

From this form, you can perform the following tasks:

Adding 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:

  1. From the IMP Webmail Administration menu, choose Modify Mail Server List.

    The Modify Mail Server List form (Figure 6-4) is displayed.

  2. 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.

  3. Click Add. A new form is displayed (Figure 6-5).

    Figure 6-5 Mail Server List Form for Adding or Modifying Servers

    Mail Server List Form for Adding
or Modifying Servers
  4. Fill out the form. Table 6-2 defines the settings.

  5. 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

SettingDescription
KeyA 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.
NameEnter the text displayed to the user. This should also be unique and have some meaning to the user.
ServerEnter the hostname of the mail server.
ProtocolEnter 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.
PortEnter the port for the mail service. 143 or 110 are the most common values.
FoldersIf 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.
NamespaceEnter 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.
MaildomainEnter 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.
RealmAppend this value to user names for preferences and Horde authentication. This can be used to prevent clashes on virtual host setups.
PreferredEnter 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.

 

Modifying a Mail Server

To modify a mail server in the list, follow these steps:

  1. From the IMP Webmail Administration menu, choose Modify Mail Server List.

    The Modify Mail Server List form is displayed.

  2. 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.

  3. Click Submit. A status message is displayed when complete.

Deleting a Mail Server

To delete a mail server from the list, follow these steps:

  1. From the IMP Webmail Administration menu, choose Modify Mail Server List.

    The Modify Mail Server List form is displayed.

  2. In the Existing Servers list, click the name of the server to be deleted and click Delete.

  3. Click Submit. A status message is displayed when complete.

Managing Mailbox Settings

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:

  1. From the IMP Webmail Administration menu, choose Mailbox Settings.

    The Mailbox Settings form is displayed (Figure 6-6).

    Figure 6-6 Mailbox Settings Form

    Mailbox Settings Form
  2. Fill out the form. Table 6-3 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when completed.

Table 6-3 IMP Mailbox Settings

SettingDescription
Date formatEnter 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 formatEnter 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 fieldIndicates 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 fieldThe mailbox's Subject field that will be truncated to this many characters for display purposes.
From field links toThe 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 legendSelect 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 informationIf selected, the information on attachments will be shown in the mailbox window. This can slow performance especially on larger installations

 

Managing Compose Settings

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:

  1. From the IMP Webmail Administration menu, choose Compose Settings.

    The Compose Settings form is displayed (Figure 6-7).

    Figure 6-7 Compose Settings Form

    Compose Settings Form
  2. Fill out the form. Table 6-4 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-4 IMP Compose Settings

SettingDescription
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.

 

Managing Message 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:

  1. From the IMP Webmail Administration menu, choose Message Settings.

    The Message Settings form is displayed (Figure 6-8).

    Figure 6-8 Message Settings Form

    Message Settings Form
  2. Fill out the form. Table 6-5 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-5 IMP Message Settings

SettingDescription
Prepend headerSelect 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 fileTo 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 stringEnter a string to replace words filtered out of messages.
Allow viewing of message sourceSelect 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.

 

Managing Logging Settings

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:

  1. From the IMP Webmail Administration menu, choose Logging Settings.

    The Logging Settings form is displayed (Figure 6-9).

    Figure 6-9 Logging Settings Form

    Logging Settings Form
  2. Fill out the form. Table 6-6 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-6 IMP Logging Settings

SettingDescription
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:

  • For file, this should be the absolute path to the text file (ex. /data/logs/horde/horde.log).

  • For syslog this should be the facility (for example, . LOG_LOCAL0). See syslog(3) for information on allowed values.

  • For sql, this should be the name of the table to use.

Level Click the level of messages to log. The selected setting logs all messages at its level or above.
IdentifierEnter the identifier to use in the logs.
SQL parametersIf 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.

 

Managing Preference Driver Settings

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:

  1. From the IMP Webmail Administration menu, choose Preference Driver Settings.

    The Preference Driver Settings form is displayed (Figure 6-10).

    Figure 6-10 Preference Driver Settings Form

    Preference Driver Settings Form
  2. Fill out the form. Table 6-7 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-7 Preference Driver Settings

SettingDescription
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 typeEnter 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 nameEnter the name of the database containing the preference table.
Preference tableEnter the name of the table containing preference data.

 

Managing Miscellaneous IMP Settings

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:

  1. From the IMP Webmail Administration menu, choose Miscellaneous IMP Settings.

    The Miscellaneous IMP Settings form is displayed (Figure 6-11).

    Figure 6-11 Miscellaneous IMP Settings Form

    Miscellaneous IMP Settings Form
  2. Fill out the form. Table 6-8 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-8 Miscellaneous IMP Settings

SettingDescription
Allow usage of foldersClearing 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 URLEnter the URL of a login screen to be used instead of IMP's default.
Alternate logout URLEnter the URL of a logout screen for users.

 

Managing Horde Settings

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:

  1. From the IMP Webmail Administration menu, choose Horde Settings.

    The Horde Settings form is displayed (Figure 6-12).

    Figure 6-12  Horde Settings Form

     Horde Settings Form
  2. Fill out the form. Table 6-9 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-9 Horde Settings

SettingDescription
Display Help LinksSelect 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:

http://www.php.net/error_reporting

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 nameEnter 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 pagesIf 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 directoryEnter 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 cacheClick the cache driver to use. A value of none disables the Horde cache.
Cache directoryIf using a cache, then enter the directory to use to store cached objects.
Mailer typeClick the mailer type to send mail. Valid options are sendmail or smtp.
Mailer locationIf 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 stylesheetIf 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.

 

Managing Turba Settings

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:

  1. From the IMP Webmail Administration menu, choose Turba Settings.

    The Turba Settings form is displayed (Figure 6-13).

    Figure 6-13 Turba Settings Form

    Turba Settings Form
  2. Fill out the form. Table 6-10 describes the settings.

  3. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-10 IMP Turba Settings

SettingDescription
Enabled If selected, enables access to Turba contacts manager. If not selected, users will not have access to their addressbook.
Database TypeEnter 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 NameEnter 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.

 

Using IMP Upgrade Tools

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.

Upgrading IMP Configurations

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:

  1. From the IMP Webmail Administration menu, choose IMP Upgrade Tools.

    The IMP Upgrade Tools form is displayed.

  2. Click Upgrade Configurations.

  3. On the confirmation page, click Submit. A status message is displayed when complete.

Upgrading IMP Databases

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:

  1. From the IMP Webmail Administration menu, choose IMP Upgrade Tools.

    The IMP Upgrade Tools menu is displayed.

  2. Choose Upgrade Database.

    The Upgrade Database form is displayed (Figure 6-14).

    Figure 6-14 Upgrade Database Settings Form

    Upgrade Database Settings Form
  3. Fill out the form. Table 6-11 describes the settings.

  4. Click Submit to make the necessary changes. A status message is displayed when complete.

Table 6-11 IMP Database Upgrade Settings

SettingDescription
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.
UsernameEnter 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 TableEnter the name of the addressbook table used for Internet Express installations prior to Version 6.0.
New Address TableEnter 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 TableEnter the name of the new table to be created. This table must either be empty or not exist for the conversion to take place.

 

Accessing IMP Webmail

To access your IMP Webmail:

  1. Enter http://hostname/imp/ in the address bar of your Web browser. The IMP login form is displayed.

  2. Enter your user name and password. Then depending on the configuration, you might need to select or enter information for your IMAP server.

  3. Click the Login button. Your inbox is displayed.

Additional Webmail Documentation

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