Chapter 2. Configuring Mail Clients for the Messaging Server

Table of Contents

Using Outlook and Outlook Express with the Messaging Server
Configuring Outlook Free/Busy Calendaring
Using Netscape Messenger with the Messaging Server
Using Eudora Mail with the Messaging Server
Initial Configuration with the Eudora Setup Wizard
SSL Configuration for Eudora Mail
Modifying Eudora Configuration
Using KMail with the Messaging Server
Using IMP Webmail with the Messaging Server

All mail client software -- programs that allow you to receive, read, compose and send email -- must be configured to recognize a mail server -- a program that directs messages intended for you to your mail client software. In some cases, your mail server might also provide your mail client with calendar information.

To configure your mail client, you must log in to the Preferences Manager. To do so, your mail administrator will supply a:

Note

We recommend that you use https URLs whenever possible, because they are more secure than conventional http URLs.

The following sections describe how to configure your mail client to recognize the Messaging Server. For Outlook and Outlook Express clients, this can be done with an automated utility; other clients must enter configuration information manually. To configure IMP webmail, you need only enter your account name and email address.

Using Outlook and Outlook Express with the Messaging Server

  1. Close Outlook or Outlook Express if you are currently using it.

    Note

    If you are running an Outlook 2000 or Outlook 98 mail client, your mail administrator might direct you to configure your mail client in either Corporate/Workgroup mode or Internet Email Only mode. If this is the case, you must configure your mail client before running the Preferences Manager.

  2. Log into Preferences Manager by pointing your browser at:

    https://hostname/msg

    where hostname is the system name supplied by the mail administrator for Preferences Manager access.

  3. When the Preferences Manager screen appears, enter your mail account name and password.

  4. Click on Client Setup in the Preferences menu. This displays configuration information used by your mail client software to communicate with the Messaging Server.

  5. Run the client configuration program by clicking the Configure button. The client configuration screen includes instructions on how to respond to further prompts.

  6. In the File Download dialogue window, select Run this program from its current location.

    Note

    If you are using the Netscape browser, you may see a dialogue window indicating ``Unknown File Type''. If you see this message:

    1. Click on Pick App in the dialogue window. A new dialogue window displays.

    2. Type ``wscript'' in the box and click on OK. A new dialogue window displays.

    3. Select the Open It checkbox and click on OK.

    You can now proceed to the next step.

  7. When prompted to configure your system with the Messaging Server, click on Yes.

    During the installation, you might be informed that Outlook is being started. If this is the first time Outlook has been run on your system, you will be prompted to select a networking mode; select Corporate/Workgroup or Internet Email Only depending on your Mail Administrator's instructions. If you are prompted to create an email account, click on Cancel or Close to exit the account creation dialog; it is not necessary to configure an account at this time.

    You might see a dialog box informing you that your Outlook client is configured in Internet Email Only mode. If this is correct, click on Yes to continue. If not, click on No to cancel the installation, configure your Outlook client in Corporate/Workgroup mode, and restart the Client Setup procedure.

    If the CorporateTime Outlook Connector is being installed on your system, you see progress displays on the Silent Installation screens.

  8. The InstallShield Wizard informs you that it is preparing to install the Volution Messaging Server Com-Addin if it is not already present on your system. Click on Next to continue.

    After a short time, you are informed that Volution Messaging Server Com-Addin files are being copied to your system. Click on Finish when prompted by the InstallShield Wizard, and click on OK when Volution Messaging Server configuration is complete.

This completes mail client configuration. When you start your Outlook client, you will be able to receive email with your new account. If the CorporateTime Outlook Connector is installed, you must log in with your Messaging Server UserID.

Note

The Outlook Configuration Tool indirectly configures Outlook XP by setting up Internet Email Accounts. When Outlook XP is started after running the Outlook Configuration Tool, it will prompt the user to import the new Internet Email Accounts that it has found. The user must click on Yes to have these new accounts configured within Outlook XP. Note that the LDAP address book for the Messaging Server will be configured but will not appear in the list of address books until Outlook XP is restarted after importing the accounts.

