SCOoffice Mail
Connector For Microsoft Outlook
Installation Guide
Outlook 2002
Rev 1.2
SCOoffice Mail Connector for Microsoft Outlook
Installation Guide - Outlook XP
This document describes the SCOoffice Mail Connector for
Microsoft Outlook, how to install and configure it, and how to use some of its
features. These are the main points that you will find in this document:
The SCOoffice Mail Connector for Microsoft Outlook seamlessly enables the
full collaborative features of Microsoft Outlook when used with the SCOoffice Mail Server. For example, SCOoffice Mail Server users can utilize
Outlook shared global address books, shared message folders, shared contacts,
shared calendars, calendar and folder delegation, and shared forms libraries to
name a few. Historically, these features were only available through Outlook
when using a Microsoft Exchange Server.
The collaborative features of Outlook are now available without the high
cost and complexity of Microsoft Exchange.
The SCOoffice
Mail Connector enhances the appearance of Outlook with the addition of the
Connector toolbar to the Outlook menu. The toolbar consists of five buttons
which allow the user to configure email accounts, set folder options, share
folders and set folder access permissions. Aside from this toolbar, the user
experience of using Outlook is essentially unchanged.
The
SCOoffice Mail Connector is installed
on the Microsoft Windows system where Outlook is to be used. It is an Exchange
client extension which simply means that it transparently plugs into Outlook to
extend its abilities in the manner described above. It can be used with any
version of Microsoft Outlook from 97 through 2002. Outlook 98 and
Outlook 2000 must be configured in Corporate Workgroup mode so that the
necessary services of Outlook will be installed and enabled. Outlook 97 and
Outlook 2002 have no concept of the Corporate Workgroup mode and provide the
necessary services by default.
· This guide was written specifically for Microsoft Outlook XP. If you are using Microsoft Outlook 97, Outlook 98 or Outlook 2000 refer to the document titled “SCOoffice Mail Connector Installation Guide for Microsoft Outlook 97, 98 and 2000”.
· Verify that you already have an email account activated on your SCOoffice Mail Server.
· You will need the following information to configure the Mail Connector. This information should be provided to you by your system administrator.
o The fully qualified hostname of the SCOoffice Mail Server.
o Your SCOoffice Mail Server email login ID and password.
o Your email address.
o Your license key for the Mail Connector.
· If you will be migrating email from a Microsoft Exchange server mailbox to a SCOoffice Mail Server mailbox be sure that the Exchange mailbox is configured in Outlook before you install the Mail Connector. Additionally, and most importantly, the Mail Connector must be configured to use a PST file for the SCOoffice Mail Server mail account that is different from the PST file used for the Microsoft Exchange mail account.
1. Close Outlook if it is running.
2. If you are upgrading from a previous version of the SCOoffice Mail Connector it is not necessary to remove the old version. It is strongly recommended that you run the scanpst.exe program to repair any inconsistencies in the PST file prior to installing the new version. The scanpst.exe program can be found in one of these two locations:
‘Program Files\Common Files\System\Mapi\1033’
‘Program Files\Common Files\System\Mapi\1033\NT’
3. Download the SCOoffice Mail Connector zip file and extract the contents using an unzip/decompress utility, such as WinZip
4. Run the resulting SCOoffice Mail Connector setup program to install the SCOoffice Mail Connector software. Enter the SCOoffice Mail Connector license key when prompted to do so.
5. If you are upgrading from a previous version of the SCOoffice Mail Connector you are done otherwise proceed to the following section.
1. Start Outlook.
If this is the first time running Outlook the ‘Outlook 2002 Startup’ dialog window will be displayed. If the ‘Outlook 2002 Startup’ dialog is displayed perform the following and proceed to step 2.
· Click ‘Next’.
The ‘Account Configuration (E-mail Accounts)’ dialog window will be displayed.
· Select ‘Yes’ to configure a new account.
· Click ‘Next’ and proceed to step 2 below.
If no email accounts for Outlook have been previously configured Outlook will display the ‘E-mail Accounts’ dialog window. If the ‘E-mail Accounts’ dialog is displayed perform the following and proceed to step 2.
If an Outlook
POP3/SMTP email account is already configured the ‘SCOoffice Mail Connector Wizard’ may appear. This wizard is used to
configure the Mail Connector to bind the POP3/SMTP email account (and PST file)
with the SCOoffice Mail Server. If
the ‘SCOoffice Mail Connector Wizard’
is displayed proceed to step 3.
If Outlook
starts up normally proceed to the section titled ‘Email Account Configuration –
Manual Steps’. Use the instructions in that section to
configure your email account for use with the Mail Connector.
2. Setting up the POP3/SMTP email account.
The ‘E-mail Accounts (Server Type)’ dialog window should be displayed.
· Select ‘POP3’.
· Click ‘Next’.
The ‘E-mail Accounts (Internet E-mail Settings POP3)’ dialog will be displayed. Enter the following information:
Your Name: Your first and last name.
E-mail Address: Your e-mail address.
Incoming POP3 mail server: Enter ‘none’
Outgoing SMTP mail server: The hostname of your SCOoffice Mail Server.
User Name: Your SCOoffice Mail Server email login ID.
Password: your email login ID password.
The ‘E-mail Accounts (Congratulations)’ dialog will be displayed.
The ‘SCOoffice Mail Connector Wizard’ dialog
window should now be displayed. In this case proceed to step 3 below. If the ‘SCOoffice Mail Connector Wizard’ dialog is
not displayed proceed to the section titled ‘Email Account Configuration –
Manual Steps’.
3. Connector Setup Wizard – specifying the PST file and the SCOoffice Mail Server email login ID and password.
The “SCOoffice Mail Connector Wizard’ dialog window should be displayed.
The next dialog is used to specify the hostname of the (IMAP) SCOoffice Mail Server and the email login ID and password used to access your email account. Enter the following information:
Hostname: Hostname of the SCOoffice Mail Server.
Port 143: For SSL set
this to 993 and check mark ‘Use SSL (secure connection)’
Login: Your SCOoffice Mail Server email login ID (not your email address)
Password: The password for your email login ID.
Ensure that the check box for ‘Map this store to the following IMAP server’ is checked.
Now click the ‘Ping Server’ button. ‘Ping Server’ will check for connectivity to the SCOoffice Mail Server and the validity of the email login ID and password.
If ‘Ping Server’ is unsuccessful your Outlook client may not have network connectivity, or the SCOoffice Mail Server was unable to authenticate the email login ID and password you entered. Re-enter your email login ID and password and try again. If ‘Ping Server’ fails again clear the error message by clicking ‘OK’ and click ‘Cancel’. You will then be asked if you would like to restart the wizard the next time you open Outlook. If you choose not to re-start the wizard you may configure your email account at a later date using the ‘Email Account Configuration – Manual Steps’ instructions contained within this document. Report your problem to the system administrator.
If ‘Ping Server’ is successful click ‘OK’ to clear the success message.
The next dialog is used to select the Personal Folders file (PST file) for the email account. The PST file resides on your computer and is used as an intermediate storage location for messages as they flow between Outlook and the SCOoffice Mail Server via the Mail Connector.
To use the PST file created by step 2 above click the radio button to select ‘Use one of the existing PST files’ then click on the PST file in the list. Most likely this will be ‘Personal Folders’. Advanced users may want to create a new PST file which is also appropriate for this step.
The next dialog window describes the manual configuration of the Internet Mail service and POP3/SMTP email account. Ignore the instructions in this dialog window.
4. Restart Outlook.
Perform steps 5, 6 and 7 in the following section to complete the configuration.
1. Setting up the PST file and specifying the SCOoffice Mail Server email login ID and password.
The ’SCOoffice Mail Connector Options’ dialog window will be displayed.
The ‘Add New IMAP Mailbox’ dialog window will be displayed. Select ‘Create a new PST file’ or ‘Use existing PST file’. If you select ‘Use existing PST file’ you will also need to highlight the PST file by clicking on it in the list provided. If you are not configuring the Mail Connector for the first time you should select ‘Create a new PST file’.
You should be back at the ’SCOoffice Mail Connector Options’ dialog window. Select the mailbox (PST file) specified in the previous step by clicking on it in the list provided.
The ‘SCOoffice Mail Connector Host Information’ dialog window will be displayed. Enter the following information:
Hostname: Hostname of the SCOoffice Mail Server.
Port 143: For SSL set
this to 993 and check mark ‘Use SSL (secure connection)’
Login: Your SCOoffice Mail Server email login ID.
Password: The password for your email login ID.
Ensure that the check box for ‘Map this store to the following IMAP server’ is checked.
Now click the ‘Ping Server’ button. ‘Ping Server’ will check for connectivity to the SCOoffice Mail Server and the validity of the email login ID and password.
If ‘Ping Server’ is unsuccessful your Outlook client may not have network connectivity, or the SCOoffice Mail Server was unable to authenticate the email login ID and password you entered. Re-enter your email login ID and password and try again. If ‘Ping Server’ fails again clear the error message by clicking ‘OK’ and click ‘Cancel’. Report your problem to the system administrator.
If ‘Ping Server’ is successful click ‘OK’ to clear the success message.
2. Setting up the POP3/SMTP email account and set the Delivery location to the PST file from step 1.
You need to setup a POP3/SMTP account if you do not already have one for the SCOoffice Mail Connector. The SMTP service is required by the SCOoffice Mail Connector for sending messages. The POP3 portion of the service is essentially ignored by the SCOoffice Mail Connector.
To setup POP3/SMTP for Outlook 2002:
· Click on the ‘Tools’ in the Outlook menu and select ‘E-mail Accounts’.
The ‘E-mail Accounts (E-mail Accounts)’ dialog window will be displayed.
The ‘E-mail Accounts (Server Type)’ dialog window should be displayed.
· Select ‘POP3’.
· Click ‘Next’.
The ‘E-mail Accounts (Internet E-mail Settings POP3)’ dialog will be displayed. Enter the following information:
Your Name: Your first and last name.
E-mail Address: Your e-mail address.
Incoming POP3 mail server: Enter ‘none’
Outgoing SMTP mail server: The hostname of your SCOoffice Mail Server.
User Name: Your SCOoffice Mail Server email login ID.
Password: your email login ID password.
The ‘E-mail Accounts (Congratulations)’ dialog will be displayed.
3. Setting the delivery location (PST file) for your POP3/SMTP email account.
· Click on the ‘Tools’ in the Outlook menu and select ‘E-mail Accounts’.
The ‘E-mail Accounts (E-mail Accounts)’ dialog window will be displayed.
In the upper selection box titled ‘Outlook processes e-mail for these accounts in the following order’ highlight the email account you created in step 2 by clicking on it in the list.
In the lower pull-down selection box titled ‘Deliver new e-mail to the following location’ select the PST file that you specified in step 1 above.
4. Restart Outlook.
5. Disabling Outlook email account synchronization.
Email accounts managed by the SCOoffice Mail Connector are synchronized with the SCOoffice Mail Server by the Mail Connector. Synchronization by Outlook of these accounts must be disabled otherwise you may receive duplicate messages. Email accounts not managed by the Mail Connector should continue to be synchronized by Outlook.
Disabling Outlook synchronization
· Click ‘Ok’.
6. Migration of Outlook’s pre-defined Special Folders
The Outlook pre-defined Special Folders are Contacts, Calendar, Journal, Notes, and Tasks. The default placement of these folders in the Outlook Folders List (click on ‘View’ and select ‘Folders List’ in the Outlook menu) is at the same level as Inbox. When using the Mail Connector with the Caldera Volution Messaging Server the Special Folders must be subfolders of Inbox. The Mail Connector will perform the migration automatically when one of these folders is selected or the Folder List is collapsed and re-expanded by clicking the ‘–‘ and ‘+’ symbols are the top of the Folder List hierarchy.
When the Mail
Connector performs the migration a message window will be displayed for each
folder when it is migrated. The message window will indicate that the folder,
such as Calendar, could not be created on the server at the same level as Inbox
and prompts to have the folder created under Inbox. Simply respond ‘Yes’ to
each of these prompts.
Note: If you are using the Mail Connector with SCOoffice Mail Server the migration of the Special Folders may not occur. A new feature of the SCOoffice Mail Server allows the systems administrator to configure the server so that the Special Folders can appear at the same level as ‘Inbox’ in the folder list.
7.
Configuring free/busy calendar information.
If you will be using the Outlook calendar to schedule meetings with other people you will want to configure Outlook to publish you free/busy calendar information to the SCOoffice Mail Server. This will allow other users to determine when you are available for meetings.
In the ‘Publish at my location’ input box enter the following:
http://hostname/pub/calendar/email.vfb
Example: http://myserver.com/pub/calendar/bob.vfb
In the ‘Search location’ input box enter the following:
ftp://hostname/pub/calendar/%NAME%.vfb
Example: ftp://myserver.com/pub/calendar/%NAME%.vfb
Using the SCOoffice Mail Connector
·
Determining the version of the SCOoffice Mail Connector
The version and build numbers of the SCOoffice Mail Connector can be displayed by clicking ‘About’ in the SCOoffice Mail Connector toolbar. The version number is plainly labeled. The build number immediately follows the copyright notice.
·
A note
about migration from MS Exchange Server to SCOoffice Mail Server
If you have
correctly configured Outlook both the Exchange mailbox folders and the SCOoffice Mail Server mailbox folder will
appear in the Outlook mail folder list. Simply copy the Exchange folders to the
corresponding folders in the SCOoffice Mail
Server account.
After the
initial synchronization is complete, the Exchange server can be dismantled and
the Exchange service can be removed from Outlook client. Exchange services in
Outlook are not required for the SCOoffice
Mail Connector.
·
Using
Shared Folders
The SCOoffice Mail Connector allows you to share your mail folders and Special Folders, such as Calendar, with other SCOoffice Mail Server users. Folders are shared simply by granting permission for other users to access the folder. Having done this the folder will automatically appear in the other users Outlook Folders List. Permissions are assigned on a per user per folder basis.
To share a folder with other users:
a. Display the Outlook folders list by clicking on ‘View’ then ‘Folder List’ in the Outlook menu.
b. Click on the folder in the folder list that you with to share.
c. Click the ‘Folder’ button in the SCOoffice Mail Connector toolbar.
The ‘SCOoffice Mail Folder Options’ dialog window will be displayed
To add a user to the list of users who will have access to the folder:
· Click on ‘Add’ in the ‘Permissions’ section of the dialog window.
· Enter the users email login ID, not their email address, in the space provided. Normally, the users email login ID is the same as their email address. Click ‘OK’.
· Select the permissions that you wish to assign to the user.
To modify permissions assigned to a user:
· Select the email ID of the user in the list by clicking on it.
· Select and de-select permission as appropriate.
To remove permissions for a user:
· Select the email ID of the user in the list by clicking on it.
· Click the ‘Remove’ button in the ‘permission’ section of the dialog window.
d. When you are done changing permissions click ‘OK’ at the bottom of the ‘SCOoffice Mail Folder Options’ dialog window.
By default, the ‘Permissions’ list box will lists the owner of the folder with all access rights assigned (enabled). Removing the owner from the list of users who have access to the folder will lock the owner out of their own folder. Any user with administrator privileges on the folder can assign access back to the owner.
The special user ‘anyone’ can be used to assign permissions to all users.
Note that permissions can not be viewed or assigned to empty folders.
The access rights are defined as follows:
· Lookup – Look up the name of the folder (but not its contents).
· Read – Read the contents of the folder.
· Insert – Insert (move or copy) a message into the folder.
· Write – Write or change message flags such as ‘recent’, ‘answered’, and ‘draft’.
· Set Seen Flag – Preserve the ‘seen’ and ‘recent’ status of messages.
·
Post –
Post a message in the folder by sending the message to the mailboxes submission
address.
·
Create –
Create a new sub-folder within the shared folder.
·
Delete –
Delete a message and/or the folder itself.
·
Administer
– A user with ‘Administer’ privileges can set the permissions on the folder
as if they were the real owner.
·
Setting
SCOoffice Mail Connector folder
synchronization options
As mentioned earlier in this guide the PST file resides on your computer and is used as an intermediate storage/work location for messages as they flow between Outlook and the SCOoffice Mail Server via the Mail Connector. Folder synchronization means that the contents of the PST file (local copy of your folders) are synchronized with the SCOoffice Mail Server folders. By default, folders are set to synchronize with the SCOoffice Mail Server every time you select the folder in the Outlook folder list. However, this may not be appropriate for high traffic folders such as Inbox.
To change synchronization for a
folder:
a. Display the Outlook folders list by clicking on ‘View’ then ‘Folder List’ in the Outlook menu.
b. Click on the folder in the folder list that you with to share.
c. Click the ‘Folder’ button in the SCOoffice Mail Connector toolbar. The ‘SCOoffice Mail Folder Options’ dialog window will be displayed. Set options as appropriate.