Configuring Outlook Free/Busy Calendaring

The Messaging Server includes support for the Microsoft Outlook "free/busy" calendar feature. When scheduling a meeting or other activity, this feature allows the person who is scheduling the meeting to see when others are free or busy.

Note

This feature is provided for Microsoft Outlook clients but not Outlook Express.

Although the Messaging Server configuration process adds this calendar feature to your Outlook client by default, the actual publication of your "free/busy" information is not enabled; this decision has been left to you. If you wish to enable publication of your "free/busy" information, you can do so within the Outlook Free/Busy configuration dialog:

  1. In the Outlook Tools, click on Options, then Calendar Options.

  2. In the Free/Busy Options dialog box, check Publish my free/busy information.

  3. If you are configuring Outlook XP, go to Step 4.

    Enter your Messaging Server password in the ftp://URL in place of password_for_yourname_here.

  4. Click on Apply to complete the procedure.

Using Netscape Messenger with the Messaging Server

  1. Close Netscape Messenger if you are currently using it.

  2. Log into the Preferences Manager by pointing your browser at:

    https://hostname/msg

    where hostname is the system name supplied by the mail administrator for Preferences Manager access.

  3. When the Preferences Manager screen appears, enter your mail account name and password.

  4. Click on the Client Setup in the Preferences menu. This displays configuration information used by your mail client software to communicate with the Messaging Server. Keep this screen available or print its contents.

  5. Start Netscape Messenger.

  6. In the Edit menu, select Preferences, then open Mail & Newsgroups.

  7. In the Identity preferences panel of Mail & Newsgroups, enter your user information in the boxes. The Your name and Email address fields are required, and the Your name field in Netscape Messenger must have the same contents as the Name field in the Preferences Manager client configuration display.

  8. In the Mail Servers preferences panel of Mail & Newsgroups, click on Add under Incoming Mail Servers to add the Messaging Server machine.

    1. Under the Mail Server Properties General panel:

      Server Name

      Enter the machine name on which the Messaging Server resides.

      Server Type

      Select IMAP Server or POP3 Server according to your mail administrator's instructions.

      User Name

      Enter the Account name from the Preferences Manager client configuration display.

    2. If you selected IMAP Server, under the Mail Server Properties Advanced panel:

      IMAP service directory

      enter user.name, where name is the value you entered for User Name.

  9. In the Mail Servers preferences panel of Mail & Newsgroups under Outgoing Mail Server:

    Outgoing mail (SMTP) server

    Enter the machine name on which the Messaging Server resides.

    Outgoing mail server user name

    Enter value you entered for User Name.

This completes mail client configuration. When you restart Netscape Messenger, you will be able to receive email with your new account.

Note

For Netscape Messenger Release 4.7, there is no Messaging Server support for using the Messaging Server LDAP directory for roaming access.

To set up the Netscape Messenger LDAP address book to use the Messaging Server:

  1. Start Communicator.

  2. Select Communicator->Address Book.

  3. In the Address Book screen, select File->New Directory.

  4. Enter:

    Description : Volution Messaging Server
    LDAP Server : server_name
    Server Root : server_root
      
    You can obtain the Server Root value from the Client Setup screen as the Searchbase parameter.

Using Eudora Mail with the Messaging Server

  1. Close Eudora Mail if you are currently using it.

  2. Log into the Preferences Manager by pointing your browser at:

    https://hostname/msg

    where hostname is the system name supplied by your mail administrator for Preferences Manager access.

  3. When the Preferences Manager screen appears, enter your mail account name and password.

  4. Click on the Client Setup in the Preferences menu. This displays configuration information used by your mail client software to communicate with the Messaging Server. Keep this screen available or print its contents.

Further configuration depends upon whether you are:

Initial Configuration with the Eudora Setup Wizard

The first time you launch Eudora, the Eudora New Account Setup Wizard appears. Proceed through the setup screens, entering information as requested and clicking on Next to continue.

  1. In the Account Settings screen, select Create a brand new email account.

  2. In the Personal Information screen, enter Your Name from the Name field in the Preferences Manager Client Setup display.

  3. In the Email Address screen, enter the Email Address from the Preferences Manager Client Setup display.

  4. In the Login Name screen, enter Login Name from the Name field in the Preferences Manager Client Setup display.

  5. In the Incoming Email Screen screen:

    • enter Incoming Server from the Server Name field in the Preferences Manager Client Setup display.

    • select POP or IMAP according to administrator guidelines.

    If IMAP is selected, an IMAP Location Prefix screen will be displayed. Leave the Location Prefix box blank.

  6. In the Outgoing Email Screen screen:

    • enter Outgoing Server from the Server Name field in the Preferences Manager Client Setup display.

    • select Allow Authentication (this should be the default).

  7. Click on Finish to complete configuration and exit the Setup Wizard. When you restart Eudora, you will be able to receive email with your new account.

SSL Configuration for Eudora Mail

Eudora Mail and the Messaging Server both provide SSL (Secure Socket Layer) security by default. Eudora provides a commercial Certificate Authority (CA) key, and the Messaging Server provides a demonstration key with the option of enabling a commercial key.

However, the Eudora default security configuration does not work correctly with the Messaging Server. Eudora tries to determine if TLS (Transport Layer Security) is supported by mail servers it connects with, and if not, to configure mail service without SSL. This check fails with this version of Messaging Server and Eudora 5.1; Eudora does not find the SSL alternate port and does not transfer mail.

To work around this problem, you must manually enable or disable SSL on your Eudora client. To do so:

  1. Start Eudora and select Tools->Options.

  2. Click on Checking Mail.

    The default value for the Secure Sockets when Sending field is Use TLS if Available. You must change it to one of the following entries:

    Never

    to receive mail without SSL security.

    Required, Alternate Port

    to receive mail with SSL security.

    Other selections will disable mail transfer.

  3. Click on Sending Mail.

    The default value for the Secure Sockets when Receiving field is Use TLS if Available. You must change it to one of the following entries:

    Never

    to send mail without SSL security.

    Required, Alternate Port

    to send mail with SSL security.

    Other selections will disable mail transfer.

  4. Restart Eudora.

    If you elected to disable SSL, this completes Eudora client configuration. Mail users can now use Eudora to send and receive email without SSL security.

    If you elected to enable SSL, you must have a server key and certificate of authority. If you have not already done so, you must use Webmin to generate a Certificate Signing Request (CSR) from a commercial Certificate Authority (CA) provider, or generate a self-signed certificate and key. For more information, see "Enabling SSL" in the Administrator's Guide.

    If you obtained a server key and certificate from a company for which Eurora already provides trusted client certificates (such as Verisign®), this completes Eudora client configuration. Verify that Eudora has accepted the server certificate:

    1. Select Tools->Options

    2. Click on Checking Mail.

    3. In the Last SSL Info, confirm that the server certificate is in the trusted list.

  5. If you did not obtain a server key and certificate from a company for which Eurora already provides trusted certificates or you generated your own key and certificate, you must manually configure Eudora to authenticate with the Messaging Server.

    Start Eudora and select Tools->Options You will be prompted to provide the password for your account, after which the download of the mail will fail.

    Attempt to download mail a second time; this will also fail, but the error message will indicate that Eudora does not trust the certificate supplied by the server.

  6. From the Eudora menu bar, select Tools->Options. Then click on Checking Mail and select Last SSL Info.

  7. In the Certificate Not Trusted dialog box, click on Certificate Information Manager. Select the server certificate for your mail server from the list of known untrusted server certificates, then click on Add to Trusted.

  8. Restart Eudora.

    This completes Eudora client configuration. Mail users can now use Eudora to send and receive email with SSL security.

Modifying Eudora Configuration

  1. In the Eudora Tools menu, select Options.

  2. Click on Getting Started, then enter:

    Real Name

    from the Name field in the Preferences Manager Client Setup display.

    Return Address

    from the Email Address field in the Preferences Manager Client Setup display.

    Mail Server

    from the Server Name field in the Preferences Manager Client Setup display.

    Login Name

    from the Name field in the Preferences Manager Client Setup display.

    SMTP Server

    from the Server Name field in the Preferences Manager Client Setup display.

    Allow Authentication

    check the box (this should be the default).

  3. Click on Checking Mail, then enter:

    Mail Server

    from the Server Name field in the Preferences Manager Client Setup display.

    Login Name

    from the Name field in the Preferences Manager Client Setup display.

    other fields

    use defaults.

    Allow Authentication

    check the box (this should be the default).

  4. Click on Incoming Mail, then enter:

    Server Configuration

    select POP or IMAP according to administrator guidelines.

    Authentication Style

    select Passwords.

    other fields

    use defaults.

  5. Click on Sending Mail, then enter:

    Return Address

    from the Email Address field in the Preferences Manager Client Setup display.

    SMTP Server

    from the Server Name field in the Preferences Manager Client Setup display.

    other fields

    use defaults.

  6. Click on OK to complete configuration and exit. When you restart Eudora, you will be able to receive email with your new account.

Using KMail with the Messaging Server

  1. Close KMail if you are currently using it.

  2. Log into Preferences Manager by pointing your browser at:

    https://hostname/msg

    where hostname is the system name supplied by the mail administrator for Preferences Manager access.

  3. When the Preferences Manager screen appears, enter your mail account name and password.

  4. Click on the Client Setup in the Preferences menu. This displays configuration information used by your mail client software to communicate with the Messaging Server. Keep this screen available or print its contents.

  5. Log into your Linux system and start KMail. If this is the first time KMail has been run, click on OK to create a Mail subdirectory in your home directory.

  6. In the KMail Settings menu, select Configuration .

  7. Click on Identity, then click on New Identity. Enter New Identity from the Account Name field in the Preferences Manager Client Setup display, and select "With empty fields".

  8. When your New Identity is displayed, enter:

    Name

    from the Name field in the Preferences Manager Client Setup display.

    Email Address

    from the Email Address field in the Preferences Manager Client Setup display.

    Reply To Address

    from the Email Address field in the Preferences Manager Client Setup display.

    Signature

    specify a file or enter a signature message in the box.

    Click on Apply to save your selections in the Identity screens.

  9. Click on Network and Sending Mail, then select:

    SMTP

    Enter Server from the Server Name field in the Preferences Manager Client Setup display, and use the default port number (unless instructed otherwise by your mail administrator).

    Incoming Mail

    Select Pop3, then enter:

    Name

    from the Name field in the Preferences Manager Client Setup display.

    Login

    from the Account Name field in the Preferences Manager Client Setup display.

    Password

    of your choice; you can elect to have KMail remember this password.

    Host

    from the Server Name field in the Preferences Manager Client Setup display.

    Port

    use the default.

    other fields

    Enter additional information as desired.

    Click on Apply to save your selections in the Network screens.

  10. Set Network Properties as desired and click on Apply to save your selections in the Network screens.

  11. Click on OK to complete configuration and exit. When you restart KMail, you will be able to receive email with your new account.

Using IMP Webmail with the Messaging Server

A webmail client provides the ability to read email using an Internet browser on any networked computer, rather than a dedicated mail program on a single computer. This is useful if you need to read your email from different locations or on different machines.

To log into the IMP webmail client, you need the following information from your mail administrator:

  • your Messaging Server account name and initial password.

  • your Messaging Server email address.

  • the IMP client URL, usually:

    https://hostname/horde/imp

If your IMP client has not already been configured for the Messaging Server:

  1. Log into IMP by pointing your browser at:

    https://hostname/horde/imp

  2. Enter your account name and password.

  3. Click on Preferences and enter your Messaging Server account name and email address.

This completes IMP client configuration. To view and modify your Messaging Server user preferences, log into Preferences Manager by pointing your browser at:

https://hostname/msg

where hostname is the system name supplied by the mail administrator for Preferences Manager access. When you enter your mail account name and password, you will see the Preferences Manager screen.

Note

The IMP webmail client does not work consistently on Netscape 6.0 and 6.1 browsers; you must upgrade to Netscape 6.2. You can also connect to the Messaging Server from an IMP client on Netscape 4.7.