Trademarks

Microsoft Windows, Windows Mobile, Outlook, Windows XP, Windows Vista are all registered trademarks of Microsoft Corporation in the United States, other countries, or both.

BlackBerry is a registered trademark of Research In Motion Limited in the United States, other countries, or both.

All other trademarks are the property of their respective owners.

Technical Support

The WebDAV Collaborator comes with a perpetual use license and a courtesy 30 day support. Additional annual support and maintenance can be purchased here: http://www.bynari.net/product/renew-support/. For large volume purchases contact sales@bynari.net.

Customers who are current on support continue to receive product maintenance, upgrades and email support.

Licensing

The Bynari WebDAV Collaborator utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Bynari WebDAV Collaborator (WC) will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Bynari WebDAV Collaborator license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Bynari WebDAV Collaborator may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of user IDs for the licenses has been exceeded. The Bynari License Server tracks how many user IDs have been activated for each valid license. If there are attempts to activate more user IDs than were purchased for that license, the Bynari WebDAV Collaborator will inform you that additional licenses need to be purchased.

If you need to reinstall the Bynari WebDAV Collaborator software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Bynari WebDAV Collaborator toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 1.0 build of the Bynari WebDAV Collaborator available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

1.3 Supported Servers

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The WebDAV Collaborator 1.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the WebDAV Collaborator and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

2.2 Installing Bynari WebDAV Collaborator – New Installation

The following section explains how to install the Bynari WebDAV Collaborator 1.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Bynari WebDAV Collaborator will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Bynari WebDAV Collaborator and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Bynari WebDAV Collaborator. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

3.1.1 WebDAV Folder Settings

3.1.2 Folder List

You are now presented with a list of folders which the WebDAV Collaborator can sync for you. The configuration process is the same for each of the folders in this list. In the following steps we configure a calendar, as an example.Figure 11 – Bynari WebDAV Collaborator – Folder List

3.1.3 Choose a Folder

3.1.4 Folder Settings

The folder settings window will display the folder mappings to the WebDAV server. Complete all fields required by your WebDAV server, then click the “Detect Account Settings” button. If you are unsure of the settings required by your server, contact your server administrator.Figure 13 – Bynari WebDAV Collaborator –Folder Settings

Folder Display Name
Outlook folder name configured to WebDAV server.

Folder Type
Type of folder.

Folder Path
Folder path in Outlook local cache file.

Username
WebDAV Server login user name

Password
WebDAV Server user login password

E-Mail
WebDAV Server e-mail associated with the account, can be different from Username

Server URL
WebDAV Server URL to synchronize with. You can use a short URL for WebDAV Collaborator to figure out the URL if the server supports ‘Principal’ request.Default Server URL for BCS Server 7.4+ are:
Calendars: http://server/dav/calendars/
Contacts: http://server/dav/addressbooks/

Synchronize when Outlook shuts down
If enabled, WebDAV Collaborator will synchronize the data before Outlook will exit

Detect Account Settings
Button to detect the account settings and URL is correct or display a list of URL from the WebDAV Server principal request

Synchronize Interval in Minutes
Select synchronization interval for this folder. See “Default Settings” for more information.

Conflict Resolution
Select how to handle conflicts between client and server data. See “Default Settings” for more information.

Synchronization Modes
Select how the synchronization will perform of merging data, client is master or server is master. See “Default Settings” for more information.

3.1.6 Create and Delete Folders on Server

WebDAV Collaborator can create and delete folders from the server. The URL must be part of the URL principals to be able create and delete folders.

Figure 15 – Bynari WebDAV Collaborator – Create Server Folder

Once the folder is created or deleted, the list of folders from the server will be updated.

Figure 16 – Bynari WebDAV Collaborator – Server Folders

When deleting a folder, WebDAV Collaborator will prompt you if you want to delete the folder from the server.

Figure 17 – Bynari WebDAV Collaborator – Delete Server Folder

3.1.7 Successful Test

If you have a reliable network connection to the server, and you have correctly entered the settings required by your WebDAV server, you will receive a “URL successfully detected” message. If you do not receive this message, contact your WebDAV server administrator.Figure 19 – Bynari WebDAV Collaborator – URL successfully detected

3.1.10 Configuration Complete

Once the synchronization has completed, then you have successfully configured and synchronized your Calendar. Contacts, Journal, Notes and Tasks folders are configured using the same steps that we have just used to configure and synchronize the calendar folder.

3.2 Register the Bynari WebDAV Collaborator

Click on “About” in the Bynari WebDAV Collaborator Toolbar.Figure 23 – About

Licensing

The Bynari WebDAV Collaborator utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Bynari WebDAV Collaborator (WC) will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Bynari WebDAV Collaborator license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Bynari WebDAV Collaborator may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of user IDs for the licenses has been exceeded. The Bynari License Server tracks how many user IDs have been activated for each valid license. If there are attempts to activate more user IDs than were purchased for that license, the Bynari WebDAV Collaborator will inform you that additional licenses need to be purchased.

If you need to reinstall the Bynari WebDAV Collaborator software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Bynari WebDAV Collaborator toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 1.0 build of the Bynari WebDAV Collaborator available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

1.3 Supported Servers

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The WebDAV Collaborator 1.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the WebDAV Collaborator and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Windows® 8

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Outlook® 2013

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

2.2 Installing Bynari WebDAV Collaborator – New Installation

The following section explains how to install the Bynari WebDAV Collaborator 1.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Bynari WebDAV Collaborator will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Bynari WebDAV Collaborator and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Bynari WebDAV Collaborator. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

3.1.1 WebDAV Folder Settings

3.1.2 Folder List

You are now presented with a list of folders which the WebDAV Collaborator can sync for you. The configuration process is the same for each of the folders in this list. In the following steps we configure a calendar, as an example.Figure 11 – Bynari WebDAV Collaborator – Folder List

3.1.3 Choose a Folder

3.1.4 Folder Settings

The folder settings window will display the folder mappings to the WebDAV server. Complete all fields required by your WebDAV server, then click the “Detect Account Settings” button. If you are unsure of the settings required by your server, contact your server administrator.Figure 13 – Bynari WebDAV Collaborator –Folder Settings

Folder Display Name
Outlook folder name configured to WebDAV server.

Folder Type
Type of folder.

Folder Path
Folder path in Outlook local cache file.

Username
WebDAV Server login user name

Password
WebDAV Server user login password

E-Mail
WebDAV Server e-mail associated with the account, can be different from Username

Server URL
WebDAV Server URL to synchronize with. You can use a short URL for WebDAV Collaborator to figure out the URL if the server supports ‘Principal’ request.Default Server URL for BCS Server 7.4+ are:
Calendars: http://server/dav/calendars/
Contacts: http://server/dav/addressbooks/

Synchronize when Outlook shuts down
If enabled, WebDAV Collaborator will synchronize the data before Outlook will exit

Detect Account Settings
Button to detect the account settings and URL is correct or display a list of URL from the WebDAV Server principal request

Synchronize Interval in Minutes
Select synchronization interval for this folder. See “Default Settings” for more information.

Conflict Resolution
Select how to handle conflicts between client and server data. See “Default Settings” for more information.

Synchronization Modes
Select how the synchronization will perform of merging data, client is master or server is master. See “Default Settings” for more information.

3.1.6 Create and Delete Folders on Server

WebDAV Collaborator can create and delete folders from the server. The URL must be part of the URL principals to be able create and delete folders.

Figure 15 – Bynari WebDAV Collaborator – Create Server Folder

Once the folder is created or deleted, the list of folders from the server will be updated.

Figure 16 – Bynari WebDAV Collaborator – Server Folders

When deleting a folder, WebDAV Collaborator will prompt you if you want to delete the folder from the server.

Figure 17 – Bynari WebDAV Collaborator – Delete Server Folder

3.1.7 Successful Test

If you have a reliable network connection to the server, and you have correctly entered the settings required by your WebDAV server, you will receive a “URL successfully detected” message. If you do not receive this message, contact your WebDAV server administrator.Figure 19 – Bynari WebDAV Collaborator – URL successfully detected

3.1.10 Configuration Complete

Once the synchronization has completed, then you have successfully configured and synchronized your Calendar. Contacts, Journal, Notes and Tasks folders are configured using the same steps that we have just used to configure and synchronize the calendar folder.

3.2 Register the Bynari WebDAV Collaborator

Click on “About” in the Bynari WebDAV Collaborator Toolbar.Figure 23 – About

Licensing

The Bynari WebDAV Collaborator utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Bynari WebDAV Collaborator (WC) will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Bynari WebDAV Collaborator license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Bynari WebDAV Collaborator may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of user IDs for the licenses has been exceeded. The Bynari License Server tracks how many user IDs have been activated for each valid license. If there are attempts to activate more user IDs than were purchased for that license, the Bynari WebDAV Collaborator will inform you that additional licenses need to be purchased.

If you need to reinstall the Bynari WebDAV Collaborator software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Bynari WebDAV Collaborator toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 1.0 build of the Bynari WebDAV Collaborator available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

1.3 Supported Servers

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The WebDAV Collaborator 1.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the WebDAV Collaborator and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

2.2 Installing Bynari WebDAV Collaborator – New Installation

The following section explains how to install the Bynari WebDAV Collaborator 1.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Bynari WebDAV Collaborator will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Bynari WebDAV Collaborator and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Bynari WebDAV Collaborator. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

3.1.1 WebDAV Folder Settings

3.1.2 Folder List

You are now presented with a list of folders which the WebDAV Collaborator can sync for you. The configuration process is the same for each of the folders in this list. In the following steps we configure a calendar, as an example.Figure 11 – Bynari WebDAV Collaborator – Folder List

3.1.3 Choose a Folder

3.1.4 Folder Settings

The folder settings window will display the folder mappings to the WebDAV server. Complete all fields required by your WebDAV server, then click the “Detect Account Settings” button. If you are unsure of the settings required by your server, contact your server administrator.Figure 13 – Bynari WebDAV Collaborator –Folder Settings

Folder Display Name
Outlook folder name configured to WebDAV server.

Folder Type
Type of folder.

Folder Path
Folder path in Outlook local cache file.

Username
WebDAV Server login user name

Password
WebDAV Server user login password

E-Mail
WebDAV Server e-mail associated with the account, can be different from Username

Server URL
WebDAV Server URL to synchronize with. You can use a short URL for WebDAV Collaborator to figure out the URL if the server supports ‘Principal’ request.Default Server URL for BCS Server 7.4+ are:
Calendars: http://server/dav/calendars/
Contacts: http://server/dav/addressbooks/

Synchronize when Outlook shuts down
If enabled, WebDAV Collaborator will synchronize the data before Outlook will exit

Detect Account Settings
Button to detect the account settings and URL is correct or display a list of URL from the WebDAV Server principal request

Synchronize Interval in Minutes
Select synchronization interval for this folder. See “Default Settings” for more information.

Conflict Resolution
Select how to handle conflicts between client and server data. See “Default Settings” for more information.

Synchronization Modes
Select how the synchronization will perform of merging data, client is master or server is master. See “Default Settings” for more information.

3.1.6 Create and Delete Folders on Server

WebDAV Collaborator can create and delete folders from the server. The URL must be part of the URL principals to be able create and delete folders.

Figure 15 – Bynari WebDAV Collaborator – Create Server Folder

Once the folder is created or deleted, the list of folders from the server will be updated.

Figure 16 – Bynari WebDAV Collaborator – Server Folders

When deleting a folder, WebDAV Collaborator will prompt you if you want to delete the folder from the server.

Figure 17 – Bynari WebDAV Collaborator – Delete Server Folder

3.1.7 Successful Test

If you have a reliable network connection to the server, and you have correctly entered the settings required by your WebDAV server, you will receive a “URL successfully detected” message. If you do not receive this message, contact your WebDAV server administrator.Figure 19 – Bynari WebDAV Collaborator – URL successfully detected

3.1.10 Configuration Complete

Once the synchronization has completed, then you have successfully configured and synchronized your Calendar. Contacts, Journal, Notes and Tasks folders are configured using the same steps that we have just used to configure and synchronize the calendar folder.

3.2 Register the Bynari WebDAV Collaborator

Click on “About” in the Bynari WebDAV Collaborator Toolbar.Figure 23 – About

Licensing

The Bynari WebDAV Collaborator utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Bynari WebDAV Collaborator (WC) will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Bynari WebDAV Collaborator license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Bynari WebDAV Collaborator may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of user IDs for the licenses has been exceeded. The Bynari License Server tracks how many user IDs have been activated for each valid license. If there are attempts to activate more user IDs than were purchased for that license, the Bynari WebDAV Collaborator will inform you that additional licenses need to be purchased.

If you need to reinstall the Bynari WebDAV Collaborator software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Bynari WebDAV Collaborator toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 1.0 build of the Bynari WebDAV Collaborator available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

1.3 Supported Servers

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The WebDAV Collaborator 1.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the WebDAV Collaborator and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

2.2 Installing Bynari WebDAV Collaborator – New Installation

The following section explains how to install the Bynari WebDAV Collaborator 1.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Bynari WebDAV Collaborator will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Bynari WebDAV Collaborator and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Bynari WebDAV Collaborator. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

3.1.1 WebDAV Folder Settings

3.1.2 Folder List

You are now presented with a list of folders which the WebDAV Collaborator can sync for you. The configuration process is the same for each of the folders in this list. In the following steps we configure a calendar, as an example.Figure 11 – Bynari WebDAV Collaborator – Folder List

3.1.3 Choose a Folder

3.1.4 Folder Settings

The folder settings window will display the folder mappings to the WebDAV server. Complete all fields required by your WebDAV server, then click the “Detect Account Settings” button. If you are unsure of the settings required by your server, contact your server administrator.Figure 13 – Bynari WebDAV Collaborator –Folder Settings

Folder Display Name
Outlook folder name configured to WebDAV server.

Folder Type
Type of folder.

Folder Path
Folder path in Outlook local cache file.

Username
WebDAV Server login user name

Password
WebDAV Server user login password

E-Mail
WebDAV Server e-mail associated with the account, can be different from Username

Server URL
WebDAV Server URL to synchronize with. You can use a short URL for WebDAV Collaborator to figure out the URL if the server supports ‘Principal’ request.Default Server URL for BCS Server 7.4+ are:
Calendars: http://server/dav/calendars/
Contacts: http://server/dav/addressbooks/

Synchronize when Outlook shuts down
If enabled, WebDAV Collaborator will synchronize the data before Outlook will exit

Detect Account Settings
Button to detect the account settings and URL is correct or display a list of URL from the WebDAV Server principal request

Synchronize Interval in Minutes
Select synchronization interval for this folder. See “Default Settings” for more information.

Conflict Resolution
Select how to handle conflicts between client and server data. See “Default Settings” for more information.

Synchronization Modes
Select how the synchronization will perform of merging data, client is master or server is master. See “Default Settings” for more information.

3.1.6 Create and Delete Folders on Server

WebDAV Collaborator can create and delete folders from the server. The URL must be part of the URL principals to be able create and delete folders.

Figure 15 – Bynari WebDAV Collaborator – Create Server Folder

Once the folder is created or deleted, the list of folders from the server will be updated.

Figure 16 – Bynari WebDAV Collaborator – Server Folders

When deleting a folder, WebDAV Collaborator will prompt you if you want to delete the folder from the server.

Figure 17 – Bynari WebDAV Collaborator – Delete Server Folder

3.1.7 Successful Test

If you have a reliable network connection to the server, and you have correctly entered the settings required by your WebDAV server, you will receive a “URL successfully detected” message. If you do not receive this message, contact your WebDAV server administrator.Figure 19 – Bynari WebDAV Collaborator – URL successfully detected

3.1.10 Configuration Complete

Once the synchronization has completed, then you have successfully configured and synchronized your Calendar. Contacts, Journal, Notes and Tasks folders are configured using the same steps that we have just used to configure and synchronize the calendar folder.

3.2 Register the Bynari WebDAV Collaborator

Click on “About” in the Bynari WebDAV Collaborator Toolbar.Figure 23 – About

Licensing

The Bynari WebDAV Collaborator utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Bynari WebDAV Collaborator (WC) will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Bynari WebDAV Collaborator license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Bynari WebDAV Collaborator may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of user IDs for the licenses has been exceeded. The Bynari License Server tracks how many user IDs have been activated for each valid license. If there are attempts to activate more user IDs than were purchased for that license, the Bynari WebDAV Collaborator will inform you that additional licenses need to be purchased.

If you need to reinstall the Bynari WebDAV Collaborator software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Bynari WebDAV Collaborator toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 1.0 build of the Bynari WebDAV Collaborator available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

1.3 Supported Servers

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The WebDAV Collaborator 1.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the WebDAV Collaborator and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

2.2 Installing Bynari WebDAV Collaborator – New Installation

The following section explains how to install the Bynari WebDAV Collaborator 1.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Bynari WebDAV Collaborator will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Bynari WebDAV Collaborator and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Bynari WebDAV Collaborator. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

3.1.1 WebDAV Folder Settings

3.1.2 Folder List

You are now presented with a list of folders which the WebDAV Collaborator can sync for you. The configuration process is the same for each of the folders in this list. In the following steps we configure a calendar, as an example.Figure 11 – Bynari WebDAV Collaborator – Folder List

3.1.3 Choose a Folder

3.1.4 Folder Settings

The folder settings window will display the folder mappings to the WebDAV server. Complete all fields required by your WebDAV server, then click the “Detect Account Settings” button. If you are unsure of the settings required by your server, contact your server administrator.Figure 13 – Bynari WebDAV Collaborator –Folder Settings

Folder Display Name
Outlook folder name configured to WebDAV server.

Folder Type
Type of folder.

Folder Path
Folder path in Outlook local cache file.

Username
WebDAV Server login user name

Password
WebDAV Server user login password

E-Mail
WebDAV Server e-mail associated with the account, can be different from Username

Server URL
WebDAV Server URL to synchronize with. You can use a short URL for WebDAV Collaborator to figure out the URL if the server supports ‘Principal’ request.Default Server URL for BCS Server 7.4+ are:
Calendars: http://server/dav/calendars/
Contacts: http://server/dav/addressbooks/

Synchronize when Outlook shuts down
If enabled, WebDAV Collaborator will synchronize the data before Outlook will exit

Detect Account Settings
Button to detect the account settings and URL is correct or display a list of URL from the WebDAV Server principal request

Synchronize Interval in Minutes
Select synchronization interval for this folder. See “Default Settings” for more information.

Conflict Resolution
Select how to handle conflicts between client and server data. See “Default Settings” for more information.

Synchronization Modes
Select how the synchronization will perform of merging data, client is master or server is master. See “Default Settings” for more information.

3.1.6 Create and Delete Folders on Server

WebDAV Collaborator can create and delete folders from the server. The URL must be part of the URL principals to be able create and delete folders.

Figure 15 – Bynari WebDAV Collaborator – Create Server Folder

Once the folder is created or deleted, the list of folders from the server will be updated.

Figure 16 – Bynari WebDAV Collaborator – Server Folders

When deleting a folder, WebDAV Collaborator will prompt you if you want to delete the folder from the server.

Figure 17 – Bynari WebDAV Collaborator – Delete Server Folder

3.1.7 Successful Test

If you have a reliable network connection to the server, and you have correctly entered the settings required by your WebDAV server, you will receive a “URL successfully detected” message. If you do not receive this message, contact your WebDAV server administrator.Figure 19 – Bynari WebDAV Collaborator – URL successfully detected

3.1.10 Configuration Complete

Once the synchronization has completed, then you have successfully configured and synchronized your Calendar. Contacts, Journal, Notes and Tasks folders are configured using the same steps that we have just used to configure and synchronize the calendar folder.

3.2 Register the Bynari WebDAV Collaborator

Click on “About” in the Bynari WebDAV Collaborator Toolbar.Figure 23 – About

Licensing

The Outlook Connector utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Outlook Connector (OC) will either contact the patched version of Insight Server 4.3, which allows auto-registration with OC 4.0, or Server 4.4. If you are using a 3rd party server, it will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Outlook Connector license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Outlook Connector may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of client licenses has been exceeded. The Bynari Key Server tracks how many systems have been activated using a given license. If the number of activated clients exceeds the total for the license, the Outlook Connector will inform you that additional licenses need to be purchased.

If you need to reinstall the Outlook Connector software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Outlook Connector toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 4.0 build of the Outlook Connector available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

Outlook Connector 4.0 has been tested with Bynari Server, Univention Corporate Server, Insight Server, and Bynari Collaboration Server, Cyrus, and Kolab IMAPv4 servers. Outlook Connector supports all base specifications as described in RFC 3501: Internet Message Access Protocol version 4rev1. If your IMAPv4 server supports the specifications in RFC 3501, Outlook Connector 4.0 may be compatible with your server. If you encounter issues with a different type of unsupported server, email support at support@bynari.net to create a support ticket. The Bynari support team will provide a reasonable effort in working with you.

1 Outlook Connector version 4.0

The Outlook Connector acts as a MAPI transport for Microsoft Outlook. As a MAPI transport provider, the Connector interprets all the different types of folders used by Outlook.

When Outlook Connector is used in conjunction with the Bynari Server or Insight Server, a powerful collaboration environment is created. Users are able to share mail folders, contacts, tasks, and calendars with other individuals. Public folders of each type can also be created and maintained by system administrators through the web admin interface. All of these functions are supported through the familiar Outlook interface eliminating any need for costly end user training.

1.1 Architecture

Messaging Application Programming Interface or MAPI has two major components. Applications such as Microsoft Outlook use the client side interface to contact the MAPI subsystem for all communications with the message store. There is also a service interface which is used by programs such as Outlook Connector to provide the MAPI transport services for accessing the message store on the server.

Outlook Connector acts as the transport that provides messaging services directly to the MAPI subsystem and stores this information on Insight Server and Bynari Server via the IMAP protocol.

Figure 1 – MAPI Architecture

1.2 Features of Outlook Connector

Outlook Connector 4.0 offers the following features:

Native MAPI implementation

Mobile sync with Windows Mobile device

Mobile sync with Blackberry Mobile device

Mobile sync of contacts with iPhone

Support for new Microsoft PST architecture enables files larger than 2G

1.3 Supported Platforms

Outlook Connector 4.0 is compatible with the following software. If you are using a version that is not listed, or software that is not supported, upgrade to a supported version.

Supported Windows®Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003

Outlook® 2007

Outlook® 2010 (32/64 bit)

Supported Languages

English

French

German

Italian

Spanish (Spain)

Portuguese (Brazil)

Dutch

Norwegian

Russian

Swedish

Taiwanese/Chinese

Czech

Hebrew

Note: Other languages are provided and may be used but are not formally supported. Problems with translation, spelling, grammar and proper character encoding may be encountered.

1.4 Supported IMAP Servers

Bynari Collaboration Server

Insight Server

Cyrus

Kolab

1.5 Supported mobility devices and software

Outlook Connector 4.0 includes mobility support for several devices including Blackberry, iPhone and Windows Mobile. The following versions are compatible with Outlook Connector 4.0.

1.6 Known Limitations

Microsoft Business Contact Manager is not compatible with Outlook Connector.

Smart Phone synchronization is dependent on the hardware and the software provider.

Slashes in folder names are not allowed.

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The Connector 4.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the Connector and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

Click on “Help” > “About” and then click on “Additional Version and Copyright Information”

Figure 2.3 – Outlook 2010 about dialog

Step 3: Backup “Rules and Alerts”

Outlook “Rules and Alerts” functions are used to organize incoming email. These functions allow users to set custom “actions” that will be performed automatically on incoming messages.

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Export “Rules and Alerts”

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 4 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 5 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Export Rules…” button.

Close Outlook to continue installing or updating Outlook Connector 4.0.

Note: In order to ensure proper Rules and Alerts functionality in Microsoft Outlook a check must be placed in the “Schedule an automatic send/receive every” checkbox under Tools>Options>Mail Setup>Send/Receive. Any amount of time may be specified in the associated “minutes” field.

2.2 Installing Outlook Connector – New Installation

The following section explains how to install the Outlook Connector 4.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Outlook Connector will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Outlook Connector and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Outlook Connector. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

End User License Agreement:Read the license agreement. If you agree, select the button, “I accept the license agreement” and select “Next”.

Create New Outlook Profile:The Outlook Connector will automatically create a profile for Outlook. The default name for this profile is “Outlook Connector”. The “default name” is a user defined field and may be changed if needed. Place a check in the box labeled, “Prompt for which profile to use when starting Outlook (Recommended)”, if you have multiple profiles in Outlook. Selecting this will prompt for profile selection when Outlook starts. Click “Next” to continue installation.

Figure 11 – Installation – Outlook Connector Create New Profile

Account Information:This screen provides the Outlook Connector with the information needed to create the Outlook profile for your email account during the installation process.
The following basic information is needed to complete this screen:

Your Name

E-mail Address

IMAP Server Address

SMTP Server Address

Username

Password

Figure 12 – Outlook Connector – Account Information

Note: Bynari Collaboration Server requires the entire email address to be used as the “username”. Insight Server only used the first part of the email address, leaving off “@domain.com”.

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 14 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 16 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 17 – Outlook Connector – Finish Install Wizard

2.3 Installing Outlook Connector – Upgrade

Upgrading the Outlook Connector is similar to the steps discussed under “Installing Outlook Connector – New Installation” in section 2.1.

In the upgrade process, no profile will be created and all of the original user data from the previous installation of the Outlook Connector is used. The Outlook Connector will automatically upgrade profiles from earlier Outlook Connector versions. Outlook Connector 3.x used a “local cache” data storage system while the Outlook Connector 4 uses a Microsoft PST file to store data.

When upgrading from any of the Outlook Connector 3.x versions, your profile will be upgraded to the new PST architecture. The Outlook Connector will need to perform an initial synchronization after the upgrade process completes.

Important Information: During the initial synchronization process, the Connector will download the newest emails first, and then it will continue to synchronize in the background. This allows the end-user to begin using Outlook immediately while synchronization continues.

Note: The Connector installer will automatically determine if your profile needs to be upgraded.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

Accept the terms of the End User License Agreement to install the Outlook Connector. If you agree to the terms of the license, select “I accept the agreement” then select “Next” to proceed to the next step.

Profile UpgradeIf Outlook Connector finds any existing profiles, it will upgrade them to the latest version. Confirm that you would like to continue by selecting “Yes”.

A custom installation location may be used. Select the “Browse” button to choose an alternate location to install the Outlook Connector. Select “Next” to continue the installation. If the existing installation location is used, the following informational window will be displayed. Select “Yes” to proceed to the next step.Figure 22 – Outlook Connector – Upgrade Destination Location

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 23 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 24 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 25 – Outlook Connector – Upgrade Complete

2.4 Installation Logs

Error Logging

This feature is only activated during a new installation of the Outlook Connector when a new profile is created. Error logging is not enabled during the upgrade process.

Viewing the Log File

The Outlook Connector generates a log file named “Bynari.log” in the user’s %TEMP% directory during the installation process.

Viewing the Log File:

Select “Start” > “Run”.

Type %TEMP% on the Run input field and select “OK”.

A new explorer window will open displaying the contents of the user’s %TEMP% directory.

Browse this directory for a text file named “Bynari.log”. This file can be viewed with any text editor.

Technical Support Logging

The Outlook Connector also offers additional logging capabilities for troubleshooting. These logs are located under: %AppData%\Local\Bynari\Bynari Insight Connector 4.0\

There are both “log” and “trace” directories located here.

To turn on logging, go to the Connector toolbar and click on:

Account > More Settings… > Logging

When working with Bynari Technical Support, “verbose” logging will be required for troubleshooting.

3 Post Installation Configuration

3.1 Import “Rules and Alerts”

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 26 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 27 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Import Rules…” button.

Ensure that there is a check in the “Send immediately when connected” (labeled “Automatic Send/Receive” in Outlook 2003) checkbox. The checkbox is located on the “Mail Setup” tab, under “Options”, in the “Tools” menu. This is required in order to ensure proper rules functionality.

3.2 Outlook Connector Toolbar

All custom configuration settings can be made through the Outlook Connector Toolbar.

Selecting the “Folder” button opens the “Folder Permissions” dialog window. From the “Folder Permissions” dialog window, additional users can be added by selecting the “Add” button

Figure 34– Outlook Connector – Add New User

Set Specific Permissions
Enter the appropriate username or full email address.

Note: As is the case with Bynari Collaboration Server, some servers require the entire email address to be used when adding a new user to a folder share while others only require the username. Check with your systems administrator for specific information about your server requirements.

Select “OK” to confirm adding the new user’s ACL to the specified folder.Figure 35– Outlook Connector – Add New User

Search Corporate Directory
This feature is used to search an LDAP directory to find users. Enter a value to search and then click “search”.In the “Search Results” field, select a user or multiple users by holding the control key and clicking on the listings to add and then click “OK”.

ACL permissions can be adjusted at any time for every user added in the folder permission’s dialog. Users may only grant ACL permissions if they have been given the administrator permission. ACL permissions may not be changed for either the owner or the administrator of the account.

The main “Folder Permissions” dialog window is now displayed again. The username or email address that was just entered is now displayed in the user dialog box. The default permission given to all new users is “Guest”. This can be modified using the pull-down menu in the “Folder Permissions” dialog window.

Each of the listed permissions can be set independently giving more granular control over folder sharing permissions.

Permissions

Description

Lookup

The user may see that the folder exists.

Read

The user may read the folder. The user may also select the folder, fetch data, perform searches, and copy messages from the folder.

Set Seen Flag

Keep, per-user, seen state. The “Seen” and “Recent” flags are preserved for the user.

Write

The user may modify flags and keywords other than “Seen” and “Deleted” (which are controlled by other sets of rights).

Insert

The user may insert new messages into the folder.

Post

A user may send a message to the folder. This right differs from the “Insert” right in that the delivery system inserts trace information into submitted messages so that you can filter address by user name, IP address or HTTP requests.

Create Folders

The user may create, delete or rename folders.

Delete Messages

The user may set a message as “Deleted” or permanently delete mail.

Delete Folders

The user may delete folder.

Perform Expunge

User can permanently expunge deleted messages from the folder.

Administrator

The user may change all the permissions on the folders.

Table 1

Folder Type

The “Folder Type” button gives the user the ability to select a specific “type” for any IMAP folder except for Inbox, Outbox, Deleted Items and Sent.

Figure 39 – Outlook Connector – Folder Type

This feature becomes useful if a user wants to create a second calendar to share with others rather than their standard calendar.

3.2.2 Refresh Folders

The “Refresh Folders” button refreshes the folder tree as seen when you press Alt + F1 (navigation pane). When pressed, the Outlook Connector actually scans each folder, not for contents but for the folders themselves. If folder changes are made on the server or if folders are shared to you from someone else, you would use the “Refresh Folders” to display those changes in Outlook.

Figure 40 – Outlook Connector – Refresh Folders

Note: The “Refresh Folders” button does not retrieve emails; it refreshes the IMAP folder tree only.

3.2.3 Account

The Outlook Connector Settings dialog window will be displayed first when selecting “Account” from the Outlook Connector toolbar. All of the information displayed on this screen is entered and configured during the Outlook Connector installation process. Changes can be made to this information as needed.

3.2.4 More Settings

To learn more about the additional settings which are available for configuration, click on the “More Settings…” button.

Across the top of this new window, you will see eight tabs:
General, Connections, Download, Folders, Send/Receive, Other Settings, Format, and About.

3.2.4.1 General

Figure 43– Outlook Connector – More Settings – Connections – IMAP

The General tab has two input fields. The first one is already filled in with a default value – “Insight Server Folders”. This is the name that will appear as the display name for “Outlook Today”. This is a user-defined field and can be changed.

The second field is labeled “Other User Information”. It is optional and has no effect on the functionality of the software. This is also a user-defined field.

3.2.4.2 Connections

The Connections tab is where IMAP, SMTP, LDAP and Timeout settings are configured.

Server name
This is the IMAP server name that was entered during installation; it can be changed if needed.

Port
By default, Bynari Server uses port 143.

Username
This is the user name that was entered during installation; it can be changed if needed.

Password
This is the password that was entered during installation; it can be changed if needed.

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure that your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Persistent Connection
The default and recommended selection is enabled.Important Information: Disabling the use of persistent connections will negatively affect the performance of the Outlook Connector. Persistent connections, also known as “keep alive” connections, reuse the same TCP connection for sending and receiving. This streamlines requests, reduces network traffic, network latency, CPU utilization and memory needs as it requires fewer resources.

Server name
This is the SMTP server name that was entered during installation; it can be changed if needed.

Port
By default, the Bynari Server uses port 25

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Same Authentication as Incoming Server
This uses your email username and password that you entered when you setup the account.

Use SMTP Authentication
This option is used when sending email from an SMTP server that is not part of the normal mail server network. i.e. an external address or a remote user. Enabling this feature tells the client to authenticate with the server to relay messages to external domains.

Note: The LDAP default options are configured for optimal use with Address Book 3.0 and Insight Server 4.3.

The Lightweight Directory Access Protocol or LDAP is an application protocol for querying and modifying directory services running over TCP/IP.

An LDAP directory is a set of objects with attributes organized in a logical and hierarchical manner. An example of LDAP could be an address book that consists of names organized alphabetically. Each name in the address book would have a corresponding email address and telephone number.

User DN
The User DN (Distinguished Name) is comprised of a unique identifier for the user and the domain container; the unique identifier is the container “cn=” in the LDAP database followed by the domain or organizational information.

Note: If you are using Insight Server, users can find their own “User DN” information. Log into the web management console as a user, then click on:

Preferences > “Client Configuration”

“Directory Server Account”, locate the field, “Account Name”.

Bynari Collaboration Server users must contact their administrator to retrieve the User DN.

An example DN might be: “cn=testuser1,o=example.net”

If you are not running the Bynari Server or Insight Server, please consult your LDAP administrator for your DN.

Use Incoming Server (IMAP) Password
This uses the IMAP password from the Connections > IMAP field.

Password
This is your password to the LDAP server.

Remember Password
Remember the password so that you do not have to enter it every time it accesses the LDAP server.

Toggling this option will allow for custom LDAP searches to group level.

LDAP Filter for Users:

This option defines the LDAP attribute for users.

LDAP Filter for Groups:

This option defines the LDAP attribute for groups.

LDAP Search Attributes:

The criteria used in the search attribute can be changed to meet your LDAP structural needs. This information can be found with the user’s container name or unique identifier in the LDAP database. An LDAP browser can quickly display these parameters. In this example, the data refers to the following information:

cn = Container name. Typically this is the user’s full name.

mail = User’s mail address.

givenName = Typically, this is the first name of a user.

sn = Surname or last name.

Base DN

The top level of the LDAP directory tree is the base, referred to as the “base DN”.

By default Outlook Connector attempts to determine your LDAP base DN by your User DN, which you specified on the Connections > LDAP tab. Consult with your LDAP administrator for your DN if the Base DN was not determined automatically.

LDAP Server Version

Select LDAP version

Manually select version 2 or LDAP version 3.

Detect

This button will attempt to get the LDAP server version automatically.

The value of these attributes is used to perform the searches against the LDAP database. These are comma delimited and can be changed depending on your setup.

User Attributes
The user attribute will search against “login” then “uid”.

User ID
The user id attribute will search against the “login” attribute.

First Name
The first name attribute will search against “givenName”.

Last Name
The last name attribute will search against “sn”.

Display Name
The display name attribute will search against “display-name”, “displayName”, and then “cn”.

E-mail Address
The e-mail address attribute will search against “mail”.

Others

Figure 49 – Outlook Connector – More Settings – Connections – IMAP

Timeout Setting

Server timeout value in number of seconds.
The Timeout Setting tells the server how long to wait before it closes the session. The default value is “0”. Acceptable values are: “0”, “30-600” seconds. In a corporate environment where the user is on the same network as the mail server, a timeout value of “0” may be adequate.Users on a Wide Area Network (WAN) need to consider larger timeout settings. Setting this value is dependent on your Internet connection speeds. If you are on a dial-up connection, you may want to set this value to 600 seconds whereas if you are on a DSL connection or cable modem connection, 60 seconds may be acceptable.Having a value too low can cause uploading issues when sending large attachments where the Internet upload speeds are usually slow.

Auto Registration Port
Auto registration is disabled by default. This option allows Outlook Connector to verify licensing with their local Insight Server or Bynari Server. If you do not use the Bynari Server or Insight Server, DO NOT enable the Auto Registration Port Checkbox. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Important Information: The Outlook Connector was designed to function over LAN-based and high speed broadband connections. Many remote users are able to utilize the Outlook Connector as it was designed. For users on poor remote connections, utilizing the Bynari Web Client may be a better option.

Use SSL
Use secure socket layer protocol to register.

3.2.4.3 Download

Figure 50 – Outlook Connector – More Settings – Download

Download Options

Download Headers Only
Enabled by default, this option improves the performance of the initial synchronization of the emails downloaded for Outlook. It downloads the header only for email messages. When the message is selected for viewing, the entire message is downloaded.

Note: Tasks, journals, contacts and calendar events are always set for full-content download when selected for viewing.

Download Contents of Message Only
Disabled by default, this option downloads the entire message during the synchronization of emails. Attachments are downloaded when the message is selected for viewing.

Download Contents of Message and Attachments
Disabled by default, this option downloads the entire message and associated attachments during the synchronization of emails.

Download All Attachments
This option will download all attachments.

Download Attachment Limit
This option will set the download attachment limit size in bytes. Any value is accepted in this field. The default is 50,000 bytes.

Download Message progress

Show progress indicator when loading messages
When this box is checked, a progress indicator will appear when synchronizing any folder with more than 50 messages. This option is checked by default.

Indicator threshold (number of messages)
This option allows you to modify when the indicator will appear. By default, this value is set to 50 messages, adjusting this to zero will display the indicator for every message.

3.2.4.4 Folders

Figure 51 – Outlook Connector – More Settings – Folders

Folder Type

Use ACL to set folder types
Enabled by default, it allows the Outlook Connector to use custom IMAP folder ACLs to specify the specialized folder types used by Outlook. These are “Calendar”, “Contact”, “Task”, “Journal”, “Notes“, and “Mail”. This option increases performance since the Outlook Connector no longer has to locate a hidden synchronization message to determine a given folder’s type.

Folder List

Show All Folders
This is enabled by default and tells the Outlook Connector to automatically subscribe to all folders found under the user’s folder list.

Show Only Subscribed Folders
In large environments, the default value of “Show All Folders” may not be desirable. This option allows the users to individually select only the folders they want to see in Outlook.

Important Information: When manually selecting folders, make sure that default folders are checked. i.e. Calendar, Contacts, Deleted Items, Sent Items, Outbox and Tasks. If you uncheck them, it will cause Outlook to recreate them on the IMAP server. This is a default behavior of Outlook.

3.2.4.5 Send/Receive

Figure 52 – Outlook Connector – More Settings – Send/Receive

Outlook Connector utilizes IMAP IDLE to update the Inbox folder. For servers that do not support IMAP IDLE make sure that the Inbox folder is selected.

3.2.4.6 Other Settings

Figure 53 – Outlook Connector – More Settings – Miscellaneous

The Other Settings tab contains two sections; one for read receipt request options and the second for local cache options.

Message Receipt Options

How would you like to respond to requests for read receipts on incoming messages?

Prompt me before sending a response
This option is the default setting. This setting “prompts” the user to choose between sending a read receipt or not.

Always send a response [default selection]
This option automatically sends a response to the sender of a read receipt request.

Never send a response
This option never sends a response to a read request sender.

Custom Location
This option allows you to change the location of the local cache. This enables the administrator to place the local cache on the network through a network share for user data backup if needed.

Note: Read, Write, Delete and Change permissions within Microsoft Windows are required for any Custom Location.

Note: Any changes made to the location of the local cache will require a restart of Outlook. If you do not restart Outlook, you may see errors, because the Outlook Connector must create the LocalCache.pst file.

3.2.4.7 Format

Figure 54 – Outlook Connector – More Settings – Format

Message Format Options

Note: “Use Kolab Format” option is available in the Kolab version of Outlook Connector 4.0.

Use Microsoft Message Format
This is also known as “.tnef” formatting which stands for Transport Neutral Encapsulation Format. This allows files to contain rich text formatting used by e-mail messages, such as bold, italics, underlining, etc…

Use iCal Format
This option is turned on by default in the “ical” or “iCalender” format version of Outlook Connector. iCalendar is a file format which allows sending meeting requests and tasks to other internet users via email or sharing files with an .ics extension.“iCal” format is significantly smaller than the “.tnef” format which can improve performance and save disk space.

Note: If you use a Kolab server or an iCalendar compatible server, you may not need to select “Use Microsoft Message Format”. If you are unsure, it is best to select both options.

Use Kolab Format
Use this option only if you are running a Bynari Collaborator Server or Kolab IMAP server. Kolab uses a unique XML format attached to email specifically for Kolab groupware servers. The XML holds information for contacts, calendar events, journals, etc.

3.2.4.8 Logging

Figure 55 – Outlook Connector – More Settings – Logging

Logging capabilities have been added to the Outlook Connector as a troubleshooting aid. By default, all logging is off. Log files can consume large amounts of disk space, and it is recommended that logging be left off, unless the user is experiencing problems.

When working with Bynari Technical Support on an issue, they may request that you enable logging. Verbose logging is the most thorough level of logging offered and will offer the most insight to the support technician.

3.2.4.9 About

Figure 56 – Outlook Connector – More Settings – About

About tab

The about tab provides information about the Outlook Connector. It contains the version number as well as all licensing information.

3.2.5 Quota

3.2.6 About

Figure 59 – Outlook Connector – About

The “About” button on the Outlook Connector toolbar performs the same function as the “About” tab discussed above in section 2.5.4.9.

4 Using Outlook Connector

Outlook Connector 4.0 provides Outlook with a MAPI transport service that makes connecting to an IMAP server transparent to the end user. The following sections describe some of the additional dialogs introduced by the Connector such as Folder permissions as well as documenting configuration changes needed for features such as Free/Busy.

4.1 Viewing Shared Folders

Note: Private events (calendar, contacts, and tasks) are stored on the server. Only the folder owner will see private events.

Other users’ shared folders will appear under ‘Other Users’ in the folder list.

Figure 61 – “Other Users” shared folder list

Public folders created on the Bynari Server and Insight Server will display under ‘Shared Folders’ in Outlook.

Figure 62 – “Shared Folders” public folder list

Note: Upgrade your Insight Server to at least 4.2.2 to support private events.

4.2 Free/Busy Configuration

Outlook allows users to share free/busy information from their calendars with other users on their mail server. With the Microsoft Office Internet Free/Busy Service, users can publish their free/busy times to a shared Internet location. Members using this service can view each other’s free/busy information when viewing shared calendars or creating meeting requests.

Publish “2” month(s) of Calendar free/busy information the server
Enter the number of months of Free/Busy information to be published.The default interval is 2 months. This value represents the number of months from today’s date.

Update free/busy information on the sever every “15” minutes
The default time is every 15 minutes. This value represents how often Outlook will update the user’s Free/Busy information on the server.

Internet Free/Busy

Publish at my location
This option must be checked. In figure 66, a path name is shown. Insert your information in place of the variables, “%NAME%.vcf”.

4.3 Show / Hide Toolbar

It places a check mark next to the name to show that the Connector is enabled.

Figure 67 – Show/Hide Outlook Connector Toolbar

If you have hidden the Outlook Connector toolbar at the time of the installation, you can show the toolbar by following the above steps.

5 Registering and Unregistering Outlook Connector

Outlook Connector 4.0 is configured to use auto registration by default when “Insight Server” is selected during installation. Auto registration is designed for users of both the Outlook Connector and Insight Server or the Bynari Server. With auto registration enabled, the Outlook Connector will verify that an active license exists for the client when Outlook starts. It is recommended that users of the Insight Server or the Bynari Server utilize this feature of the Outlook Connector.

If you do not have an Insight Server or Bynari Server, or do not wish to use auto registration, you can register your copy of the Outlook Connector using the “About” tab of the Outlook Connector toolbar.

5.1 Auto Registration

Enable or disable auto registration

Click on the “Account” tab in Outlook Connector toolbar.

Figure 68 – Outlook Connector – Account

Select “Connections” > “Others”.

Figure 69 – Outlook Connector – More Settings – Connections – IMAP

Important Information: Do not enable auto registration if you do not use the Insight Server or Bynari Collaborator Server (BCS).

Auto Registration Port
Auto registration is either enabled or disabled depending on your Insight Server selection during installation. This option allows Outlook Connector to verify licensing with a local Bynari Server or Insight Server. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Use SSL
Use secure socket layer protocol to register.

Troubleshooting Tip: If you are experiencing trouble registering the connector and your server does not support auto-registration, make sure that the “Auto Registration Port” option is NOT checked. This option is being deprecated in future versions of the connector.

Trademarks

Microsoft Windows, Windows Mobile, Outlook, Windows XP, Windows Vista are all registered trademarks of Microsoft Corporation in the United States, other countries, or both.

BlackBerry is a registered trademark of Research In Motion Limited in the United States, other countries, or both.

All other trademarks are the property of their respective owners.

Technical Support

When you purchase any of Bynari’s products, all the products except the WebDAV Collaborator include one year of free support and maintenance. To purchase additional yearly support and maintenance, please contact sales@bynari.net.

Customers who are current on support receive one year of product maintenance, upgrades and email and/or telephone matching the purchased support package.

Licensing

The Outlook Connector utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Outlook Connector (OC) will either contact the patched version of Insight Server 4.3, which allows auto-registration with OC 4.0, or Server 4.4. If you are using a 3rd party server, it will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Outlook Connector license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Outlook Connector may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of client licenses has been exceeded. The Bynari Key Server tracks how many systems have been activated using a given license. If the number of activated clients exceeds the total for the license, the Outlook Connector will inform you that additional licenses need to be purchased.

If you need to reinstall the Outlook Connector software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Outlook Connector toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 4.0 build of the Outlook Connector available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

Outlook Connector 4.0 has been tested with Bynari Server, Univention Corporate Server, Insight Server, and Bynari Collaboration Server, Cyrus, and Kolab IMAPv4 servers. Outlook Connector supports all base specifications as described in RFC 3501: Internet Message Access Protocol version 4rev1. If your IMAPv4 server supports the specifications in RFC 3501, Outlook Connector 4.0 may be compatible with your server. If you encounter issues with a different type of unsupported server, email support at support@bynari.net to create a support ticket. The Bynari support team will provide a reasonable effort in working with you.

1 Outlook Connector version 4.0

The Outlook Connector acts as a MAPI transport for Microsoft Outlook. As a MAPI transport provider, the Connector interprets all the different types of folders used by Outlook.

When Outlook Connector is used in conjunction with the Bynari Server or Insight Server, a powerful collaboration environment is created. Users are able to share mail folders, contacts, tasks, and calendars with other individuals. Public folders of each type can also be created and maintained by system administrators through the web admin interface. All of these functions are supported through the familiar Outlook interface eliminating any need for costly end user training.

1.1 Architecture

Messaging Application Programming Interface or MAPI has two major components. Applications such as Microsoft Outlook use the client side interface to contact the MAPI subsystem for all communications with the message store. There is also a service interface which is used by programs such as Outlook Connector to provide the MAPI transport services for accessing the message store on the server.

Outlook Connector acts as the transport that provides messaging services directly to the MAPI subsystem and stores this information on Insight Server and Bynari Server via the IMAP protocol.

Figure 1 – MAPI Architecture

1.2 Features of Outlook Connector

Outlook Connector 4.0 offers the following features:

Native MAPI implementation

Mobile sync with Windows Mobile device

Mobile sync with Blackberry Mobile device

Mobile sync of contacts with iPhone

Support for new Microsoft PST architecture enables files larger than 2G

1.3 Supported Platforms

Outlook Connector 4.0 is compatible with the following software. If you are using a version that is not listed, or software that is not supported, upgrade to a supported version.

Supported Windows®Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003

Outlook® 2007

Outlook® 2010 (32/64 bit)

Supported Languages

English

French

German

Italian

Spanish (Spain)

Portuguese (Brazil)

Dutch

Norwegian

Russian

Swedish

Taiwanese/Chinese

Czech

Hebrew

Note: Other languages are provided and may be used but are not formally supported. Problems with translation, spelling, grammar and proper character encoding may be encountered.

1.4 Supported IMAP Servers

Bynari Collaboration Server

Insight Server

Cyrus

Kolab

1.5 Supported mobility devices and software

Outlook Connector 4.0 includes mobility support for several devices including Blackberry, iPhone and Windows Mobile. The following versions are compatible with Outlook Connector 4.0.

1.6 Known Limitations

Microsoft Business Contact Manager is not compatible with Outlook Connector.

Smart Phone synchronization is dependent on the hardware and the software provider.

Slashes in folder names are not allowed.

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The Connector 4.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the Connector and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

Click on “Help” > “About” and then click on “Additional Version and Copyright Information”

Figure 2.3 – Outlook 2010 about dialog

Step 3: Backup “Rules and Alerts”

Outlook “Rules and Alerts” functions are used to organize incoming email. These functions allow users to set custom “actions” that will be performed automatically on incoming messages.

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Export “Rules and Alerts”

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 4 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 5 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Export Rules…” button.

Close Outlook to continue installing or updating Outlook Connector 4.0.

Note: In order to ensure proper Rules and Alerts functionality in Microsoft Outlook a check must be placed in the “Schedule an automatic send/receive every” checkbox under Tools>Options>Mail Setup>Send/Receive. Any amount of time may be specified in the associated “minutes” field.

2.2 Installing Outlook Connector – New Installation

The following section explains how to install the Outlook Connector 4.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Outlook Connector will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Outlook Connector and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Outlook Connector. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

End User License Agreement:Read the license agreement. If you agree, select the button, “I accept the license agreement” and select “Next”.

Create New Outlook Profile:The Outlook Connector will automatically create a profile for Outlook. The default name for this profile is “Outlook Connector”. The “default name” is a user defined field and may be changed if needed. Place a check in the box labeled, “Prompt for which profile to use when starting Outlook (Recommended)”, if you have multiple profiles in Outlook. Selecting this will prompt for profile selection when Outlook starts. Click “Next” to continue installation.

Figure 11 – Installation – Outlook Connector Create New Profile

Account Information:This screen provides the Outlook Connector with the information needed to create the Outlook profile for your email account during the installation process.
The following basic information is needed to complete this screen:

Your Name

E-mail Address

IMAP Server Address

SMTP Server Address

Username

Password

Figure 12 – Outlook Connector – Account Information

Note: Bynari Collaboration Server requires the entire email address to be used as the “username”. Insight Server only used the first part of the email address, leaving off “@domain.com”.

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 14 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 16 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 17 – Outlook Connector – Finish Install Wizard

2.3 Installing Outlook Connector – Upgrade

Upgrading the Outlook Connector is similar to the steps discussed under “Installing Outlook Connector – New Installation” in section 2.1.

In the upgrade process, no profile will be created and all of the original user data from the previous installation of the Outlook Connector is used. The Outlook Connector will automatically upgrade profiles from earlier Outlook Connector versions. Outlook Connector 3.x used a “local cache” data storage system while the Outlook Connector 4 uses a Microsoft PST file to store data.

When upgrading from any of the Outlook Connector 3.x versions, your profile will be upgraded to the new PST architecture. The Outlook Connector will need to perform an initial synchronization after the upgrade process completes.

Important Information: During the initial synchronization process, the Connector will download the newest emails first, and then it will continue to synchronize in the background. This allows the end-user to begin using Outlook immediately while synchronization continues.

Note: The Connector installer will automatically determine if your profile needs to be upgraded.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

Accept the terms of the End User License Agreement to install the Outlook Connector. If you agree to the terms of the license, select “I accept the agreement” then select “Next” to proceed to the next step.

Profile UpgradeIf Outlook Connector finds any existing profiles, it will upgrade them to the latest version. Confirm that you would like to continue by selecting “Yes”.

A custom installation location may be used. Select the “Browse” button to choose an alternate location to install the Outlook Connector. Select “Next” to continue the installation. If the existing installation location is used, the following informational window will be displayed. Select “Yes” to proceed to the next step.Figure 22 – Outlook Connector – Upgrade Destination Location

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 23 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 24 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 25 – Outlook Connector – Upgrade Complete

2.4 Installation Logs

Error Logging

This feature is only activated during a new installation of the Outlook Connector when a new profile is created. Error logging is not enabled during the upgrade process.

Viewing the Log File

The Outlook Connector generates a log file named “Bynari.log” in the user’s %TEMP% directory during the installation process.

Viewing the Log File:

Select “Start” > “Run”.

Type %TEMP% on the Run input field and select “OK”.

A new explorer window will open displaying the contents of the user’s %TEMP% directory.

Browse this directory for a text file named “Bynari.log”. This file can be viewed with any text editor.

Technical Support Logging

The Outlook Connector also offers additional logging capabilities for troubleshooting. These logs are located under: %AppData%\Local\Bynari\Bynari Insight Connector 4.0\

There are both “log” and “trace” directories located here.

To turn on logging, go to the Connector toolbar and click on:

Account > More Settings… > Logging

When working with Bynari Technical Support, “verbose” logging will be required for troubleshooting.

3 Post Installation Configuration

3.1 Import “Rules and Alerts”

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 26 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 27 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Import Rules…” button.

Ensure that there is a check in the “Send immediately when connected” (labeled “Automatic Send/Receive” in Outlook 2003) checkbox. The checkbox is located on the “Mail Setup” tab, under “Options”, in the “Tools” menu. This is required in order to ensure proper rules functionality.

3.2 Outlook Connector Toolbar

All custom configuration settings can be made through the Outlook Connector Toolbar.

Selecting the “Folder” button opens the “Folder Permissions” dialog window. From the “Folder Permissions” dialog window, additional users can be added by selecting the “Add” button

Figure 34– Outlook Connector – Add New User

Set Specific Permissions
Enter the appropriate username or full email address.

Note: As is the case with Bynari Collaboration Server, some servers require the entire email address to be used when adding a new user to a folder share while others only require the username. Check with your systems administrator for specific information about your server requirements.

Select “OK” to confirm adding the new user’s ACL to the specified folder.Figure 35– Outlook Connector – Add New User

Search Corporate Directory
This feature is used to search an LDAP directory to find users. Enter a value to search and then click “search”.In the “Search Results” field, select a user or multiple users by holding the control key and clicking on the listings to add and then click “OK”.

ACL permissions can be adjusted at any time for every user added in the folder permission’s dialog. Users may only grant ACL permissions if they have been given the administrator permission. ACL permissions may not be changed for either the owner or the administrator of the account.

The main “Folder Permissions” dialog window is now displayed again. The username or email address that was just entered is now displayed in the user dialog box. The default permission given to all new users is “Guest”. This can be modified using the pull-down menu in the “Folder Permissions” dialog window.

Each of the listed permissions can be set independently giving more granular control over folder sharing permissions.

Permissions

Description

Lookup

The user may see that the folder exists.

Read

The user may read the folder. The user may also select the folder, fetch data, perform searches, and copy messages from the folder.

Set Seen Flag

Keep, per-user, seen state. The “Seen” and “Recent” flags are preserved for the user.

Write

The user may modify flags and keywords other than “Seen” and “Deleted” (which are controlled by other sets of rights).

Insert

The user may insert new messages into the folder.

Post

A user may send a message to the folder. This right differs from the “Insert” right in that the delivery system inserts trace information into submitted messages so that you can filter address by user name, IP address or HTTP requests.

Create Folders

The user may create, delete or rename folders.

Delete Messages

The user may set a message as “Deleted” or permanently delete mail.

Delete Folders

The user may delete folder.

Perform Expunge

User can permanently expunge deleted messages from the folder.

Administrator

The user may change all the permissions on the folders.

Table 1

Folder Type

The “Folder Type” button gives the user the ability to select a specific “type” for any IMAP folder except for Inbox, Outbox, Deleted Items and Sent.

Figure 39 – Outlook Connector – Folder Type

This feature becomes useful if a user wants to create a second calendar to share with others rather than their standard calendar.

3.2.2 Refresh Folders

The “Refresh Folders” button refreshes the folder tree as seen when you press Alt + F1 (navigation pane). When pressed, the Outlook Connector actually scans each folder, not for contents but for the folders themselves. If folder changes are made on the server or if folders are shared to you from someone else, you would use the “Refresh Folders” to display those changes in Outlook.

Figure 40 – Outlook Connector – Refresh Folders

Note: The “Refresh Folders” button does not retrieve emails; it refreshes the IMAP folder tree only.

3.2.3 Account

The Outlook Connector Settings dialog window will be displayed first when selecting “Account” from the Outlook Connector toolbar. All of the information displayed on this screen is entered and configured during the Outlook Connector installation process. Changes can be made to this information as needed.

3.2.4 More Settings

To learn more about the additional settings which are available for configuration, click on the “More Settings…” button.

Across the top of this new window, you will see eight tabs:
General, Connections, Download, Folders, Send/Receive, Other Settings, Format, and About.

3.2.4.1 General

Figure 43– Outlook Connector – More Settings – Connections – IMAP

The General tab has two input fields. The first one is already filled in with a default value – “Insight Server Folders”. This is the name that will appear as the display name for “Outlook Today”. This is a user-defined field and can be changed.

The second field is labeled “Other User Information”. It is optional and has no effect on the functionality of the software. This is also a user-defined field.

3.2.4.2 Connections

The Connections tab is where IMAP, SMTP, LDAP and Timeout settings are configured.

Server name
This is the IMAP server name that was entered during installation; it can be changed if needed.

Port
By default, Bynari Server uses port 143.

Username
This is the user name that was entered during installation; it can be changed if needed.

Password
This is the password that was entered during installation; it can be changed if needed.

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure that your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Persistent Connection
The default and recommended selection is enabled.Important Information: Disabling the use of persistent connections will negatively affect the performance of the Outlook Connector. Persistent connections, also known as “keep alive” connections, reuse the same TCP connection for sending and receiving. This streamlines requests, reduces network traffic, network latency, CPU utilization and memory needs as it requires fewer resources.

Server name
This is the SMTP server name that was entered during installation; it can be changed if needed.

Port
By default, the Bynari Server uses port 25

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Same Authentication as Incoming Server
This uses your email username and password that you entered when you setup the account.

Use SMTP Authentication
This option is used when sending email from an SMTP server that is not part of the normal mail server network. i.e. an external address or a remote user. Enabling this feature tells the client to authenticate with the server to relay messages to external domains.

Note: The LDAP default options are configured for optimal use with Address Book 3.0 and Insight Server 4.3.

The Lightweight Directory Access Protocol or LDAP is an application protocol for querying and modifying directory services running over TCP/IP.

An LDAP directory is a set of objects with attributes organized in a logical and hierarchical manner. An example of LDAP could be an address book that consists of names organized alphabetically. Each name in the address book would have a corresponding email address and telephone number.

User DN
The User DN (Distinguished Name) is comprised of a unique identifier for the user and the domain container; the unique identifier is the container “cn=” in the LDAP database followed by the domain or organizational information.

Note: If you are using Insight Server, users can find their own “User DN” information. Log into the web management console as a user, then click on:

Preferences > “Client Configuration”

“Directory Server Account”, locate the field, “Account Name”.

Bynari Collaboration Server users must contact their administrator to retrieve the User DN.

An example DN might be: “cn=testuser1,o=example.net”

If you are not running the Bynari Server or Insight Server, please consult your LDAP administrator for your DN.

Use Incoming Server (IMAP) Password
This uses the IMAP password from the Connections > IMAP field.

Password
This is your password to the LDAP server.

Remember Password
Remember the password so that you do not have to enter it every time it accesses the LDAP server.

Toggling this option will allow for custom LDAP searches to group level.

LDAP Filter for Users:

This option defines the LDAP attribute for users.

LDAP Filter for Groups:

This option defines the LDAP attribute for groups.

LDAP Search Attributes:

The criteria used in the search attribute can be changed to meet your LDAP structural needs. This information can be found with the user’s container name or unique identifier in the LDAP database. An LDAP browser can quickly display these parameters. In this example, the data refers to the following information:

cn = Container name. Typically this is the user’s full name.

mail = User’s mail address.

givenName = Typically, this is the first name of a user.

sn = Surname or last name.

Base DN

The top level of the LDAP directory tree is the base, referred to as the “base DN”.

By default Outlook Connector attempts to determine your LDAP base DN by your User DN, which you specified on the Connections > LDAP tab. Consult with your LDAP administrator for your DN if the Base DN was not determined automatically.

LDAP Server Version

Select LDAP version

Manually select version 2 or LDAP version 3.

Detect

This button will attempt to get the LDAP server version automatically.

The value of these attributes is used to perform the searches against the LDAP database. These are comma delimited and can be changed depending on your setup.

User Attributes
The user attribute will search against “login” then “uid”.

User ID
The user id attribute will search against the “login” attribute.

First Name
The first name attribute will search against “givenName”.

Last Name
The last name attribute will search against “sn”.

Display Name
The display name attribute will search against “display-name”, “displayName”, and then “cn”.

E-mail Address
The e-mail address attribute will search against “mail”.

Others

Figure 49 – Outlook Connector – More Settings – Connections – IMAP

Timeout Setting

Server timeout value in number of seconds.
The Timeout Setting tells the server how long to wait before it closes the session. The default value is “0”. Acceptable values are: “0”, “30-600” seconds. In a corporate environment where the user is on the same network as the mail server, a timeout value of “0” may be adequate.Users on a Wide Area Network (WAN) need to consider larger timeout settings. Setting this value is dependent on your Internet connection speeds. If you are on a dial-up connection, you may want to set this value to 600 seconds whereas if you are on a DSL connection or cable modem connection, 60 seconds may be acceptable.Having a value too low can cause uploading issues when sending large attachments where the Internet upload speeds are usually slow.

Auto Registration Port
Auto registration is disabled by default. This option allows Outlook Connector to verify licensing with their local Insight Server or Bynari Server. If you do not use the Bynari Server or Insight Server, DO NOT enable the Auto Registration Port Checkbox. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Important Information: The Outlook Connector was designed to function over LAN-based and high speed broadband connections. Many remote users are able to utilize the Outlook Connector as it was designed. For users on poor remote connections, utilizing the Bynari Web Client may be a better option.

Use SSL
Use secure socket layer protocol to register.

3.2.4.3 Download

Figure 50 – Outlook Connector – More Settings – Download

Download Options

Download Headers Only
Enabled by default, this option improves the performance of the initial synchronization of the emails downloaded for Outlook. It downloads the header only for email messages. When the message is selected for viewing, the entire message is downloaded.

Note: Tasks, journals, contacts and calendar events are always set for full-content download when selected for viewing.

Download Contents of Message Only
Disabled by default, this option downloads the entire message during the synchronization of emails. Attachments are downloaded when the message is selected for viewing.

Download Contents of Message and Attachments
Disabled by default, this option downloads the entire message and associated attachments during the synchronization of emails.

Download All Attachments
This option will download all attachments.

Download Attachment Limit
This option will set the download attachment limit size in bytes. Any value is accepted in this field. The default is 50,000 bytes.

Download Message progress

Show progress indicator when loading messages
When this box is checked, a progress indicator will appear when synchronizing any folder with more than 50 messages. This option is checked by default.

Indicator threshold (number of messages)
This option allows you to modify when the indicator will appear. By default, this value is set to 50 messages, adjusting this to zero will display the indicator for every message.

3.2.4.4 Folders

Figure 51 – Outlook Connector – More Settings – Folders

Folder Type

Use ACL to set folder types
Enabled by default, it allows the Outlook Connector to use custom IMAP folder ACLs to specify the specialized folder types used by Outlook. These are “Calendar”, “Contact”, “Task”, “Journal”, “Notes“, and “Mail”. This option increases performance since the Outlook Connector no longer has to locate a hidden synchronization message to determine a given folder’s type.

Folder List

Show All Folders
This is enabled by default and tells the Outlook Connector to automatically subscribe to all folders found under the user’s folder list.

Show Only Subscribed Folders
In large environments, the default value of “Show All Folders” may not be desirable. This option allows the users to individually select only the folders they want to see in Outlook.

Important Information: When manually selecting folders, make sure that default folders are checked. i.e. Calendar, Contacts, Deleted Items, Sent Items, Outbox and Tasks. If you uncheck them, it will cause Outlook to recreate them on the IMAP server. This is a default behavior of Outlook.

3.2.4.5 Send/Receive

Figure 52 – Outlook Connector – More Settings – Send/Receive

Outlook Connector utilizes IMAP IDLE to update the Inbox folder. For servers that do not support IMAP IDLE make sure that the Inbox folder is selected.

3.2.4.6 Other Settings

Figure 53 – Outlook Connector – More Settings – Miscellaneous

The Other Settings tab contains two sections; one for read receipt request options and the second for local cache options.

Message Receipt Options

How would you like to respond to requests for read receipts on incoming messages?

Prompt me before sending a response
This option is the default setting. This setting “prompts” the user to choose between sending a read receipt or not.

Always send a response [default selection]
This option automatically sends a response to the sender of a read receipt request.

Never send a response
This option never sends a response to a read request sender.

Custom Location
This option allows you to change the location of the local cache. This enables the administrator to place the local cache on the network through a network share for user data backup if needed.

Note: Read, Write, Delete and Change permissions within Microsoft Windows are required for any Custom Location.

Note: Any changes made to the location of the local cache will require a restart of Outlook. If you do not restart Outlook, you may see errors, because the Outlook Connector must create the LocalCache.pst file.

3.2.4.7 Format

Figure 54 – Outlook Connector – More Settings – Format

Message Format Options

Note: “Use Kolab Format” option is available in the Kolab version of Outlook Connector 4.0.

Use Microsoft Message Format
This is also known as “.tnef” formatting which stands for Transport Neutral Encapsulation Format. This allows files to contain rich text formatting used by e-mail messages, such as bold, italics, underlining, etc…

Use iCal Format
This option is turned on by default in the “ical” or “iCalender” format version of Outlook Connector. iCalendar is a file format which allows sending meeting requests and tasks to other internet users via email or sharing files with an .ics extension.“iCal” format is significantly smaller than the “.tnef” format which can improve performance and save disk space.

Note: If you use a Kolab server or an iCalendar compatible server, you may not need to select “Use Microsoft Message Format”. If you are unsure, it is best to select both options.

Use Kolab Format
Use this option only if you are running a Bynari Collaborator Server or Kolab IMAP server. Kolab uses a unique XML format attached to email specifically for Kolab groupware servers. The XML holds information for contacts, calendar events, journals, etc.

3.2.4.8 Logging

Figure 55 – Outlook Connector – More Settings – Logging

Logging capabilities have been added to the Outlook Connector as a troubleshooting aid. By default, all logging is off. Log files can consume large amounts of disk space, and it is recommended that logging be left off, unless the user is experiencing problems.

When working with Bynari Technical Support on an issue, they may request that you enable logging. Verbose logging is the most thorough level of logging offered and will offer the most insight to the support technician.

3.2.4.9 About

Figure 56 – Outlook Connector – More Settings – About

About tab

The about tab provides information about the Outlook Connector. It contains the version number as well as all licensing information.

3.2.5 Quota

3.2.6 About

Figure 59 – Outlook Connector – About

The “About” button on the Outlook Connector toolbar performs the same function as the “About” tab discussed above in section 2.5.4.9.

4 Using Outlook Connector

Outlook Connector 4.0 provides Outlook with a MAPI transport service that makes connecting to an IMAP server transparent to the end user. The following sections describe some of the additional dialogs introduced by the Connector such as Folder permissions as well as documenting configuration changes needed for features such as Free/Busy.

4.1 Viewing Shared Folders

Note: Private events (calendar, contacts, and tasks) are stored on the server. Only the folder owner will see private events.

Other users’ shared folders will appear under ‘Other Users’ in the folder list.

Figure 61 – “Other Users” shared folder list

Public folders created on the Bynari Server and Insight Server will display under ‘Shared Folders’ in Outlook.

Figure 62 – “Shared Folders” public folder list

Note: Upgrade your Insight Server to at least 4.2.2 to support private events.

4.2 Free/Busy Configuration

Outlook allows users to share free/busy information from their calendars with other users on their mail server. With the Microsoft Office Internet Free/Busy Service, users can publish their free/busy times to a shared Internet location. Members using this service can view each other’s free/busy information when viewing shared calendars or creating meeting requests.

Publish “2” month(s) of Calendar free/busy information the server
Enter the number of months of Free/Busy information to be published.The default interval is 2 months. This value represents the number of months from today’s date.

Update free/busy information on the sever every “15” minutes
The default time is every 15 minutes. This value represents how often Outlook will update the user’s Free/Busy information on the server.

Internet Free/Busy

Publish at my location
This option must be checked. In figure 66, a path name is shown. Insert your information in place of the variables, “%NAME%.vcf”.

4.3 Show / Hide Toolbar

It places a check mark next to the name to show that the Connector is enabled.

Figure 67 – Show/Hide Outlook Connector Toolbar

If you have hidden the Outlook Connector toolbar at the time of the installation, you can show the toolbar by following the above steps.

5 Registering and Unregistering Outlook Connector

Outlook Connector 4.0 is configured to use auto registration by default when “Insight Server” is selected during installation. Auto registration is designed for users of both the Outlook Connector and Insight Server or the Bynari Server. With auto registration enabled, the Outlook Connector will verify that an active license exists for the client when Outlook starts. It is recommended that users of the Insight Server or the Bynari Server utilize this feature of the Outlook Connector.

If you do not have an Insight Server or Bynari Server, or do not wish to use auto registration, you can register your copy of the Outlook Connector using the “About” tab of the Outlook Connector toolbar.

5.1 Auto Registration

Enable or disable auto registration

Click on the “Account” tab in Outlook Connector toolbar.

Figure 68 – Outlook Connector – Account

Select “Connections” > “Others”.

Figure 69 – Outlook Connector – More Settings – Connections – IMAP

Important Information: Do not enable auto registration if you do not use the Insight Server or Bynari Collaborator Server (BCS).

Auto Registration Port
Auto registration is either enabled or disabled depending on your Insight Server selection during installation. This option allows Outlook Connector to verify licensing with a local Bynari Server or Insight Server. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Use SSL
Use secure socket layer protocol to register.

Troubleshooting Tip: If you are experiencing trouble registering the connector and your server does not support auto-registration, make sure that the “Auto Registration Port” option is NOT checked. This option is being deprecated in future versions of the connector.

Licensing

The Outlook Connector utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Outlook Connector (OC) will either contact the patched version of Insight Server 4.3, which allows auto-registration with OC 4.0, or Server 4.4. If you are using a 3rd party server, it will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Outlook Connector license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Outlook Connector may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of client licenses has been exceeded. The Bynari Key Server tracks how many systems have been activated using a given license. If the number of activated clients exceeds the total for the license, the Outlook Connector will inform you that additional licenses need to be purchased.

If you need to reinstall the Outlook Connector software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Outlook Connector toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 4.0 build of the Outlook Connector available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

Outlook Connector 4.0 has been tested with Bynari Server, Univention Corporate Server, Insight Server, and Bynari Collaboration Server, Cyrus, and Kolab IMAPv4 servers. Outlook Connector supports all base specifications as described in RFC 3501: Internet Message Access Protocol version 4rev1. If your IMAPv4 server supports the specifications in RFC 3501, Outlook Connector 4.0 may be compatible with your server. If you encounter issues with a different type of unsupported server, email support at support@bynari.net to create a support ticket. The Bynari support team will provide a reasonable effort in working with you.

1 Outlook Connector version 4.0

The Outlook Connector acts as a MAPI transport for Microsoft Outlook. As a MAPI transport provider, the Connector interprets all the different types of folders used by Outlook.

When Outlook Connector is used in conjunction with the Bynari Server or Insight Server, a powerful collaboration environment is created. Users are able to share mail folders, contacts, tasks, and calendars with other individuals. Public folders of each type can also be created and maintained by system administrators through the web admin interface. All of these functions are supported through the familiar Outlook interface eliminating any need for costly end user training.

1.1 Architecture

Messaging Application Programming Interface or MAPI has two major components. Applications such as Microsoft Outlook use the client side interface to contact the MAPI subsystem for all communications with the message store. There is also a service interface which is used by programs such as Outlook Connector to provide the MAPI transport services for accessing the message store on the server.

Outlook Connector acts as the transport that provides messaging services directly to the MAPI subsystem and stores this information on Insight Server and Bynari Server via the IMAP protocol.

Figure 1 – MAPI Architecture

1.2 Features of Outlook Connector

Outlook Connector 4.0 offers the following features:

Native MAPI implementation

Mobile sync with Windows Mobile device

Mobile sync with Blackberry Mobile device

Mobile sync of contacts with iPhone

Support for new Microsoft PST architecture enables files larger than 2G

1.3 Supported Platforms

Outlook Connector 4.0 is compatible with the following software. If you are using a version that is not listed, or software that is not supported, upgrade to a supported version.

Supported Windows®Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003

Outlook® 2007

Outlook® 2010 (32/64 bit)

Supported Languages

English

French

German

Italian

Spanish (Spain)

Portuguese (Brazil)

Dutch

Norwegian

Russian

Swedish

Taiwanese/Chinese

Czech

Hebrew

Note: Other languages are provided and may be used but are not formally supported. Problems with translation, spelling, grammar and proper character encoding may be encountered.

1.4 Supported IMAP Servers

Bynari Collaboration Server

Insight Server

Cyrus

Kolab

1.5 Supported mobility devices and software

Outlook Connector 4.0 includes mobility support for several devices including Blackberry, iPhone and Windows Mobile. The following versions are compatible with Outlook Connector 4.0.

1.6 Known Limitations

Microsoft Business Contact Manager is not compatible with Outlook Connector.

Smart Phone synchronization is dependent on the hardware and the software provider.

Slashes in folder names are not allowed.

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The Connector 4.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the Connector and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

Click on “Help” > “About” and then click on “Additional Version and Copyright Information”

Figure 2.3 – Outlook 2010 about dialog

Step 3: Backup “Rules and Alerts”

Outlook “Rules and Alerts” functions are used to organize incoming email. These functions allow users to set custom “actions” that will be performed automatically on incoming messages.

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Export “Rules and Alerts”

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 4 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 5 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Export Rules…” button.

Close Outlook to continue installing or updating Outlook Connector 4.0.

Note: In order to ensure proper Rules and Alerts functionality in Microsoft Outlook a check must be placed in the “Schedule an automatic send/receive every” checkbox under Tools>Options>Mail Setup>Send/Receive. Any amount of time may be specified in the associated “minutes” field.

2.2 Installing Outlook Connector – New Installation

The following section explains how to install the Outlook Connector 4.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Outlook Connector will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Outlook Connector and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Outlook Connector. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

End User License Agreement:Read the license agreement. If you agree, select the button, “I accept the license agreement” and select “Next”.

Create New Outlook Profile:The Outlook Connector will automatically create a profile for Outlook. The default name for this profile is “Outlook Connector”. The “default name” is a user defined field and may be changed if needed. Place a check in the box labeled, “Prompt for which profile to use when starting Outlook (Recommended)”, if you have multiple profiles in Outlook. Selecting this will prompt for profile selection when Outlook starts. Click “Next” to continue installation.

Figure 11 – Installation – Outlook Connector Create New Profile

Account Information:This screen provides the Outlook Connector with the information needed to create the Outlook profile for your email account during the installation process.
The following basic information is needed to complete this screen:

Your Name

E-mail Address

IMAP Server Address

SMTP Server Address

Username

Password

Figure 12 – Outlook Connector – Account Information

Note: Bynari Collaboration Server requires the entire email address to be used as the “username”. Insight Server only used the first part of the email address, leaving off “@domain.com”.

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 14 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 16 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 17 – Outlook Connector – Finish Install Wizard

2.3 Installing Outlook Connector – Upgrade

Upgrading the Outlook Connector is similar to the steps discussed under “Installing Outlook Connector – New Installation” in section 2.1.

In the upgrade process, no profile will be created and all of the original user data from the previous installation of the Outlook Connector is used. The Outlook Connector will automatically upgrade profiles from earlier Outlook Connector versions. Outlook Connector 3.x used a “local cache” data storage system while the Outlook Connector 4 uses a Microsoft PST file to store data.

When upgrading from any of the Outlook Connector 3.x versions, your profile will be upgraded to the new PST architecture. The Outlook Connector will need to perform an initial synchronization after the upgrade process completes.

Important Information: During the initial synchronization process, the Connector will download the newest emails first, and then it will continue to synchronize in the background. This allows the end-user to begin using Outlook immediately while synchronization continues.

Note: The Connector installer will automatically determine if your profile needs to be upgraded.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

Accept the terms of the End User License Agreement to install the Outlook Connector. If you agree to the terms of the license, select “I accept the agreement” then select “Next” to proceed to the next step.

Profile UpgradeIf Outlook Connector finds any existing profiles, it will upgrade them to the latest version. Confirm that you would like to continue by selecting “Yes”.

A custom installation location may be used. Select the “Browse” button to choose an alternate location to install the Outlook Connector. Select “Next” to continue the installation. If the existing installation location is used, the following informational window will be displayed. Select “Yes” to proceed to the next step.Figure 22 – Outlook Connector – Upgrade Destination Location

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 23 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 24 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 25 – Outlook Connector – Upgrade Complete

2.4 Installation Logs

Error Logging

This feature is only activated during a new installation of the Outlook Connector when a new profile is created. Error logging is not enabled during the upgrade process.

Viewing the Log File

The Outlook Connector generates a log file named “Bynari.log” in the user’s %TEMP% directory during the installation process.

Viewing the Log File:

Select “Start” > “Run”.

Type %TEMP% on the Run input field and select “OK”.

A new explorer window will open displaying the contents of the user’s %TEMP% directory.

Browse this directory for a text file named “Bynari.log”. This file can be viewed with any text editor.

Technical Support Logging

The Outlook Connector also offers additional logging capabilities for troubleshooting. These logs are located under: %AppData%\Local\Bynari\Bynari Insight Connector 4.0\

There are both “log” and “trace” directories located here.

To turn on logging, go to the Connector toolbar and click on:

Account > More Settings… > Logging

When working with Bynari Technical Support, “verbose” logging will be required for troubleshooting.

3 Post Installation Configuration

3.1 Import “Rules and Alerts”

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 26 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 27 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Import Rules…” button.

Ensure that there is a check in the “Send immediately when connected” (labeled “Automatic Send/Receive” in Outlook 2003) checkbox. The checkbox is located on the “Mail Setup” tab, under “Options”, in the “Tools” menu. This is required in order to ensure proper rules functionality.

3.2 Outlook Connector Toolbar

All custom configuration settings can be made through the Outlook Connector Toolbar.

Selecting the “Folder” button opens the “Folder Permissions” dialog window. From the “Folder Permissions” dialog window, additional users can be added by selecting the “Add” button

Figure 34– Outlook Connector – Add New User

Set Specific Permissions
Enter the appropriate username or full email address.

Note: As is the case with Bynari Collaboration Server, some servers require the entire email address to be used when adding a new user to a folder share while others only require the username. Check with your systems administrator for specific information about your server requirements.

Select “OK” to confirm adding the new user’s ACL to the specified folder.Figure 35– Outlook Connector – Add New User

Search Corporate Directory
This feature is used to search an LDAP directory to find users. Enter a value to search and then click “search”.In the “Search Results” field, select a user or multiple users by holding the control key and clicking on the listings to add and then click “OK”.

ACL permissions can be adjusted at any time for every user added in the folder permission’s dialog. Users may only grant ACL permissions if they have been given the administrator permission. ACL permissions may not be changed for either the owner or the administrator of the account.

The main “Folder Permissions” dialog window is now displayed again. The username or email address that was just entered is now displayed in the user dialog box. The default permission given to all new users is “Guest”. This can be modified using the pull-down menu in the “Folder Permissions” dialog window.

Each of the listed permissions can be set independently giving more granular control over folder sharing permissions.

Permissions

Description

Lookup

The user may see that the folder exists.

Read

The user may read the folder. The user may also select the folder, fetch data, perform searches, and copy messages from the folder.

Set Seen Flag

Keep, per-user, seen state. The “Seen” and “Recent” flags are preserved for the user.

Write

The user may modify flags and keywords other than “Seen” and “Deleted” (which are controlled by other sets of rights).

Insert

The user may insert new messages into the folder.

Post

A user may send a message to the folder. This right differs from the “Insert” right in that the delivery system inserts trace information into submitted messages so that you can filter address by user name, IP address or HTTP requests.

Create Folders

The user may create, delete or rename folders.

Delete Messages

The user may set a message as “Deleted” or permanently delete mail.

Delete Folders

The user may delete folder.

Perform Expunge

User can permanently expunge deleted messages from the folder.

Administrator

The user may change all the permissions on the folders.

Table 1

Folder Type

The “Folder Type” button gives the user the ability to select a specific “type” for any IMAP folder except for Inbox, Outbox, Deleted Items and Sent.

Figure 39 – Outlook Connector – Folder Type

This feature becomes useful if a user wants to create a second calendar to share with others rather than their standard calendar.

3.2.2 Refresh Folders

The “Refresh Folders” button refreshes the folder tree as seen when you press Alt + F1 (navigation pane). When pressed, the Outlook Connector actually scans each folder, not for contents but for the folders themselves. If folder changes are made on the server or if folders are shared to you from someone else, you would use the “Refresh Folders” to display those changes in Outlook.

Figure 40 – Outlook Connector – Refresh Folders

Note: The “Refresh Folders” button does not retrieve emails; it refreshes the IMAP folder tree only.

3.2.3 Account

The Outlook Connector Settings dialog window will be displayed first when selecting “Account” from the Outlook Connector toolbar. All of the information displayed on this screen is entered and configured during the Outlook Connector installation process. Changes can be made to this information as needed.

3.2.4 More Settings

To learn more about the additional settings which are available for configuration, click on the “More Settings…” button.

Across the top of this new window, you will see eight tabs:
General, Connections, Download, Folders, Send/Receive, Other Settings, Format, and About.

3.2.4.1 General

Figure 43– Outlook Connector – More Settings – Connections – IMAP

The General tab has two input fields. The first one is already filled in with a default value – “Insight Server Folders”. This is the name that will appear as the display name for “Outlook Today”. This is a user-defined field and can be changed.

The second field is labeled “Other User Information”. It is optional and has no effect on the functionality of the software. This is also a user-defined field.

3.2.4.2 Connections

The Connections tab is where IMAP, SMTP, LDAP and Timeout settings are configured.

Server name
This is the IMAP server name that was entered during installation; it can be changed if needed.

Port
By default, Bynari Server uses port 143.

Username
This is the user name that was entered during installation; it can be changed if needed.

Password
This is the password that was entered during installation; it can be changed if needed.

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure that your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Persistent Connection
The default and recommended selection is enabled.Important Information: Disabling the use of persistent connections will negatively affect the performance of the Outlook Connector. Persistent connections, also known as “keep alive” connections, reuse the same TCP connection for sending and receiving. This streamlines requests, reduces network traffic, network latency, CPU utilization and memory needs as it requires fewer resources.

Server name
This is the SMTP server name that was entered during installation; it can be changed if needed.

Port
By default, the Bynari Server uses port 25

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Same Authentication as Incoming Server
This uses your email username and password that you entered when you setup the account.

Use SMTP Authentication
This option is used when sending email from an SMTP server that is not part of the normal mail server network. i.e. an external address or a remote user. Enabling this feature tells the client to authenticate with the server to relay messages to external domains.

Note: The LDAP default options are configured for optimal use with Address Book 3.0 and Insight Server 4.3.

The Lightweight Directory Access Protocol or LDAP is an application protocol for querying and modifying directory services running over TCP/IP.

An LDAP directory is a set of objects with attributes organized in a logical and hierarchical manner. An example of LDAP could be an address book that consists of names organized alphabetically. Each name in the address book would have a corresponding email address and telephone number.

User DN
The User DN (Distinguished Name) is comprised of a unique identifier for the user and the domain container; the unique identifier is the container “cn=” in the LDAP database followed by the domain or organizational information.

Note: If you are using Insight Server, users can find their own “User DN” information. Log into the web management console as a user, then click on:

Preferences > “Client Configuration”

“Directory Server Account”, locate the field, “Account Name”.

Bynari Collaboration Server users must contact their administrator to retrieve the User DN.

An example DN might be: “cn=testuser1,o=example.net”

If you are not running the Bynari Server or Insight Server, please consult your LDAP administrator for your DN.

Use Incoming Server (IMAP) Password
This uses the IMAP password from the Connections > IMAP field.

Password
This is your password to the LDAP server.

Remember Password
Remember the password so that you do not have to enter it every time it accesses the LDAP server.

Toggling this option will allow for custom LDAP searches to group level.

LDAP Filter for Users:

This option defines the LDAP attribute for users.

LDAP Filter for Groups:

This option defines the LDAP attribute for groups.

LDAP Search Attributes:

The criteria used in the search attribute can be changed to meet your LDAP structural needs. This information can be found with the user’s container name or unique identifier in the LDAP database. An LDAP browser can quickly display these parameters. In this example, the data refers to the following information:

cn = Container name. Typically this is the user’s full name.

mail = User’s mail address.

givenName = Typically, this is the first name of a user.

sn = Surname or last name.

Base DN

The top level of the LDAP directory tree is the base, referred to as the “base DN”.

By default Outlook Connector attempts to determine your LDAP base DN by your User DN, which you specified on the Connections > LDAP tab. Consult with your LDAP administrator for your DN if the Base DN was not determined automatically.

LDAP Server Version

Select LDAP version

Manually select version 2 or LDAP version 3.

Detect

This button will attempt to get the LDAP server version automatically.

The value of these attributes is used to perform the searches against the LDAP database. These are comma delimited and can be changed depending on your setup.

User Attributes
The user attribute will search against “login” then “uid”.

User ID
The user id attribute will search against the “login” attribute.

First Name
The first name attribute will search against “givenName”.

Last Name
The last name attribute will search against “sn”.

Display Name
The display name attribute will search against “display-name”, “displayName”, and then “cn”.

E-mail Address
The e-mail address attribute will search against “mail”.

Others

Figure 49 – Outlook Connector – More Settings – Connections – IMAP

Timeout Setting

Server timeout value in number of seconds.
The Timeout Setting tells the server how long to wait before it closes the session. The default value is “0”. Acceptable values are: “0”, “30-600” seconds. In a corporate environment where the user is on the same network as the mail server, a timeout value of “0” may be adequate.Users on a Wide Area Network (WAN) need to consider larger timeout settings. Setting this value is dependent on your Internet connection speeds. If you are on a dial-up connection, you may want to set this value to 600 seconds whereas if you are on a DSL connection or cable modem connection, 60 seconds may be acceptable.Having a value too low can cause uploading issues when sending large attachments where the Internet upload speeds are usually slow.

Auto Registration Port
Auto registration is disabled by default. This option allows Outlook Connector to verify licensing with their local Insight Server or Bynari Server. If you do not use the Bynari Server or Insight Server, DO NOT enable the Auto Registration Port Checkbox. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Important Information: The Outlook Connector was designed to function over LAN-based and high speed broadband connections. Many remote users are able to utilize the Outlook Connector as it was designed. For users on poor remote connections, utilizing the Bynari Web Client may be a better option.

Use SSL
Use secure socket layer protocol to register.

3.2.4.3 Download

Figure 50 – Outlook Connector – More Settings – Download

Download Options

Download Headers Only
Enabled by default, this option improves the performance of the initial synchronization of the emails downloaded for Outlook. It downloads the header only for email messages. When the message is selected for viewing, the entire message is downloaded.

Note: Tasks, journals, contacts and calendar events are always set for full-content download when selected for viewing.

Download Contents of Message Only
Disabled by default, this option downloads the entire message during the synchronization of emails. Attachments are downloaded when the message is selected for viewing.

Download Contents of Message and Attachments
Disabled by default, this option downloads the entire message and associated attachments during the synchronization of emails.

Download All Attachments
This option will download all attachments.

Download Attachment Limit
This option will set the download attachment limit size in bytes. Any value is accepted in this field. The default is 50,000 bytes.

Download Message progress

Show progress indicator when loading messages
When this box is checked, a progress indicator will appear when synchronizing any folder with more than 50 messages. This option is checked by default.

Indicator threshold (number of messages)
This option allows you to modify when the indicator will appear. By default, this value is set to 50 messages, adjusting this to zero will display the indicator for every message.

3.2.4.4 Folders

Figure 51 – Outlook Connector – More Settings – Folders

Folder Type

Use ACL to set folder types
Enabled by default, it allows the Outlook Connector to use custom IMAP folder ACLs to specify the specialized folder types used by Outlook. These are “Calendar”, “Contact”, “Task”, “Journal”, “Notes“, and “Mail”. This option increases performance since the Outlook Connector no longer has to locate a hidden synchronization message to determine a given folder’s type.

Folder List

Show All Folders
This is enabled by default and tells the Outlook Connector to automatically subscribe to all folders found under the user’s folder list.

Show Only Subscribed Folders
In large environments, the default value of “Show All Folders” may not be desirable. This option allows the users to individually select only the folders they want to see in Outlook.

Important Information: When manually selecting folders, make sure that default folders are checked. i.e. Calendar, Contacts, Deleted Items, Sent Items, Outbox and Tasks. If you uncheck them, it will cause Outlook to recreate them on the IMAP server. This is a default behavior of Outlook.

3.2.4.5 Send/Receive

Figure 52 – Outlook Connector – More Settings – Send/Receive

Outlook Connector utilizes IMAP IDLE to update the Inbox folder. For servers that do not support IMAP IDLE make sure that the Inbox folder is selected.

3.2.4.6 Other Settings

Figure 53 – Outlook Connector – More Settings – Miscellaneous

The Other Settings tab contains two sections; one for read receipt request options and the second for local cache options.

Message Receipt Options

How would you like to respond to requests for read receipts on incoming messages?

Prompt me before sending a response
This option is the default setting. This setting “prompts” the user to choose between sending a read receipt or not.

Always send a response [default selection]
This option automatically sends a response to the sender of a read receipt request.

Never send a response
This option never sends a response to a read request sender.

Custom Location
This option allows you to change the location of the local cache. This enables the administrator to place the local cache on the network through a network share for user data backup if needed.

Note: Read, Write, Delete and Change permissions within Microsoft Windows are required for any Custom Location.

Note: Any changes made to the location of the local cache will require a restart of Outlook. If you do not restart Outlook, you may see errors, because the Outlook Connector must create the LocalCache.pst file.

3.2.4.7 Format

Figure 54 – Outlook Connector – More Settings – Format

Message Format Options

Note: “Use Kolab Format” option is available in the Kolab version of Outlook Connector 4.0.

Use Microsoft Message Format
This is also known as “.tnef” formatting which stands for Transport Neutral Encapsulation Format. This allows files to contain rich text formatting used by e-mail messages, such as bold, italics, underlining, etc…

Use iCal Format
This option is turned on by default in the “ical” or “iCalender” format version of Outlook Connector. iCalendar is a file format which allows sending meeting requests and tasks to other internet users via email or sharing files with an .ics extension.“iCal” format is significantly smaller than the “.tnef” format which can improve performance and save disk space.

Note: If you use a Kolab server or an iCalendar compatible server, you may not need to select “Use Microsoft Message Format”. If you are unsure, it is best to select both options.

Use Kolab Format
Use this option only if you are running a Bynari Collaborator Server or Kolab IMAP server. Kolab uses a unique XML format attached to email specifically for Kolab groupware servers. The XML holds information for contacts, calendar events, journals, etc.

3.2.4.8 Logging

Figure 55 – Outlook Connector – More Settings – Logging

Logging capabilities have been added to the Outlook Connector as a troubleshooting aid. By default, all logging is off. Log files can consume large amounts of disk space, and it is recommended that logging be left off, unless the user is experiencing problems.

When working with Bynari Technical Support on an issue, they may request that you enable logging. Verbose logging is the most thorough level of logging offered and will offer the most insight to the support technician.

3.2.4.9 About

Figure 56 – Outlook Connector – More Settings – About

About tab

The about tab provides information about the Outlook Connector. It contains the version number as well as all licensing information.

3.2.5 Quota

3.2.6 About

Figure 59 – Outlook Connector – About

The “About” button on the Outlook Connector toolbar performs the same function as the “About” tab discussed above in section 2.5.4.9.

4 Using Outlook Connector

Outlook Connector 4.0 provides Outlook with a MAPI transport service that makes connecting to an IMAP server transparent to the end user. The following sections describe some of the additional dialogs introduced by the Connector such as Folder permissions as well as documenting configuration changes needed for features such as Free/Busy.

4.1 Viewing Shared Folders

Note: Private events (calendar, contacts, and tasks) are stored on the server. Only the folder owner will see private events.

Other users’ shared folders will appear under ‘Other Users’ in the folder list.

Figure 61 – “Other Users” shared folder list

Public folders created on the Bynari Server and Insight Server will display under ‘Shared Folders’ in Outlook.

Figure 62 – “Shared Folders” public folder list

Note: Upgrade your Insight Server to at least 4.2.2 to support private events.

4.2 Free/Busy Configuration

Outlook allows users to share free/busy information from their calendars with other users on their mail server. With the Microsoft Office Internet Free/Busy Service, users can publish their free/busy times to a shared Internet location. Members using this service can view each other’s free/busy information when viewing shared calendars or creating meeting requests.

Publish “2” month(s) of Calendar free/busy information the server
Enter the number of months of Free/Busy information to be published.The default interval is 2 months. This value represents the number of months from today’s date.

Update free/busy information on the sever every “15” minutes
The default time is every 15 minutes. This value represents how often Outlook will update the user’s Free/Busy information on the server.

Internet Free/Busy

Publish at my location
This option must be checked. In figure 66, a path name is shown. Insert your information in place of the variables, “%NAME%.vcf”.

4.3 Show / Hide Toolbar

It places a check mark next to the name to show that the Connector is enabled.

Figure 67 – Show/Hide Outlook Connector Toolbar

If you have hidden the Outlook Connector toolbar at the time of the installation, you can show the toolbar by following the above steps.

5 Registering and Unregistering Outlook Connector

Outlook Connector 4.0 is configured to use auto registration by default when “Insight Server” is selected during installation. Auto registration is designed for users of both the Outlook Connector and Insight Server or the Bynari Server. With auto registration enabled, the Outlook Connector will verify that an active license exists for the client when Outlook starts. It is recommended that users of the Insight Server or the Bynari Server utilize this feature of the Outlook Connector.

If you do not have an Insight Server or Bynari Server, or do not wish to use auto registration, you can register your copy of the Outlook Connector using the “About” tab of the Outlook Connector toolbar.

5.1 Auto Registration

Enable or disable auto registration

Click on the “Account” tab in Outlook Connector toolbar.

Figure 68 – Outlook Connector – Account

Select “Connections” > “Others”.

Figure 69 – Outlook Connector – More Settings – Connections – IMAP

Important Information: Do not enable auto registration if you do not use the Insight Server or Bynari Collaborator Server (BCS).

Auto Registration Port
Auto registration is either enabled or disabled depending on your Insight Server selection during installation. This option allows Outlook Connector to verify licensing with a local Bynari Server or Insight Server. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Use SSL
Use secure socket layer protocol to register.

Troubleshooting Tip: If you are experiencing trouble registering the connector and your server does not support auto-registration, make sure that the “Auto Registration Port” option is NOT checked. This option is being deprecated in future versions of the connector.

Licensing

The Outlook Connector utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Outlook Connector (OC) will either contact the patched version of Insight Server 4.3, which allows auto-registration with OC 4.0, or Server 4.4. If you are using a 3rd party server, it will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Outlook Connector license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Outlook Connector may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of client licenses has been exceeded. The Bynari Key Server tracks how many systems have been activated using a given license. If the number of activated clients exceeds the total for the license, the Outlook Connector will inform you that additional licenses need to be purchased.

If you need to reinstall the Outlook Connector software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Outlook Connector toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 4.0 build of the Outlook Connector available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

Outlook Connector 4.0 has been tested with Bynari Server, Univention Corporate Server, Insight Server, and Bynari Collaboration Server, Cyrus, and Kolab IMAPv4 servers. Outlook Connector supports all base specifications as described in RFC 3501: Internet Message Access Protocol version 4rev1. If your IMAPv4 server supports the specifications in RFC 3501, Outlook Connector 4.0 may be compatible with your server. If you encounter issues with a different type of unsupported server, email support at support@bynari.net to create a support ticket. The Bynari support team will provide a reasonable effort in working with you.

1 Outlook Connector version 4.0

The Outlook Connector acts as a MAPI transport for Microsoft Outlook. As a MAPI transport provider, the Connector interprets all the different types of folders used by Outlook.

When Outlook Connector is used in conjunction with the Bynari Server or Insight Server, a powerful collaboration environment is created. Users are able to share mail folders, contacts, tasks, and calendars with other individuals. Public folders of each type can also be created and maintained by system administrators through the web admin interface. All of these functions are supported through the familiar Outlook interface eliminating any need for costly end user training.

1.1 Architecture

Messaging Application Programming Interface or MAPI has two major components. Applications such as Microsoft Outlook use the client side interface to contact the MAPI subsystem for all communications with the message store. There is also a service interface which is used by programs such as Outlook Connector to provide the MAPI transport services for accessing the message store on the server.

Outlook Connector acts as the transport that provides messaging services directly to the MAPI subsystem and stores this information on Insight Server and Bynari Server via the IMAP protocol.

Figure 1 – MAPI Architecture

1.2 Features of Outlook Connector

Outlook Connector 4.0 offers the following features:

Native MAPI implementation

Mobile sync with Windows Mobile device

Mobile sync with Blackberry Mobile device

Mobile sync of contacts with iPhone

Support for new Microsoft PST architecture enables files larger than 2G

1.3 Supported Platforms

Outlook Connector 4.0 is compatible with the following software. If you are using a version that is not listed, or software that is not supported, upgrade to a supported version.

Supported Windows®Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003

Outlook® 2007

Outlook® 2010 (32/64 bit)

Supported Languages

English

French

German

Italian

Spanish (Spain)

Portuguese (Brazil)

Dutch

Norwegian

Russian

Swedish

Taiwanese/Chinese

Czech

Hebrew

Note: Other languages are provided and may be used but are not formally supported. Problems with translation, spelling, grammar and proper character encoding may be encountered.

1.4 Supported IMAP Servers

Bynari Collaboration Server

Insight Server

Cyrus

Kolab

1.5 Supported mobility devices and software

Outlook Connector 4.0 includes mobility support for several devices including Blackberry, iPhone and Windows Mobile. The following versions are compatible with Outlook Connector 4.0.

1.6 Known Limitations

Microsoft Business Contact Manager is not compatible with Outlook Connector.

Smart Phone synchronization is dependent on the hardware and the software provider.

Slashes in folder names are not allowed.

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The Connector 4.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the Connector and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

Click on “Help” > “About” and then click on “Additional Version and Copyright Information”

Figure 2.3 – Outlook 2010 about dialog

Step 3: Backup “Rules and Alerts”

Outlook “Rules and Alerts” functions are used to organize incoming email. These functions allow users to set custom “actions” that will be performed automatically on incoming messages.

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Export “Rules and Alerts”

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 4 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 5 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Export Rules…” button.

Close Outlook to continue installing or updating Outlook Connector 4.0.

Note: In order to ensure proper Rules and Alerts functionality in Microsoft Outlook a check must be placed in the “Schedule an automatic send/receive every” checkbox under Tools>Options>Mail Setup>Send/Receive. Any amount of time may be specified in the associated “minutes” field.

2.2 Installing Outlook Connector – New Installation

The following section explains how to install the Outlook Connector 4.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Outlook Connector will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Outlook Connector and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Outlook Connector. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

End User License Agreement:Read the license agreement. If you agree, select the button, “I accept the license agreement” and select “Next”.

Create New Outlook Profile:The Outlook Connector will automatically create a profile for Outlook. The default name for this profile is “Outlook Connector”. The “default name” is a user defined field and may be changed if needed. Place a check in the box labeled, “Prompt for which profile to use when starting Outlook (Recommended)”, if you have multiple profiles in Outlook. Selecting this will prompt for profile selection when Outlook starts. Click “Next” to continue installation.

Figure 11 – Installation – Outlook Connector Create New Profile

Account Information:This screen provides the Outlook Connector with the information needed to create the Outlook profile for your email account during the installation process.
The following basic information is needed to complete this screen:

Your Name

E-mail Address

IMAP Server Address

SMTP Server Address

Username

Password

Figure 12 – Outlook Connector – Account Information

Note: Bynari Collaboration Server requires the entire email address to be used as the “username”. Insight Server only used the first part of the email address, leaving off “@domain.com”.

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 14 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 16 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 17 – Outlook Connector – Finish Install Wizard

2.3 Installing Outlook Connector – Upgrade

Upgrading the Outlook Connector is similar to the steps discussed under “Installing Outlook Connector – New Installation” in section 2.1.

In the upgrade process, no profile will be created and all of the original user data from the previous installation of the Outlook Connector is used. The Outlook Connector will automatically upgrade profiles from earlier Outlook Connector versions. Outlook Connector 3.x used a “local cache” data storage system while the Outlook Connector 4 uses a Microsoft PST file to store data.

When upgrading from any of the Outlook Connector 3.x versions, your profile will be upgraded to the new PST architecture. The Outlook Connector will need to perform an initial synchronization after the upgrade process completes.

Important Information: During the initial synchronization process, the Connector will download the newest emails first, and then it will continue to synchronize in the background. This allows the end-user to begin using Outlook immediately while synchronization continues.

Note: The Connector installer will automatically determine if your profile needs to be upgraded.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

Accept the terms of the End User License Agreement to install the Outlook Connector. If you agree to the terms of the license, select “I accept the agreement” then select “Next” to proceed to the next step.

Profile UpgradeIf Outlook Connector finds any existing profiles, it will upgrade them to the latest version. Confirm that you would like to continue by selecting “Yes”.

A custom installation location may be used. Select the “Browse” button to choose an alternate location to install the Outlook Connector. Select “Next” to continue the installation. If the existing installation location is used, the following informational window will be displayed. Select “Yes” to proceed to the next step.Figure 22 – Outlook Connector – Upgrade Destination Location

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 23 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 24 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 25 – Outlook Connector – Upgrade Complete

2.4 Installation Logs

Error Logging

This feature is only activated during a new installation of the Outlook Connector when a new profile is created. Error logging is not enabled during the upgrade process.

Viewing the Log File

The Outlook Connector generates a log file named “Bynari.log” in the user’s %TEMP% directory during the installation process.

Viewing the Log File:

Select “Start” > “Run”.

Type %TEMP% on the Run input field and select “OK”.

A new explorer window will open displaying the contents of the user’s %TEMP% directory.

Browse this directory for a text file named “Bynari.log”. This file can be viewed with any text editor.

Technical Support Logging

The Outlook Connector also offers additional logging capabilities for troubleshooting. These logs are located under: %AppData%\Local\Bynari\Bynari Insight Connector 4.0\

There are both “log” and “trace” directories located here.

To turn on logging, go to the Connector toolbar and click on:

Account > More Settings… > Logging

When working with Bynari Technical Support, “verbose” logging will be required for troubleshooting.

3 Post Installation Configuration

3.1 Import “Rules and Alerts”

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 26 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 27 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Import Rules…” button.

Ensure that there is a check in the “Send immediately when connected” (labeled “Automatic Send/Receive” in Outlook 2003) checkbox. The checkbox is located on the “Mail Setup” tab, under “Options”, in the “Tools” menu. This is required in order to ensure proper rules functionality.

3.2 Outlook Connector Toolbar

All custom configuration settings can be made through the Outlook Connector Toolbar.

Selecting the “Folder” button opens the “Folder Permissions” dialog window. From the “Folder Permissions” dialog window, additional users can be added by selecting the “Add” button

Figure 34– Outlook Connector – Add New User

Set Specific Permissions
Enter the appropriate username or full email address.

Note: As is the case with Bynari Collaboration Server, some servers require the entire email address to be used when adding a new user to a folder share while others only require the username. Check with your systems administrator for specific information about your server requirements.

Select “OK” to confirm adding the new user’s ACL to the specified folder.Figure 35– Outlook Connector – Add New User

Search Corporate Directory
This feature is used to search an LDAP directory to find users. Enter a value to search and then click “search”.In the “Search Results” field, select a user or multiple users by holding the control key and clicking on the listings to add and then click “OK”.

ACL permissions can be adjusted at any time for every user added in the folder permission’s dialog. Users may only grant ACL permissions if they have been given the administrator permission. ACL permissions may not be changed for either the owner or the administrator of the account.

The main “Folder Permissions” dialog window is now displayed again. The username or email address that was just entered is now displayed in the user dialog box. The default permission given to all new users is “Guest”. This can be modified using the pull-down menu in the “Folder Permissions” dialog window.

Each of the listed permissions can be set independently giving more granular control over folder sharing permissions.

Permissions

Description

Lookup

The user may see that the folder exists.

Read

The user may read the folder. The user may also select the folder, fetch data, perform searches, and copy messages from the folder.

Set Seen Flag

Keep, per-user, seen state. The “Seen” and “Recent” flags are preserved for the user.

Write

The user may modify flags and keywords other than “Seen” and “Deleted” (which are controlled by other sets of rights).

Insert

The user may insert new messages into the folder.

Post

A user may send a message to the folder. This right differs from the “Insert” right in that the delivery system inserts trace information into submitted messages so that you can filter address by user name, IP address or HTTP requests.

Create Folders

The user may create, delete or rename folders.

Delete Messages

The user may set a message as “Deleted” or permanently delete mail.

Delete Folders

The user may delete folder.

Perform Expunge

User can permanently expunge deleted messages from the folder.

Administrator

The user may change all the permissions on the folders.

Table 1

Folder Type

The “Folder Type” button gives the user the ability to select a specific “type” for any IMAP folder except for Inbox, Outbox, Deleted Items and Sent.

Figure 39 – Outlook Connector – Folder Type

This feature becomes useful if a user wants to create a second calendar to share with others rather than their standard calendar.

3.2.2 Refresh Folders

The “Refresh Folders” button refreshes the folder tree as seen when you press Alt + F1 (navigation pane). When pressed, the Outlook Connector actually scans each folder, not for contents but for the folders themselves. If folder changes are made on the server or if folders are shared to you from someone else, you would use the “Refresh Folders” to display those changes in Outlook.

Figure 40 – Outlook Connector – Refresh Folders

Note: The “Refresh Folders” button does not retrieve emails; it refreshes the IMAP folder tree only.

3.2.3 Account

The Outlook Connector Settings dialog window will be displayed first when selecting “Account” from the Outlook Connector toolbar. All of the information displayed on this screen is entered and configured during the Outlook Connector installation process. Changes can be made to this information as needed.

3.2.4 More Settings

To learn more about the additional settings which are available for configuration, click on the “More Settings…” button.

Across the top of this new window, you will see eight tabs:
General, Connections, Download, Folders, Send/Receive, Other Settings, Format, and About.

3.2.4.1 General

Figure 43– Outlook Connector – More Settings – Connections – IMAP

The General tab has two input fields. The first one is already filled in with a default value – “Insight Server Folders”. This is the name that will appear as the display name for “Outlook Today”. This is a user-defined field and can be changed.

The second field is labeled “Other User Information”. It is optional and has no effect on the functionality of the software. This is also a user-defined field.

3.2.4.2 Connections

The Connections tab is where IMAP, SMTP, LDAP and Timeout settings are configured.

Server name
This is the IMAP server name that was entered during installation; it can be changed if needed.

Port
By default, Bynari Server uses port 143.

Username
This is the user name that was entered during installation; it can be changed if needed.

Password
This is the password that was entered during installation; it can be changed if needed.

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure that your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Persistent Connection
The default and recommended selection is enabled.Important Information: Disabling the use of persistent connections will negatively affect the performance of the Outlook Connector. Persistent connections, also known as “keep alive” connections, reuse the same TCP connection for sending and receiving. This streamlines requests, reduces network traffic, network latency, CPU utilization and memory needs as it requires fewer resources.

Server name
This is the SMTP server name that was entered during installation; it can be changed if needed.

Port
By default, the Bynari Server uses port 25

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Same Authentication as Incoming Server
This uses your email username and password that you entered when you setup the account.

Use SMTP Authentication
This option is used when sending email from an SMTP server that is not part of the normal mail server network. i.e. an external address or a remote user. Enabling this feature tells the client to authenticate with the server to relay messages to external domains.

Note: The LDAP default options are configured for optimal use with Address Book 3.0 and Insight Server 4.3.

The Lightweight Directory Access Protocol or LDAP is an application protocol for querying and modifying directory services running over TCP/IP.

An LDAP directory is a set of objects with attributes organized in a logical and hierarchical manner. An example of LDAP could be an address book that consists of names organized alphabetically. Each name in the address book would have a corresponding email address and telephone number.

User DN
The User DN (Distinguished Name) is comprised of a unique identifier for the user and the domain container; the unique identifier is the container “cn=” in the LDAP database followed by the domain or organizational information.

Note: If you are using Insight Server, users can find their own “User DN” information. Log into the web management console as a user, then click on:

Preferences > “Client Configuration”

“Directory Server Account”, locate the field, “Account Name”.

Bynari Collaboration Server users must contact their administrator to retrieve the User DN.

An example DN might be: “cn=testuser1,o=example.net”

If you are not running the Bynari Server or Insight Server, please consult your LDAP administrator for your DN.

Use Incoming Server (IMAP) Password
This uses the IMAP password from the Connections > IMAP field.

Password
This is your password to the LDAP server.

Remember Password
Remember the password so that you do not have to enter it every time it accesses the LDAP server.

Toggling this option will allow for custom LDAP searches to group level.

LDAP Filter for Users:

This option defines the LDAP attribute for users.

LDAP Filter for Groups:

This option defines the LDAP attribute for groups.

LDAP Search Attributes:

The criteria used in the search attribute can be changed to meet your LDAP structural needs. This information can be found with the user’s container name or unique identifier in the LDAP database. An LDAP browser can quickly display these parameters. In this example, the data refers to the following information:

cn = Container name. Typically this is the user’s full name.

mail = User’s mail address.

givenName = Typically, this is the first name of a user.

sn = Surname or last name.

Base DN

The top level of the LDAP directory tree is the base, referred to as the “base DN”.

By default Outlook Connector attempts to determine your LDAP base DN by your User DN, which you specified on the Connections > LDAP tab. Consult with your LDAP administrator for your DN if the Base DN was not determined automatically.

LDAP Server Version

Select LDAP version

Manually select version 2 or LDAP version 3.

Detect

This button will attempt to get the LDAP server version automatically.

The value of these attributes is used to perform the searches against the LDAP database. These are comma delimited and can be changed depending on your setup.

User Attributes
The user attribute will search against “login” then “uid”.

User ID
The user id attribute will search against the “login” attribute.

First Name
The first name attribute will search against “givenName”.

Last Name
The last name attribute will search against “sn”.

Display Name
The display name attribute will search against “display-name”, “displayName”, and then “cn”.

E-mail Address
The e-mail address attribute will search against “mail”.

Others

Figure 49 – Outlook Connector – More Settings – Connections – IMAP

Timeout Setting

Server timeout value in number of seconds.
The Timeout Setting tells the server how long to wait before it closes the session. The default value is “0”. Acceptable values are: “0”, “30-600” seconds. In a corporate environment where the user is on the same network as the mail server, a timeout value of “0” may be adequate.Users on a Wide Area Network (WAN) need to consider larger timeout settings. Setting this value is dependent on your Internet connection speeds. If you are on a dial-up connection, you may want to set this value to 600 seconds whereas if you are on a DSL connection or cable modem connection, 60 seconds may be acceptable.Having a value too low can cause uploading issues when sending large attachments where the Internet upload speeds are usually slow.

Auto Registration Port
Auto registration is disabled by default. This option allows Outlook Connector to verify licensing with their local Insight Server or Bynari Server. If you do not use the Bynari Server or Insight Server, DO NOT enable the Auto Registration Port Checkbox. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Important Information: The Outlook Connector was designed to function over LAN-based and high speed broadband connections. Many remote users are able to utilize the Outlook Connector as it was designed. For users on poor remote connections, utilizing the Bynari Web Client may be a better option.

Use SSL
Use secure socket layer protocol to register.

3.2.4.3 Download

Figure 50 – Outlook Connector – More Settings – Download

Download Options

Download Headers Only
Enabled by default, this option improves the performance of the initial synchronization of the emails downloaded for Outlook. It downloads the header only for email messages. When the message is selected for viewing, the entire message is downloaded.

Note: Tasks, journals, contacts and calendar events are always set for full-content download when selected for viewing.

Download Contents of Message Only
Disabled by default, this option downloads the entire message during the synchronization of emails. Attachments are downloaded when the message is selected for viewing.

Download Contents of Message and Attachments
Disabled by default, this option downloads the entire message and associated attachments during the synchronization of emails.

Download All Attachments
This option will download all attachments.

Download Attachment Limit
This option will set the download attachment limit size in bytes. Any value is accepted in this field. The default is 50,000 bytes.

Download Message progress

Show progress indicator when loading messages
When this box is checked, a progress indicator will appear when synchronizing any folder with more than 50 messages. This option is checked by default.

Indicator threshold (number of messages)
This option allows you to modify when the indicator will appear. By default, this value is set to 50 messages, adjusting this to zero will display the indicator for every message.

3.2.4.4 Folders

Figure 51 – Outlook Connector – More Settings – Folders

Folder Type

Use ACL to set folder types
Enabled by default, it allows the Outlook Connector to use custom IMAP folder ACLs to specify the specialized folder types used by Outlook. These are “Calendar”, “Contact”, “Task”, “Journal”, “Notes“, and “Mail”. This option increases performance since the Outlook Connector no longer has to locate a hidden synchronization message to determine a given folder’s type.

Folder List

Show All Folders
This is enabled by default and tells the Outlook Connector to automatically subscribe to all folders found under the user’s folder list.

Show Only Subscribed Folders
In large environments, the default value of “Show All Folders” may not be desirable. This option allows the users to individually select only the folders they want to see in Outlook.

Important Information: When manually selecting folders, make sure that default folders are checked. i.e. Calendar, Contacts, Deleted Items, Sent Items, Outbox and Tasks. If you uncheck them, it will cause Outlook to recreate them on the IMAP server. This is a default behavior of Outlook.

3.2.4.5 Send/Receive

Figure 52 – Outlook Connector – More Settings – Send/Receive

Outlook Connector utilizes IMAP IDLE to update the Inbox folder. For servers that do not support IMAP IDLE make sure that the Inbox folder is selected.

3.2.4.6 Other Settings

Figure 53 – Outlook Connector – More Settings – Miscellaneous

The Other Settings tab contains two sections; one for read receipt request options and the second for local cache options.

Message Receipt Options

How would you like to respond to requests for read receipts on incoming messages?

Prompt me before sending a response
This option is the default setting. This setting “prompts” the user to choose between sending a read receipt or not.

Always send a response [default selection]
This option automatically sends a response to the sender of a read receipt request.

Never send a response
This option never sends a response to a read request sender.

Custom Location
This option allows you to change the location of the local cache. This enables the administrator to place the local cache on the network through a network share for user data backup if needed.

Note: Read, Write, Delete and Change permissions within Microsoft Windows are required for any Custom Location.

Note: Any changes made to the location of the local cache will require a restart of Outlook. If you do not restart Outlook, you may see errors, because the Outlook Connector must create the LocalCache.pst file.

3.2.4.7 Format

Figure 54 – Outlook Connector – More Settings – Format

Message Format Options

Note: “Use Kolab Format” option is available in the Kolab version of Outlook Connector 4.0.

Use Microsoft Message Format
This is also known as “.tnef” formatting which stands for Transport Neutral Encapsulation Format. This allows files to contain rich text formatting used by e-mail messages, such as bold, italics, underlining, etc…

Use iCal Format
This option is turned on by default in the “ical” or “iCalender” format version of Outlook Connector. iCalendar is a file format which allows sending meeting requests and tasks to other internet users via email or sharing files with an .ics extension.“iCal” format is significantly smaller than the “.tnef” format which can improve performance and save disk space.

Note: If you use a Kolab server or an iCalendar compatible server, you may not need to select “Use Microsoft Message Format”. If you are unsure, it is best to select both options.

Use Kolab Format
Use this option only if you are running a Bynari Collaborator Server or Kolab IMAP server. Kolab uses a unique XML format attached to email specifically for Kolab groupware servers. The XML holds information for contacts, calendar events, journals, etc.

3.2.4.8 Logging

Figure 55 – Outlook Connector – More Settings – Logging

Logging capabilities have been added to the Outlook Connector as a troubleshooting aid. By default, all logging is off. Log files can consume large amounts of disk space, and it is recommended that logging be left off, unless the user is experiencing problems.

When working with Bynari Technical Support on an issue, they may request that you enable logging. Verbose logging is the most thorough level of logging offered and will offer the most insight to the support technician.

3.2.4.9 About

Figure 56 – Outlook Connector – More Settings – About

About tab

The about tab provides information about the Outlook Connector. It contains the version number as well as all licensing information.

3.2.5 Quota

3.2.6 About

Figure 59 – Outlook Connector – About

The “About” button on the Outlook Connector toolbar performs the same function as the “About” tab discussed above in section 2.5.4.9.

4 Using Outlook Connector

Outlook Connector 4.0 provides Outlook with a MAPI transport service that makes connecting to an IMAP server transparent to the end user. The following sections describe some of the additional dialogs introduced by the Connector such as Folder permissions as well as documenting configuration changes needed for features such as Free/Busy.

4.1 Viewing Shared Folders

Note: Private events (calendar, contacts, and tasks) are stored on the server. Only the folder owner will see private events.

Other users’ shared folders will appear under ‘Other Users’ in the folder list.

Figure 61 – “Other Users” shared folder list

Public folders created on the Bynari Server and Insight Server will display under ‘Shared Folders’ in Outlook.

Figure 62 – “Shared Folders” public folder list

Note: Upgrade your Insight Server to at least 4.2.2 to support private events.

4.2 Free/Busy Configuration

Outlook allows users to share free/busy information from their calendars with other users on their mail server. With the Microsoft Office Internet Free/Busy Service, users can publish their free/busy times to a shared Internet location. Members using this service can view each other’s free/busy information when viewing shared calendars or creating meeting requests.

Publish “2” month(s) of Calendar free/busy information the server
Enter the number of months of Free/Busy information to be published.The default interval is 2 months. This value represents the number of months from today’s date.

Update free/busy information on the sever every “15” minutes
The default time is every 15 minutes. This value represents how often Outlook will update the user’s Free/Busy information on the server.

Internet Free/Busy

Publish at my location
This option must be checked. In figure 66, a path name is shown. Insert your information in place of the variables, “%NAME%.vcf”.

4.3 Show / Hide Toolbar

It places a check mark next to the name to show that the Connector is enabled.

Figure 67 – Show/Hide Outlook Connector Toolbar

If you have hidden the Outlook Connector toolbar at the time of the installation, you can show the toolbar by following the above steps.

5 Registering and Unregistering Outlook Connector

Outlook Connector 4.0 is configured to use auto registration by default when “Insight Server” is selected during installation. Auto registration is designed for users of both the Outlook Connector and Insight Server or the Bynari Server. With auto registration enabled, the Outlook Connector will verify that an active license exists for the client when Outlook starts. It is recommended that users of the Insight Server or the Bynari Server utilize this feature of the Outlook Connector.

If you do not have an Insight Server or Bynari Server, or do not wish to use auto registration, you can register your copy of the Outlook Connector using the “About” tab of the Outlook Connector toolbar.

5.1 Auto Registration

Enable or disable auto registration

Click on the “Account” tab in Outlook Connector toolbar.

Figure 68 – Outlook Connector – Account

Select “Connections” > “Others”.

Figure 69 – Outlook Connector – More Settings – Connections – IMAP

Important Information: Do not enable auto registration if you do not use the Insight Server or Bynari Collaborator Server (BCS).

Auto Registration Port
Auto registration is either enabled or disabled depending on your Insight Server selection during installation. This option allows Outlook Connector to verify licensing with a local Bynari Server or Insight Server. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Use SSL
Use secure socket layer protocol to register.

Troubleshooting Tip: If you are experiencing trouble registering the connector and your server does not support auto-registration, make sure that the “Auto Registration Port” option is NOT checked. This option is being deprecated in future versions of the connector.

Licensing

The Outlook Connector utilizes a licensing key system that assigns and stores the number of licenses that have been purchased by the customer. When Outlook starts, Outlook Connector (OC) will either contact the patched version of Insight Server 4.3, which allows auto-registration with OC 4.0, or Server 4.4. If you are using a 3rd party server, it will contact the Bynari license key server over the Internet to validate and activate the installed license. Activation will be attempted each time Outlook is started or until activation of the license is successful.

If you encounter any issues while activating your Outlook Connector license, please see below for a possible solution:

The client systems may be blocked from accessing the Internet, or Internet access is temporarily unavailable.

The license key entered during the installation of the Outlook Connector may be invalid. This could include issues such as an incorrect key or incorrect key version.

The number of client licenses has been exceeded. The Bynari Key Server tracks how many systems have been activated using a given license. If the number of activated clients exceeds the total for the license, the Outlook Connector will inform you that additional licenses need to be purchased.

If you need to reinstall the Outlook Connector software on a new system due to either hardware failure or system upgrade and need to unregister, do the following (See section 4.3 for complete details):

Open Outlook

Click on “About” tab in the Outlook Connector toolbar

Click on “License”

Click on “Unregister”

If you experience problems with license activation, please contact your reseller or Bynari support at support@bynari.net.

Important Notes:

This documentation applies to the latest 4.0 build of the Outlook Connector available from Bynari.

Make sure that Outlook is setup as the default e-mail client. To verify this on the workstation, go to Control Panel > Internet Options > Programs and make sure that Outlook is selected in the drop down box next to E-mail.

Outlook Connector 4.0 has been tested with Bynari Server, Univention Corporate Server, Insight Server, and Bynari Collaboration Server, Cyrus, and Kolab IMAPv4 servers. Outlook Connector supports all base specifications as described in RFC 3501: Internet Message Access Protocol version 4rev1. If your IMAPv4 server supports the specifications in RFC 3501, Outlook Connector 4.0 may be compatible with your server. If you encounter issues with a different type of unsupported server, email support at support@bynari.net to create a support ticket. The Bynari support team will provide a reasonable effort in working with you.

1 Outlook Connector version 4.0

The Outlook Connector acts as a MAPI transport for Microsoft Outlook. As a MAPI transport provider, the Connector interprets all the different types of folders used by Outlook.

When Outlook Connector is used in conjunction with the Bynari Server or Insight Server, a powerful collaboration environment is created. Users are able to share mail folders, contacts, tasks, and calendars with other individuals. Public folders of each type can also be created and maintained by system administrators through the web admin interface. All of these functions are supported through the familiar Outlook interface eliminating any need for costly end user training.

1.1 Architecture

Messaging Application Programming Interface or MAPI has two major components. Applications such as Microsoft Outlook use the client side interface to contact the MAPI subsystem for all communications with the message store. There is also a service interface which is used by programs such as Outlook Connector to provide the MAPI transport services for accessing the message store on the server.

Outlook Connector acts as the transport that provides messaging services directly to the MAPI subsystem and stores this information on Insight Server and Bynari Server via the IMAP protocol.

Figure 1 – MAPI Architecture

1.2 Features of Outlook Connector

Outlook Connector 4.0 offers the following features:

Native MAPI implementation

Mobile sync with Windows Mobile device

Mobile sync with Blackberry Mobile device

Mobile sync of contacts with iPhone

Support for new Microsoft PST architecture enables files larger than 2G

1.3 Supported Platforms

Outlook Connector 4.0 is compatible with the following software. If you are using a version that is not listed, or software that is not supported, upgrade to a supported version.

Supported Windows®Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003

Outlook® 2007

Outlook® 2010 (32/64 bit)

Supported Languages

English

French

German

Italian

Spanish (Spain)

Portuguese (Brazil)

Dutch

Norwegian

Russian

Swedish

Taiwanese/Chinese

Czech

Hebrew

Note: Other languages are provided and may be used but are not formally supported. Problems with translation, spelling, grammar and proper character encoding may be encountered.

1.4 Supported IMAP Servers

Bynari Collaboration Server

Insight Server

Cyrus

Kolab

1.5 Supported mobility devices and software

Outlook Connector 4.0 includes mobility support for several devices including Blackberry, iPhone and Windows Mobile. The following versions are compatible with Outlook Connector 4.0.

1.6 Known Limitations

Microsoft Business Contact Manager is not compatible with Outlook Connector.

Smart Phone synchronization is dependent on the hardware and the software provider.

Slashes in folder names are not allowed.

2 Installation

2.1 Preparing Your System (Pre-Installation)

Before you begin:

The Connector 4.0 software must be installed by the Windows login user. Additionally, this user needs “administrator” rights to install the software. The users’ rights can be changed to install the Connector and then reset to the original rights.

Before you begin the installation procedure, perform the following steps:

Step 1: Install Microsoft® Windows and/or Microsoft® Outlook

Supported Windows® Versions

Windows® XP

Windows® Vista

Windows® 7

Supported Outlook® Versions

Outlook® 2003 SP3+

Outlook® 2007 SP2+

Outlook® 2010 SP1+

Note: If you are using versions that are not listed, upgrade to a supported version.

Step 2: Install the Latest Updates for Microsoft® Windows and Outlook

Go to the Microsoft® website or check with your IT Administrator to verify that you have installed the most current critical updates and service packs for both your Windows operating system and Outlook.

Click on “Help” > “About” and then click on “Additional Version and Copyright Information”

Figure 2.3 – Outlook 2010 about dialog

Step 3: Backup “Rules and Alerts”

Outlook “Rules and Alerts” functions are used to organize incoming email. These functions allow users to set custom “actions” that will be performed automatically on incoming messages.

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Export “Rules and Alerts”

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 4 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 5 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Export Rules…” button.

Close Outlook to continue installing or updating Outlook Connector 4.0.

Note: In order to ensure proper Rules and Alerts functionality in Microsoft Outlook a check must be placed in the “Schedule an automatic send/receive every” checkbox under Tools>Options>Mail Setup>Send/Receive. Any amount of time may be specified in the associated “minutes” field.

2.2 Installing Outlook Connector – New Installation

The following section explains how to install the Outlook Connector 4.0 for the first time on a computer. The “upgrade” process is slightly different and available in the section 2.4 of this manual.

Note: The Outlook Connector will only install on systems where the user has “administrative” rights. The users’ rights can be changed to install the Outlook Connector and then reset to the original rights after the installation has completed.

Important Information: In some cases, virus scanning add-ins for Outlook may need to be disabled for the installation of the Outlook Connector. Disabling the virus scanning Outlook add-in should not change the functionality of your antivirus software.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

End User License Agreement:Read the license agreement. If you agree, select the button, “I accept the license agreement” and select “Next”.

Create New Outlook Profile:The Outlook Connector will automatically create a profile for Outlook. The default name for this profile is “Outlook Connector”. The “default name” is a user defined field and may be changed if needed. Place a check in the box labeled, “Prompt for which profile to use when starting Outlook (Recommended)”, if you have multiple profiles in Outlook. Selecting this will prompt for profile selection when Outlook starts. Click “Next” to continue installation.

Figure 11 – Installation – Outlook Connector Create New Profile

Account Information:This screen provides the Outlook Connector with the information needed to create the Outlook profile for your email account during the installation process.
The following basic information is needed to complete this screen:

Your Name

E-mail Address

IMAP Server Address

SMTP Server Address

Username

Password

Figure 12 – Outlook Connector – Account Information

Note: Bynari Collaboration Server requires the entire email address to be used as the “username”. Insight Server only used the first part of the email address, leaving off “@domain.com”.

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 14 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 16 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 17 – Outlook Connector – Finish Install Wizard

2.3 Installing Outlook Connector – Upgrade

Upgrading the Outlook Connector is similar to the steps discussed under “Installing Outlook Connector – New Installation” in section 2.1.

In the upgrade process, no profile will be created and all of the original user data from the previous installation of the Outlook Connector is used. The Outlook Connector will automatically upgrade profiles from earlier Outlook Connector versions. Outlook Connector 3.x used a “local cache” data storage system while the Outlook Connector 4 uses a Microsoft PST file to store data.

When upgrading from any of the Outlook Connector 3.x versions, your profile will be upgraded to the new PST architecture. The Outlook Connector will need to perform an initial synchronization after the upgrade process completes.

Important Information: During the initial synchronization process, the Connector will download the newest emails first, and then it will continue to synchronize in the background. This allows the end-user to begin using Outlook immediately while synchronization continues.

Note: The Connector installer will automatically determine if your profile needs to be upgraded.

Before you begin:

Verify that all steps in “Preparing Your System” (Pre-installation) section 2.1 are complete.

Accept the terms of the End User License Agreement to install the Outlook Connector. If you agree to the terms of the license, select “I accept the agreement” then select “Next” to proceed to the next step.

Profile UpgradeIf Outlook Connector finds any existing profiles, it will upgrade them to the latest version. Confirm that you would like to continue by selecting “Yes”.

A custom installation location may be used. Select the “Browse” button to choose an alternate location to install the Outlook Connector. Select “Next” to continue the installation. If the existing installation location is used, the following informational window will be displayed. Select “Yes” to proceed to the next step.Figure 22 – Outlook Connector – Upgrade Destination Location

Outlook Connector Toolbar Options:By default, the Outlook Connector Toolbar is configured to be displayed. Displaying the toolbar is the recommended configuration. Select “Yes” to hide the Outlook Connector toolbar. Click “Next” to continue.

Figure 23 – Outlook Connector – Display Toolbar

Ready to Install:
Review configuration settings and select “Install” to install the Outlook Connector. Click “Next” to continue the installation.

Figure 24 – Outlook Connector – Ready to Install

Setup Complete:
To automatically start Outlook, place a check in the box labeled “Run Outlook” and select “Finish”.

Figure 25 – Outlook Connector – Upgrade Complete

2.4 Installation Logs

Error Logging

This feature is only activated during a new installation of the Outlook Connector when a new profile is created. Error logging is not enabled during the upgrade process.

Viewing the Log File

The Outlook Connector generates a log file named “Bynari.log” in the user’s %TEMP% directory during the installation process.

Viewing the Log File:

Select “Start” > “Run”.

Type %TEMP% on the Run input field and select “OK”.

A new explorer window will open displaying the contents of the user’s %TEMP% directory.

Browse this directory for a text file named “Bynari.log”. This file can be viewed with any text editor.

Technical Support Logging

The Outlook Connector also offers additional logging capabilities for troubleshooting. These logs are located under: %AppData%\Local\Bynari\Bynari Insight Connector 4.0\

There are both “log” and “trace” directories located here.

To turn on logging, go to the Connector toolbar and click on:

Account > More Settings… > Logging

When working with Bynari Technical Support, “verbose” logging will be required for troubleshooting.

3 Post Installation Configuration

3.1 Import “Rules and Alerts”

Important Information: “Rules and Alerts” will not transfer during new installation of Outlook Connector 4.x or when upgrading from Outlook Connector 3.x to 4.x. “Rules and Alerts” are stored locally on your computer. They are not uploaded to the server.

Open Outlook

Click on “Tools” > “Rules and Alerts…”

Figure 26 –Installation – Tools – Rules and Alerts

Under the “E-mail Rules” tab, click on “Options”.

Figure 27 –Installation – Tools – Rules and Alerts

Under the “Import and export” area, click on the “Import Rules…” button.

Ensure that there is a check in the “Send immediately when connected” (labeled “Automatic Send/Receive” in Outlook 2003) checkbox. The checkbox is located on the “Mail Setup” tab, under “Options”, in the “Tools” menu. This is required in order to ensure proper rules functionality.

3.2 Outlook Connector Toolbar

All custom configuration settings can be made through the Outlook Connector Toolbar.

Selecting the “Folder” button opens the “Folder Permissions” dialog window. From the “Folder Permissions” dialog window, additional users can be added by selecting the “Add” button

Figure 34– Outlook Connector – Add New User

Set Specific Permissions
Enter the appropriate username or full email address.

Note: As is the case with Bynari Collaboration Server, some servers require the entire email address to be used when adding a new user to a folder share while others only require the username. Check with your systems administrator for specific information about your server requirements.

Select “OK” to confirm adding the new user’s ACL to the specified folder.Figure 35– Outlook Connector – Add New User

Search Corporate Directory
This feature is used to search an LDAP directory to find users. Enter a value to search and then click “search”.In the “Search Results” field, select a user or multiple users by holding the control key and clicking on the listings to add and then click “OK”.

ACL permissions can be adjusted at any time for every user added in the folder permission’s dialog. Users may only grant ACL permissions if they have been given the administrator permission. ACL permissions may not be changed for either the owner or the administrator of the account.

The main “Folder Permissions” dialog window is now displayed again. The username or email address that was just entered is now displayed in the user dialog box. The default permission given to all new users is “Guest”. This can be modified using the pull-down menu in the “Folder Permissions” dialog window.

Each of the listed permissions can be set independently giving more granular control over folder sharing permissions.

Permissions

Description

Lookup

The user may see that the folder exists.

Read

The user may read the folder. The user may also select the folder, fetch data, perform searches, and copy messages from the folder.

Set Seen Flag

Keep, per-user, seen state. The “Seen” and “Recent” flags are preserved for the user.

Write

The user may modify flags and keywords other than “Seen” and “Deleted” (which are controlled by other sets of rights).

Insert

The user may insert new messages into the folder.

Post

A user may send a message to the folder. This right differs from the “Insert” right in that the delivery system inserts trace information into submitted messages so that you can filter address by user name, IP address or HTTP requests.

Create Folders

The user may create, delete or rename folders.

Delete Messages

The user may set a message as “Deleted” or permanently delete mail.

Delete Folders

The user may delete folder.

Perform Expunge

User can permanently expunge deleted messages from the folder.

Administrator

The user may change all the permissions on the folders.

Table 1

Folder Type

The “Folder Type” button gives the user the ability to select a specific “type” for any IMAP folder except for Inbox, Outbox, Deleted Items and Sent.

Figure 39 – Outlook Connector – Folder Type

This feature becomes useful if a user wants to create a second calendar to share with others rather than their standard calendar.

3.2.2 Refresh Folders

The “Refresh Folders” button refreshes the folder tree as seen when you press Alt + F1 (navigation pane). When pressed, the Outlook Connector actually scans each folder, not for contents but for the folders themselves. If folder changes are made on the server or if folders are shared to you from someone else, you would use the “Refresh Folders” to display those changes in Outlook.

Figure 40 – Outlook Connector – Refresh Folders

Note: The “Refresh Folders” button does not retrieve emails; it refreshes the IMAP folder tree only.

3.2.3 Account

The Outlook Connector Settings dialog window will be displayed first when selecting “Account” from the Outlook Connector toolbar. All of the information displayed on this screen is entered and configured during the Outlook Connector installation process. Changes can be made to this information as needed.

3.2.4 More Settings

To learn more about the additional settings which are available for configuration, click on the “More Settings…” button.

Across the top of this new window, you will see eight tabs:
General, Connections, Download, Folders, Send/Receive, Other Settings, Format, and About.

3.2.4.1 General

Figure 43– Outlook Connector – More Settings – Connections – IMAP

The General tab has two input fields. The first one is already filled in with a default value – “Insight Server Folders”. This is the name that will appear as the display name for “Outlook Today”. This is a user-defined field and can be changed.

The second field is labeled “Other User Information”. It is optional and has no effect on the functionality of the software. This is also a user-defined field.

3.2.4.2 Connections

The Connections tab is where IMAP, SMTP, LDAP and Timeout settings are configured.

Server name
This is the IMAP server name that was entered during installation; it can be changed if needed.

Port
By default, Bynari Server uses port 143.

Username
This is the user name that was entered during installation; it can be changed if needed.

Password
This is the password that was entered during installation; it can be changed if needed.

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure that your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Persistent Connection
The default and recommended selection is enabled.Important Information: Disabling the use of persistent connections will negatively affect the performance of the Outlook Connector. Persistent connections, also known as “keep alive” connections, reuse the same TCP connection for sending and receiving. This streamlines requests, reduces network traffic, network latency, CPU utilization and memory needs as it requires fewer resources.

Server name
This is the SMTP server name that was entered during installation; it can be changed if needed.

Port
By default, the Bynari Server uses port 25

Do not use secure connection
Default configuration is to not use a secure connection.

Use secured connection (SSL)
Select this option if your server supports IMAP SSL. When selecting this option, the default port of 143 changes to port to 993. This value can be changed manually, if needed.

Use Transport Layer Security (TLS)
Make sure your server supports TLS before selecting this option. TLS provides endpoint encryption. This protocol allows all communication, including passwords, to be encrypted. TLS is the preferred and most secured method of SSL.

Use Same Authentication as Incoming Server
This uses your email username and password that you entered when you setup the account.

Use SMTP Authentication
This option is used when sending email from an SMTP server that is not part of the normal mail server network. i.e. an external address or a remote user. Enabling this feature tells the client to authenticate with the server to relay messages to external domains.

Note: The LDAP default options are configured for optimal use with Address Book 3.0 and Insight Server 4.3.

The Lightweight Directory Access Protocol or LDAP is an application protocol for querying and modifying directory services running over TCP/IP.

An LDAP directory is a set of objects with attributes organized in a logical and hierarchical manner. An example of LDAP could be an address book that consists of names organized alphabetically. Each name in the address book would have a corresponding email address and telephone number.

User DN
The User DN (Distinguished Name) is comprised of a unique identifier for the user and the domain container; the unique identifier is the container “cn=” in the LDAP database followed by the domain or organizational information.

Note: If you are using Insight Server, users can find their own “User DN” information. Log into the web management console as a user, then click on:

Preferences > “Client Configuration”

“Directory Server Account”, locate the field, “Account Name”.

Bynari Collaboration Server users must contact their administrator to retrieve the User DN.

An example DN might be: “cn=testuser1,o=example.net”

If you are not running the Bynari Server or Insight Server, please consult your LDAP administrator for your DN.

Use Incoming Server (IMAP) Password
This uses the IMAP password from the Connections > IMAP field.

Password
This is your password to the LDAP server.

Remember Password
Remember the password so that you do not have to enter it every time it accesses the LDAP server.

Toggling this option will allow for custom LDAP searches to group level.

LDAP Filter for Users:

This option defines the LDAP attribute for users.

LDAP Filter for Groups:

This option defines the LDAP attribute for groups.

LDAP Search Attributes:

The criteria used in the search attribute can be changed to meet your LDAP structural needs. This information can be found with the user’s container name or unique identifier in the LDAP database. An LDAP browser can quickly display these parameters. In this example, the data refers to the following information:

cn = Container name. Typically this is the user’s full name.

mail = User’s mail address.

givenName = Typically, this is the first name of a user.

sn = Surname or last name.

Base DN

The top level of the LDAP directory tree is the base, referred to as the “base DN”.

By default Outlook Connector attempts to determine your LDAP base DN by your User DN, which you specified on the Connections > LDAP tab. Consult with your LDAP administrator for your DN if the Base DN was not determined automatically.

LDAP Server Version

Select LDAP version

Manually select version 2 or LDAP version 3.

Detect

This button will attempt to get the LDAP server version automatically.

The value of these attributes is used to perform the searches against the LDAP database. These are comma delimited and can be changed depending on your setup.

User Attributes
The user attribute will search against “login” then “uid”.

User ID
The user id attribute will search against the “login” attribute.

First Name
The first name attribute will search against “givenName”.

Last Name
The last name attribute will search against “sn”.

Display Name
The display name attribute will search against “display-name”, “displayName”, and then “cn”.

E-mail Address
The e-mail address attribute will search against “mail”.

Others

Figure 49 – Outlook Connector – More Settings – Connections – IMAP

Timeout Setting

Server timeout value in number of seconds.
The Timeout Setting tells the server how long to wait before it closes the session. The default value is “0”. Acceptable values are: “0”, “30-600” seconds. In a corporate environment where the user is on the same network as the mail server, a timeout value of “0” may be adequate.Users on a Wide Area Network (WAN) need to consider larger timeout settings. Setting this value is dependent on your Internet connection speeds. If you are on a dial-up connection, you may want to set this value to 600 seconds whereas if you are on a DSL connection or cable modem connection, 60 seconds may be acceptable.Having a value too low can cause uploading issues when sending large attachments where the Internet upload speeds are usually slow.

Auto Registration Port
Auto registration is disabled by default. This option allows Outlook Connector to verify licensing with their local Insight Server or Bynari Server. If you do not use the Bynari Server or Insight Server, DO NOT enable the Auto Registration Port Checkbox. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Important Information: The Outlook Connector was designed to function over LAN-based and high speed broadband connections. Many remote users are able to utilize the Outlook Connector as it was designed. For users on poor remote connections, utilizing the Bynari Web Client may be a better option.

Use SSL
Use secure socket layer protocol to register.

3.2.4.3 Download

Figure 50 – Outlook Connector – More Settings – Download

Download Options

Download Headers Only
Enabled by default, this option improves the performance of the initial synchronization of the emails downloaded for Outlook. It downloads the header only for email messages. When the message is selected for viewing, the entire message is downloaded.

Note: Tasks, journals, contacts and calendar events are always set for full-content download when selected for viewing.

Download Contents of Message Only
Disabled by default, this option downloads the entire message during the synchronization of emails. Attachments are downloaded when the message is selected for viewing.

Download Contents of Message and Attachments
Disabled by default, this option downloads the entire message and associated attachments during the synchronization of emails.

Download All Attachments
This option will download all attachments.

Download Attachment Limit
This option will set the download attachment limit size in bytes. Any value is accepted in this field. The default is 50,000 bytes.

Download Message progress

Show progress indicator when loading messages
When this box is checked, a progress indicator will appear when synchronizing any folder with more than 50 messages. This option is checked by default.

Indicator threshold (number of messages)
This option allows you to modify when the indicator will appear. By default, this value is set to 50 messages, adjusting this to zero will display the indicator for every message.

3.2.4.4 Folders

Figure 51 – Outlook Connector – More Settings – Folders

Folder Type

Use ACL to set folder types
Enabled by default, it allows the Outlook Connector to use custom IMAP folder ACLs to specify the specialized folder types used by Outlook. These are “Calendar”, “Contact”, “Task”, “Journal”, “Notes“, and “Mail”. This option increases performance since the Outlook Connector no longer has to locate a hidden synchronization message to determine a given folder’s type.

Folder List

Show All Folders
This is enabled by default and tells the Outlook Connector to automatically subscribe to all folders found under the user’s folder list.

Show Only Subscribed Folders
In large environments, the default value of “Show All Folders” may not be desirable. This option allows the users to individually select only the folders they want to see in Outlook.

Important Information: When manually selecting folders, make sure that default folders are checked. i.e. Calendar, Contacts, Deleted Items, Sent Items, Outbox and Tasks. If you uncheck them, it will cause Outlook to recreate them on the IMAP server. This is a default behavior of Outlook.

3.2.4.5 Send/Receive

Figure 52 – Outlook Connector – More Settings – Send/Receive

Outlook Connector utilizes IMAP IDLE to update the Inbox folder. For servers that do not support IMAP IDLE make sure that the Inbox folder is selected.

3.2.4.6 Other Settings

Figure 53 – Outlook Connector – More Settings – Miscellaneous

The Other Settings tab contains two sections; one for read receipt request options and the second for local cache options.

Message Receipt Options

How would you like to respond to requests for read receipts on incoming messages?

Prompt me before sending a response
This option is the default setting. This setting “prompts” the user to choose between sending a read receipt or not.

Always send a response [default selection]
This option automatically sends a response to the sender of a read receipt request.

Never send a response
This option never sends a response to a read request sender.

Custom Location
This option allows you to change the location of the local cache. This enables the administrator to place the local cache on the network through a network share for user data backup if needed.

Note: Read, Write, Delete and Change permissions within Microsoft Windows are required for any Custom Location.

Note: Any changes made to the location of the local cache will require a restart of Outlook. If you do not restart Outlook, you may see errors, because the Outlook Connector must create the LocalCache.pst file.

3.2.4.7 Format

Figure 54 – Outlook Connector – More Settings – Format

Message Format Options

Note: “Use Kolab Format” option is available in the Kolab version of Outlook Connector 4.0.

Use Microsoft Message Format
This is also known as “.tnef” formatting which stands for Transport Neutral Encapsulation Format. This allows files to contain rich text formatting used by e-mail messages, such as bold, italics, underlining, etc…

Use iCal Format
This option is turned on by default in the “ical” or “iCalender” format version of Outlook Connector. iCalendar is a file format which allows sending meeting requests and tasks to other internet users via email or sharing files with an .ics extension.“iCal” format is significantly smaller than the “.tnef” format which can improve performance and save disk space.

Note: If you use a Kolab server or an iCalendar compatible server, you may not need to select “Use Microsoft Message Format”. If you are unsure, it is best to select both options.

Use Kolab Format
Use this option only if you are running a Bynari Collaborator Server or Kolab IMAP server. Kolab uses a unique XML format attached to email specifically for Kolab groupware servers. The XML holds information for contacts, calendar events, journals, etc.

3.2.4.8 Logging

Figure 55 – Outlook Connector – More Settings – Logging

Logging capabilities have been added to the Outlook Connector as a troubleshooting aid. By default, all logging is off. Log files can consume large amounts of disk space, and it is recommended that logging be left off, unless the user is experiencing problems.

When working with Bynari Technical Support on an issue, they may request that you enable logging. Verbose logging is the most thorough level of logging offered and will offer the most insight to the support technician.

3.2.4.9 About

Figure 56 – Outlook Connector – More Settings – About

About tab

The about tab provides information about the Outlook Connector. It contains the version number as well as all licensing information.

3.2.5 Quota

3.2.6 About

Figure 59 – Outlook Connector – About

The “About” button on the Outlook Connector toolbar performs the same function as the “About” tab discussed above in section 2.5.4.9.

4 Using Outlook Connector

Outlook Connector 4.0 provides Outlook with a MAPI transport service that makes connecting to an IMAP server transparent to the end user. The following sections describe some of the additional dialogs introduced by the Connector such as Folder permissions as well as documenting configuration changes needed for features such as Free/Busy.

4.1 Viewing Shared Folders

Note: Private events (calendar, contacts, and tasks) are stored on the server. Only the folder owner will see private events.

Other users’ shared folders will appear under ‘Other Users’ in the folder list.

Figure 61 – “Other Users” shared folder list

Public folders created on the Bynari Server and Insight Server will display under ‘Shared Folders’ in Outlook.

Figure 62 – “Shared Folders” public folder list

Note: Upgrade your Insight Server to at least 4.2.2 to support private events.

4.2 Free/Busy Configuration

Outlook allows users to share free/busy information from their calendars with other users on their mail server. With the Microsoft Office Internet Free/Busy Service, users can publish their free/busy times to a shared Internet location. Members using this service can view each other’s free/busy information when viewing shared calendars or creating meeting requests.

Publish “2” month(s) of Calendar free/busy information the server
Enter the number of months of Free/Busy information to be published.The default interval is 2 months. This value represents the number of months from today’s date.

Update free/busy information on the sever every “15” minutes
The default time is every 15 minutes. This value represents how often Outlook will update the user’s Free/Busy information on the server.

Internet Free/Busy

Publish at my location
This option must be checked. In figure 66, a path name is shown. Insert your information in place of the variables, “%NAME%.vcf”.

4.3 Show / Hide Toolbar

It places a check mark next to the name to show that the Connector is enabled.

Figure 67 – Show/Hide Outlook Connector Toolbar

If you have hidden the Outlook Connector toolbar at the time of the installation, you can show the toolbar by following the above steps.

5 Registering and Unregistering Outlook Connector

Outlook Connector 4.0 is configured to use auto registration by default when “Insight Server” is selected during installation. Auto registration is designed for users of both the Outlook Connector and Insight Server or the Bynari Server. With auto registration enabled, the Outlook Connector will verify that an active license exists for the client when Outlook starts. It is recommended that users of the Insight Server or the Bynari Server utilize this feature of the Outlook Connector.

If you do not have an Insight Server or Bynari Server, or do not wish to use auto registration, you can register your copy of the Outlook Connector using the “About” tab of the Outlook Connector toolbar.

5.1 Auto Registration

Enable or disable auto registration

Click on the “Account” tab in Outlook Connector toolbar.

Figure 68 – Outlook Connector – Account

Select “Connections” > “Others”.

Figure 69 – Outlook Connector – More Settings – Connections – IMAP

Important Information: Do not enable auto registration if you do not use the Insight Server or Bynari Collaborator Server (BCS).

Auto Registration Port
Auto registration is either enabled or disabled depending on your Insight Server selection during installation. This option allows Outlook Connector to verify licensing with a local Bynari Server or Insight Server. By default, port 80 is used. This option can be changed depending on your Bynari Server or Insight Server, and your firewall configuration.

Use SSL
Use secure socket layer protocol to register.

Troubleshooting Tip: If you are experiencing trouble registering the connector and your server does not support auto-registration, make sure that the “Auto Registration Port” option is NOT checked. This option is being deprecated in future versions of the connector.

Overview

ExportPST exports Microsoft Personal Storage Table (PST) files to IMAP servers. This simplifies the process of migrating between PST files, and from one email server to another. Single or multiple PST files can be exported for a single or multiple users. Export tasks can be configured to run immediately, or scheduled to run at a later time.

1.Installation

Once the installation file has been downloaded, extract the installer from within the .zip file. After the installer has been extracted from the .zip file, double-click on the Installer’s icon to begin the installation process.

Figure 1- Installer Icon

Welcome

On the installer’s Welcome screen, click the “Next” button to begin the installation.

Figure 2 – Welcome

License Agreement

If you choose to accept the terms of the license agreement, select the “I accept the agreement” radio button then click the “Next” button. If you choose not to accept the terms of the agreement, the installation will be cancelled.

Figure 3 – License Agreement

Select Destination Location

On the “Select Destination Location” window, select the folder in which you would like to install ExportPST. In most situations, selecting the default location is recommended.

Once the installation location has been selected, click the “Next” button.

Figure 4 – Select Destination Location

Select Start Menu Folder

On the “Select Start Menu Folder” window, select the location of the ExportPST Start Menu folder. In most situations, selecting the default location is recommended.

Once the location for the Start Menu folder has been selected, click the “Next” button.

Figure 5 – Start Menu Folder

Ready to Install

On the “Ready to Install” screen, click the “Install” button to begin installing ExportPST on your computer.

Figure 6 – Ready to Install

Installation Complete

On the final screen of the installation, click the “Finish” button to complete the process. Placing a check in the “Run Export PST” checkbox will start ExportPST immediately after clicking the “Finish” button.

Figure 7 – Installation Complete

The installation is complete. ExportPST can now be opened by selecting its icon in the Windows Start menu.

2.Exporting Email Data

2.1.Getting Started

After ExportPST is launched, the main configuration window (figure 8) is presented. From here one or more user accounts can be added, edited or removed. From this window PST files can also be modified, previously configured export schedules can be accessed, and information about the ExportPST installation can be viewed.

The “User Accounts” window displays a list of all user accounts currently configured.

PST Files

The “PST Files” window displays a list of all PST files which have been added for whichever user has been selected, and is currently highlighted in the “User Accounts” window.

Add

Clicking the “Add” button allows the user to browse for and select both user accounts and their associated PST files for export to the server. Files may be selected from either the user’s local system, or a network share.

Edit

Clicking on a user account, to highlight it in the list, then clicking the “Edit” button will allow editing of the configuration information related to that user.

Remove

The “Remove” button is used to remove user accounts by clicking on the desired user account, to highlight it in the list, then clicking the “Remove” button.

Modify

The “Modify” button is used to make changes to PST data intended for export. The PST data is modified by clicking on the PST file, to highlight it in the list, then clicking the “Modify” button. Changes that can be made include selecting only certain mail folders for export rather than exporting all of the email data contained within the PST file.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Exit

Clicking the “Exit” button will close ExportPST without exporting any PST data to the server.

Previous

The “Previous” button takes the user to the previous screen in the configuration. The “Previous” button is only accessible when user accounts and PST files from a previous session already exist in the in the “User Accounts” and “PST Files” windows.

Next

Clicking the “Next” button presents the next step in the configuration.

2.2.Adding Users

Clicking the “Add” or “Edit” (when at least one account already exists) buttons on the main configuration screen presents an window (figure 9) from which details about the user account being added (or edited) may be entered.

Figure 9 – Configuration Window

IMAP Username

In the “IMAP Username” field enter the username for the email account to which the PST data is being exported.

IMAP Password

Enter the password for the email account to which the PST data is being exported, in the “IMAP Password” field.

Use Global Administrator Account

The “Use Global Administrator Account” feature allows server administrators with access to a global administrator account to export on behalf of any user on the server by using that user’s username in conjunction with the global administrator accounts user’s password.

Note: The “Use Global Administrator Account” feature is currently tested and supported only for users who are exporting PST files to a Bynari Server, and using the Bynari Server’s “manager” password as the global administrator account password.

Server AddressIn the “Server Address” field place the IP (Internet Protocol) address or fully qualified domain name of email server to which the data is to be exported.

Note: If you do not know the IP address or fully qualified domain name of the email server, it can be provided by the email server administrator.

Server Port

Enter the port number for the mail server in the “Server Port” field. Port 143 is the default value for this field.

Note: If you do not know the email server’s server port number, it can be provided by the email server administrator.

Use secured connection (SSL)

Place a check mark in the “Use secured connection (SSL)” checkbox if the email server requires a secured connection (SSL).

Note: If you are unsure whether or not the email server requires a secured connection, contact the email server administrator.

Note: Placing a check in the “Use secured connection (SSL)” checkbox will automatically change the Incoming Mail Port field to 993 (the default SSL port). If you are unsure the port required by the server for SSL, contact the email server administrator.

Test Account Settings

It is recommended that when account information is edited or entered for the first time that the account information is tested by clicking the “Test Account Settings” button before configuring additional accounts or proceeding to the next stage of the export process.

2.3.Adding PST Files

After adding a user and clicking the “Next” button a window (figure 10) from which you can to add one or more PST files to be exported for the user is presented.

Figure 10 Adding PST Files

PST Files

The “PST Files” window displays all PST files which have been added for the user.

Add

Clicking the “Add” button allows you to browse your computer for PST files to export.

Remove

Clicking on a PST file, to highlight it in the list, then clicking the “Remove” button will remove the selected PST file from the list.

Export Folder Type

In order to select which portion of a particular PST is to be exported, select the PST in the “PST Files” window, to highlight it within the list, then select from the “Export Folder Type” drop-down menu the portion of the PST file that you would like to have exported to the email server. The “Export Folder Type” drop-menu options are: “Inbox Folder Only”, “All Folders”, “All Calendars”, “All Contacts”, “All Tasks”, and “Select Folders”, which allows selecting one or more specific folders (including custom folders) from within the PST file.

Use global settings for folder type

Placing a check mark in the “Use global settings for folder type” checkbox allows you to use the menu to the right of the checkbox to make a single selection about which part of a PST file to export, and have that selection automatically applied to every PST file in the list.

Clicking the “Next” button presents a new window (figure 11) from which the Export task can be set to initiate immediately, or scheduled to run at a later time.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.4.Initiating the Export

Once at least one user has been added with at least one PST file added for that user, clicking the “Next” button will present the scheduling screen (figure 11). From this screen the export can be either initiated immediately, or scheduled for a later time.

Figure 11 Scheduling the Export

Schedule Name

The “Schedule Name” field can be populated with any name that you wish to use for identifying the export task, whether initiated immediately, or scheduled to run at a later time.

Run Now

Placing a check in the “Run Now” checkbox will disable all schedule-related settings and prepare ExportPST for immediate initialization of the configured export task.

Start Date

In the “Start Date” field select the date on which you would like to run the configured export task.

Start Time

In the “Start Time” field select the time at which you would like to run the configured export task.

Administrator Username

In the “Administrator Username” field, enter the username for any user with Administrator privileges on the computer where ExportPST is installed.

Administrator Password

In the “Administrator Password” field enter the password associated with the user whose username was entered in the “Administrator Username” field.

Previous

The “Previous” button presents the previous screen in the configuration (figure 10), where users and PST files can be added, edited and removed.

Next

Clicking the “Next” button presents a new window (figure 12) in which a list of scheduled exports can be viewed.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.5.Scheduled Exports

A window displaying scheduled exports (figure 12) is displayed when ExportPST first starts, if exports have been previously scheduled and are currently queued. This same window is also displayed following the configuration of a new export task.

Figure 12 Saved Schedules

Schedule Exports

The “Schedule Exports” window displays a list of the currently queued export tasks.

Schedule Details

The “Schedule Details” window provides detailed information about the currently scheduled exports.

Add

Clicking the “Add” button allows you to add a new schedule.

Edit

Clicking on a queued schedule, to highlight it in the list, then clicking the “Edit” button allows you to edit the selected schedule.

Remove

Clicking on a queued schedule, to highlight it in the list, then clicking the “Remove” button will remove the selected schedule from the queue.

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Previous

Clicking “Previous” returns you to the previous screen.

Save/Close

Clicking the “Save/Close” button will begin the export, if an export has been configured with the “Run Now” (section 2.4, Initiating the Export) option selected. If the “Run Now” option has not been selected for any currently queued export tasks, clicking the “Save/Close” button will close ExportPST, saving all configuration and schedule information.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

3.Log Settings

Clicking the “Log Settings” button on the main ExportPST configuration window provides access to the various ExportPST log-related features.

Figure 13 Log Settings

Log File

In the “Log File” field choose the desired log file name and location by entering a complete path to the file (including the filename). The browse button may also be used to select a location for the log file. The example in figure 13 creates a log file named “SampleLog.log” and places it in the top level of the C drive.

Maximum log size

The “Maximum Log Size” drop-down menu provides six options for controlling the size of the logs generated by ExportPST.

The six different log size options are:

None

100kb

200kb

300kb

400kb

500kb

Selecting “None” from the “Maximum Log Size” drop-down menu will place no restrictions on the maximum size of the log file.

Log level

The “Log Level” drop-down menu provides a choice between writing all ExportPST activity to the log, or writing only error-related activity to the log.

OK

Clicking the “OK” button will close the log configuration window, and save all changes.

Cancel

Clicking the “Cancel” button will close the log configuration window without saving any changes.

4.Product Registration

4.1.Demo Mode

Export PST will operate in “Demo” mode until registered. “Demo” mode provides an opportunity to try ExportPST before making the decision to purchase. ExportPST is fully functional when in “Demo” mode, with the following exceptions.

The options in the “Export Folder Type” drop-down menu are limited to “All Folders”, “Inbox Folder Only”, “All Calendars”, and “All Contacts” when Export PST is used in demo mode.

When “All Folders” is chosen from the “Export Folder Type” drop-down menu, the export is limited to 15 items. In Demo mode selecting “All Folders” will export PST data from the Inbox, Calendars and Contacts folders only.

When “Inbox Folder Only”, “All Calendars”, or “All Contacts” is chosen in the “Export Folder Type” drop-down menu, the export is limited to five items, while running in demo mode.

4.2.Registering ExportPST

There are no restrictions placed on fully registered ExportPST installations. Product registration information is accessed through the ExportPST “About” window. The “About” window can be displayed by clicking the “About” button on the main ExportPST configuration window.

Figure 14 About ExportPST

Clicking the “About” window’s “License” button displays detailed license and registration information, as well as providing an opportunity to register a previously unregistered copy of ExportPST.

Figure 15 Entering Product License Key

Enter your product license key

An ExportPST license key will be provided at the time of purchase. The license key enables the full functionality of ExportPST. The license key must be entered into the “Enter your product license key” field in order to register ExportPST.

Manual Registration

For systems with limited or no Internet access it may be necessary to register ExportPST manually. In order manually register ExportPST you must request a PGP signed certificate from a Bynari representative. Placing a check in the “Manual Registration” checkbox allows access to the “Enter the license certificate below” field, where the PGP signed certificate can be entered.

Note: Manual registration requires both a license key and a PGP signed certificate.

Which port would you like to use to register?

The “Which port would you like to use to register” drop-down menu provides a choice between port 80 and port 3080 for connecting to the Bynari registration server to register ExportPST. The default setting is 80, which is the best choice for most installations. If the system on which ExportPST is installed is unable to connect to the Bynari registration server on either port 80 or 3080, it will be necessary to register manually.

OK

Once the license key (and the PGP signed certificate, if required) has been entered and the registration port has been selected, clicking the “OK” button on the license window will initiate the ExportPST registration.

Cancel

Clicking the “Cancel” button on the license window will close the window, making no attempt to register ExportPST.

Once registered, ExportPST will display the following information in the license window.

The license key used to register ExportPST

The date, if any, on which the license expires

The number of licenses currently in use

The total number of licenses provided for use by the license key

The versions of ExportPST supported by the license

Supported, special, additional options provided by the license

Once the registered, the license window will also display the following button changes.

Refresh

If changes are made to the license information, clicking the “Refresh” button will display the changes immediately. Otherwise the changes will be displayed after ExportPST is closed and reopened.

Unregister

Clicking the “Unregister” button will remove the ExportPST registration and disable all features other than starting and re-registering the software.

OK

Clicking the “OK” button will close the license window.

Figure 16 Registered

5 Reporting Problems

Be sure to include the following information when reporting problems to Bynari:

The Microsoft Windows version number and patch level.

The Microsoft Windows version number and patch level are obtained by right-clicking on the “My Computer” icon on the “Desktop” (or in the “Start” menu) and selecting “Properties” from the pop-up menu.

In Windows 7/Vista, the Windows version and patch level will be listed in the “System” section of this window.

In Windows XP, the Windows version and patch level will be listed under “System” on the “General” tab of this window.

The full version number of ExportPST.

The Bynari ExportPST full version number is obtained by clicking the “About” button on the main configuration window.

Trademarks

Microsoft Windows, Microsoft Outlook and Windows logos are trademarks of Microsoft Corporation in the United States, other countries, or both.

All other trademarks are the property of their respective owners.

Technical Support

When you purchase any of Bynari’s products, all the products except the WebDAV Collaborator include one year of free support and maintenance. To purchase additional yearly support and maintenance, please contact sales@bynari.net.

Overview

ExportPST exports Microsoft Personal Storage Table (PST) files to IMAP servers. This simplifies the process of migrating between PST files, and from one email server to another. Single or multiple PST files can be exported for a single or multiple users. Export tasks can be configured to run immediately, or scheduled to run at a later time.

1.Installation

Once the installation file has been downloaded, extract the installer from within the .zip file. After the installer has been extracted from the .zip file, double-click on the Installer’s icon to begin the installation process.

Figure 1- Installer Icon

Welcome

On the installer’s Welcome screen, click the “Next” button to begin the installation.

Figure 2 – Welcome

License Agreement

If you choose to accept the terms of the license agreement, select the “I accept the agreement” radio button then click the “Next” button. If you choose not to accept the terms of the agreement, the installation will be cancelled.

Figure 3 – License Agreement

Select Destination Location

On the “Select Destination Location” window, select the folder in which you would like to install ExportPST. In most situations, selecting the default location is recommended.

Once the installation location has been selected, click the “Next” button.

Figure 4 – Select Destination Location

Select Start Menu Folder

On the “Select Start Menu Folder” window, select the location of the ExportPST Start Menu folder. In most situations, selecting the default location is recommended.

Once the location for the Start Menu folder has been selected, click the “Next” button.

Figure 5 – Start Menu Folder

Ready to Install

On the “Ready to Install” screen, click the “Install” button to begin installing ExportPST on your computer.

Figure 6 – Ready to Install

Installation Complete

On the final screen of the installation, click the “Finish” button to complete the process. Placing a check in the “Run Export PST” checkbox will start ExportPST immediately after clicking the “Finish” button.

Figure 7 – Installation Complete

The installation is complete. ExportPST can now be opened by selecting its icon in the Windows Start menu.

2.Exporting Email Data

2.1.Getting Started

After ExportPST is launched, the main configuration window (figure 8) is presented. From here one or more user accounts can be added, edited or removed. From this window PST files can also be modified, previously configured export schedules can be accessed, and information about the ExportPST installation can be viewed.

The “User Accounts” window displays a list of all user accounts currently configured.

PST Files

The “PST Files” window displays a list of all PST files which have been added for whichever user has been selected, and is currently highlighted in the “User Accounts” window.

Add

Clicking the “Add” button allows the user to browse for and select both user accounts and their associated PST files for export to the server. Files may be selected from either the user’s local system, or a network share.

Edit

Clicking on a user account, to highlight it in the list, then clicking the “Edit” button will allow editing of the configuration information related to that user.

Remove

The “Remove” button is used to remove user accounts by clicking on the desired user account, to highlight it in the list, then clicking the “Remove” button.

Modify

The “Modify” button is used to make changes to PST data intended for export. The PST data is modified by clicking on the PST file, to highlight it in the list, then clicking the “Modify” button. Changes that can be made include selecting only certain mail folders for export rather than exporting all of the email data contained within the PST file.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Exit

Clicking the “Exit” button will close ExportPST without exporting any PST data to the server.

Previous

The “Previous” button takes the user to the previous screen in the configuration. The “Previous” button is only accessible when user accounts and PST files from a previous session already exist in the in the “User Accounts” and “PST Files” windows.

Next

Clicking the “Next” button presents the next step in the configuration.

2.2.Adding Users

Clicking the “Add” or “Edit” (when at least one account already exists) buttons on the main configuration screen presents an window (figure 9) from which details about the user account being added (or edited) may be entered.

Figure 9 – Configuration Window

IMAP Username

In the “IMAP Username” field enter the username for the email account to which the PST data is being exported.

IMAP Password

Enter the password for the email account to which the PST data is being exported, in the “IMAP Password” field.

Use Global Administrator Account

The “Use Global Administrator Account” feature allows server administrators with access to a global administrator account to export on behalf of any user on the server by using that user’s username in conjunction with the global administrator accounts user’s password.

Note: The “Use Global Administrator Account” feature is currently tested and supported only for users who are exporting PST files to a Bynari Server, and using the Bynari Server’s “manager” password as the global administrator account password.

Server AddressIn the “Server Address” field place the IP (Internet Protocol) address or fully qualified domain name of email server to which the data is to be exported.

Note: If you do not know the IP address or fully qualified domain name of the email server, it can be provided by the email server administrator.

Server Port

Enter the port number for the mail server in the “Server Port” field. Port 143 is the default value for this field.

Note: If you do not know the email server’s server port number, it can be provided by the email server administrator.

Use secured connection (SSL)

Place a check mark in the “Use secured connection (SSL)” checkbox if the email server requires a secured connection (SSL).

Note: If you are unsure whether or not the email server requires a secured connection, contact the email server administrator.

Note: Placing a check in the “Use secured connection (SSL)” checkbox will automatically change the Incoming Mail Port field to 993 (the default SSL port). If you are unsure the port required by the server for SSL, contact the email server administrator.

Test Account Settings

It is recommended that when account information is edited or entered for the first time that the account information is tested by clicking the “Test Account Settings” button before configuring additional accounts or proceeding to the next stage of the export process.

2.3.Adding PST Files

After adding a user and clicking the “Next” button a window (figure 10) from which you can to add one or more PST files to be exported for the user is presented.

Figure 10 Adding PST Files

PST Files

The “PST Files” window displays all PST files which have been added for the user.

Add

Clicking the “Add” button allows you to browse your computer for PST files to export.

Remove

Clicking on a PST file, to highlight it in the list, then clicking the “Remove” button will remove the selected PST file from the list.

Export Folder Type

In order to select which portion of a particular PST is to be exported, select the PST in the “PST Files” window, to highlight it within the list, then select from the “Export Folder Type” drop-down menu the portion of the PST file that you would like to have exported to the email server. The “Export Folder Type” drop-menu options are: “Inbox Folder Only”, “All Folders”, “All Calendars”, “All Contacts”, “All Tasks”, and “Select Folders”, which allows selecting one or more specific folders (including custom folders) from within the PST file.

Use global settings for folder type

Placing a check mark in the “Use global settings for folder type” checkbox allows you to use the menu to the right of the checkbox to make a single selection about which part of a PST file to export, and have that selection automatically applied to every PST file in the list.

Clicking the “Next” button presents a new window (figure 11) from which the Export task can be set to initiate immediately, or scheduled to run at a later time.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.4.Initiating the Export

Once at least one user has been added with at least one PST file added for that user, clicking the “Next” button will present the scheduling screen (figure 11). From this screen the export can be either initiated immediately, or scheduled for a later time.

Figure 11 Scheduling the Export

Schedule Name

The “Schedule Name” field can be populated with any name that you wish to use for identifying the export task, whether initiated immediately, or scheduled to run at a later time.

Run Now

Placing a check in the “Run Now” checkbox will disable all schedule-related settings and prepare ExportPST for immediate initialization of the configured export task.

Start Date

In the “Start Date” field select the date on which you would like to run the configured export task.

Start Time

In the “Start Time” field select the time at which you would like to run the configured export task.

Administrator Username

In the “Administrator Username” field, enter the username for any user with Administrator privileges on the computer where ExportPST is installed.

Administrator Password

In the “Administrator Password” field enter the password associated with the user whose username was entered in the “Administrator Username” field.

Previous

The “Previous” button presents the previous screen in the configuration (figure 10), where users and PST files can be added, edited and removed.

Next

Clicking the “Next” button presents a new window (figure 12) in which a list of scheduled exports can be viewed.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.5.Scheduled Exports

A window displaying scheduled exports (figure 12) is displayed when ExportPST first starts, if exports have been previously scheduled and are currently queued. This same window is also displayed following the configuration of a new export task.

Figure 12 Saved Schedules

Schedule Exports

The “Schedule Exports” window displays a list of the currently queued export tasks.

Schedule Details

The “Schedule Details” window provides detailed information about the currently scheduled exports.

Add

Clicking the “Add” button allows you to add a new schedule.

Edit

Clicking on a queued schedule, to highlight it in the list, then clicking the “Edit” button allows you to edit the selected schedule.

Remove

Clicking on a queued schedule, to highlight it in the list, then clicking the “Remove” button will remove the selected schedule from the queue.

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Previous

Clicking “Previous” returns you to the previous screen.

Save/Close

Clicking the “Save/Close” button will begin the export, if an export has been configured with the “Run Now” (section 2.4, Initiating the Export) option selected. If the “Run Now” option has not been selected for any currently queued export tasks, clicking the “Save/Close” button will close ExportPST, saving all configuration and schedule information.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

3.Log Settings

Clicking the “Log Settings” button on the main ExportPST configuration window provides access to the various ExportPST log-related features.

Figure 13 Log Settings

Log File

In the “Log File” field choose the desired log file name and location by entering a complete path to the file (including the filename). The browse button may also be used to select a location for the log file. The example in figure 13 creates a log file named “SampleLog.log” and places it in the top level of the C drive.

Maximum log size

The “Maximum Log Size” drop-down menu provides six options for controlling the size of the logs generated by ExportPST.

The six different log size options are:

None

100kb

200kb

300kb

400kb

500kb

Selecting “None” from the “Maximum Log Size” drop-down menu will place no restrictions on the maximum size of the log file.

Log level

The “Log Level” drop-down menu provides a choice between writing all ExportPST activity to the log, or writing only error-related activity to the log.

OK

Clicking the “OK” button will close the log configuration window, and save all changes.

Cancel

Clicking the “Cancel” button will close the log configuration window without saving any changes.

4.Product Registration

4.1.Demo Mode

Export PST will operate in “Demo” mode until registered. “Demo” mode provides an opportunity to try ExportPST before making the decision to purchase. ExportPST is fully functional when in “Demo” mode, with the following exceptions.

The options in the “Export Folder Type” drop-down menu are limited to “All Folders”, “Inbox Folder Only”, “All Calendars”, and “All Contacts” when Export PST is used in demo mode.

When “All Folders” is chosen from the “Export Folder Type” drop-down menu, the export is limited to 15 items. In Demo mode selecting “All Folders” will export PST data from the Inbox, Calendars and Contacts folders only.

When “Inbox Folder Only”, “All Calendars”, or “All Contacts” is chosen in the “Export Folder Type” drop-down menu, the export is limited to five items, while running in demo mode.

4.2.Registering ExportPST

There are no restrictions placed on fully registered ExportPST installations. Product registration information is accessed through the ExportPST “About” window. The “About” window can be displayed by clicking the “About” button on the main ExportPST configuration window.

Figure 14 About ExportPST

Clicking the “About” window’s “License” button displays detailed license and registration information, as well as providing an opportunity to register a previously unregistered copy of ExportPST.

Figure 15 Entering Product License Key

Enter your product license key

An ExportPST license key will be provided at the time of purchase. The license key enables the full functionality of ExportPST. The license key must be entered into the “Enter your product license key” field in order to register ExportPST.

Manual Registration

For systems with limited or no Internet access it may be necessary to register ExportPST manually. In order manually register ExportPST you must request a PGP signed certificate from a Bynari representative. Placing a check in the “Manual Registration” checkbox allows access to the “Enter the license certificate below” field, where the PGP signed certificate can be entered.

Note: Manual registration requires both a license key and a PGP signed certificate.

Which port would you like to use to register?

The “Which port would you like to use to register” drop-down menu provides a choice between port 80 and port 3080 for connecting to the Bynari registration server to register ExportPST. The default setting is 80, which is the best choice for most installations. If the system on which ExportPST is installed is unable to connect to the Bynari registration server on either port 80 or 3080, it will be necessary to register manually.

OK

Once the license key (and the PGP signed certificate, if required) has been entered and the registration port has been selected, clicking the “OK” button on the license window will initiate the ExportPST registration.

Cancel

Clicking the “Cancel” button on the license window will close the window, making no attempt to register ExportPST.

Once registered, ExportPST will display the following information in the license window.

The license key used to register ExportPST

The date, if any, on which the license expires

The number of licenses currently in use

The total number of licenses provided for use by the license key

The versions of ExportPST supported by the license

Supported, special, additional options provided by the license

Once the registered, the license window will also display the following button changes.

Refresh

If changes are made to the license information, clicking the “Refresh” button will display the changes immediately. Otherwise the changes will be displayed after ExportPST is closed and reopened.

Unregister

Clicking the “Unregister” button will remove the ExportPST registration and disable all features other than starting and re-registering the software.

OK

Clicking the “OK” button will close the license window.

Figure 16 Registered

5 Reporting Problems

Be sure to include the following information when reporting problems to Bynari:

The Microsoft Windows version number and patch level.

The Microsoft Windows version number and patch level are obtained by right-clicking on the “My Computer” icon on the “Desktop” (or in the “Start” menu) and selecting “Properties” from the pop-up menu.

In Windows 7/Vista, the Windows version and patch level will be listed in the “System” section of this window.

In Windows XP, the Windows version and patch level will be listed under “System” on the “General” tab of this window.

The full version number of ExportPST.

The Bynari ExportPST full version number is obtained by clicking the “About” button on the main configuration window.

Overview

ExportPST exports Microsoft Personal Storage Table (PST) files to IMAP servers. This simplifies the process of migrating between PST files, and from one email server to another. Single or multiple PST files can be exported for a single or multiple users. Export tasks can be configured to run immediately, or scheduled to run at a later time.

1.Installation

Once the installation file has been downloaded, extract the installer from within the .zip file. After the installer has been extracted from the .zip file, double-click on the Installer’s icon to begin the installation process.

Figure 1- Installer Icon

Welcome

On the installer’s Welcome screen, click the “Next” button to begin the installation.

Figure 2 – Welcome

License Agreement

If you choose to accept the terms of the license agreement, select the “I accept the agreement” radio button then click the “Next” button. If you choose not to accept the terms of the agreement, the installation will be cancelled.

Figure 3 – License Agreement

Select Destination Location

On the “Select Destination Location” window, select the folder in which you would like to install ExportPST. In most situations, selecting the default location is recommended.

Once the installation location has been selected, click the “Next” button.

Figure 4 – Select Destination Location

Select Start Menu Folder

On the “Select Start Menu Folder” window, select the location of the ExportPST Start Menu folder. In most situations, selecting the default location is recommended.

Once the location for the Start Menu folder has been selected, click the “Next” button.

Figure 5 – Start Menu Folder

Ready to Install

On the “Ready to Install” screen, click the “Install” button to begin installing ExportPST on your computer.

Figure 6 – Ready to Install

Installation Complete

On the final screen of the installation, click the “Finish” button to complete the process. Placing a check in the “Run Export PST” checkbox will start ExportPST immediately after clicking the “Finish” button.

Figure 7 – Installation Complete

The installation is complete. ExportPST can now be opened by selecting its icon in the Windows Start menu.

2.Exporting Email Data

2.1.Getting Started

After ExportPST is launched, the main configuration window (figure 8) is presented. From here one or more user accounts can be added, edited or removed. From this window PST files can also be modified, previously configured export schedules can be accessed, and information about the ExportPST installation can be viewed.

The “User Accounts” window displays a list of all user accounts currently configured.

PST Files

The “PST Files” window displays a list of all PST files which have been added for whichever user has been selected, and is currently highlighted in the “User Accounts” window.

Add

Clicking the “Add” button allows the user to browse for and select both user accounts and their associated PST files for export to the server. Files may be selected from either the user’s local system, or a network share.

Edit

Clicking on a user account, to highlight it in the list, then clicking the “Edit” button will allow editing of the configuration information related to that user.

Remove

The “Remove” button is used to remove user accounts by clicking on the desired user account, to highlight it in the list, then clicking the “Remove” button.

Modify

The “Modify” button is used to make changes to PST data intended for export. The PST data is modified by clicking on the PST file, to highlight it in the list, then clicking the “Modify” button. Changes that can be made include selecting only certain mail folders for export rather than exporting all of the email data contained within the PST file.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Exit

Clicking the “Exit” button will close ExportPST without exporting any PST data to the server.

Previous

The “Previous” button takes the user to the previous screen in the configuration. The “Previous” button is only accessible when user accounts and PST files from a previous session already exist in the in the “User Accounts” and “PST Files” windows.

Next

Clicking the “Next” button presents the next step in the configuration.

2.2.Adding Users

Clicking the “Add” or “Edit” (when at least one account already exists) buttons on the main configuration screen presents an window (figure 9) from which details about the user account being added (or edited) may be entered.

Figure 9 – Configuration Window

IMAP Username

In the “IMAP Username” field enter the username for the email account to which the PST data is being exported.

IMAP Password

Enter the password for the email account to which the PST data is being exported, in the “IMAP Password” field.

Use Global Administrator Account

The “Use Global Administrator Account” feature allows server administrators with access to a global administrator account to export on behalf of any user on the server by using that user’s username in conjunction with the global administrator accounts user’s password.

Note: The “Use Global Administrator Account” feature is currently tested and supported only for users who are exporting PST files to a Bynari Server, and using the Bynari Server’s “manager” password as the global administrator account password.

Server AddressIn the “Server Address” field place the IP (Internet Protocol) address or fully qualified domain name of email server to which the data is to be exported.

Note: If you do not know the IP address or fully qualified domain name of the email server, it can be provided by the email server administrator.

Server Port

Enter the port number for the mail server in the “Server Port” field. Port 143 is the default value for this field.

Note: If you do not know the email server’s server port number, it can be provided by the email server administrator.

Use secured connection (SSL)

Place a check mark in the “Use secured connection (SSL)” checkbox if the email server requires a secured connection (SSL).

Note: If you are unsure whether or not the email server requires a secured connection, contact the email server administrator.

Note: Placing a check in the “Use secured connection (SSL)” checkbox will automatically change the Incoming Mail Port field to 993 (the default SSL port). If you are unsure the port required by the server for SSL, contact the email server administrator.

Test Account Settings

It is recommended that when account information is edited or entered for the first time that the account information is tested by clicking the “Test Account Settings” button before configuring additional accounts or proceeding to the next stage of the export process.

2.3.Adding PST Files

After adding a user and clicking the “Next” button a window (figure 10) from which you can to add one or more PST files to be exported for the user is presented.

Figure 10 Adding PST Files

PST Files

The “PST Files” window displays all PST files which have been added for the user.

Add

Clicking the “Add” button allows you to browse your computer for PST files to export.

Remove

Clicking on a PST file, to highlight it in the list, then clicking the “Remove” button will remove the selected PST file from the list.

Export Folder Type

In order to select which portion of a particular PST is to be exported, select the PST in the “PST Files” window, to highlight it within the list, then select from the “Export Folder Type” drop-down menu the portion of the PST file that you would like to have exported to the email server. The “Export Folder Type” drop-menu options are: “Inbox Folder Only”, “All Folders”, “All Calendars”, “All Contacts”, “All Tasks”, and “Select Folders”, which allows selecting one or more specific folders (including custom folders) from within the PST file.

Use global settings for folder type

Placing a check mark in the “Use global settings for folder type” checkbox allows you to use the menu to the right of the checkbox to make a single selection about which part of a PST file to export, and have that selection automatically applied to every PST file in the list.

Clicking the “Next” button presents a new window (figure 11) from which the Export task can be set to initiate immediately, or scheduled to run at a later time.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.4.Initiating the Export

Once at least one user has been added with at least one PST file added for that user, clicking the “Next” button will present the scheduling screen (figure 11). From this screen the export can be either initiated immediately, or scheduled for a later time.

Figure 11 Scheduling the Export

Schedule Name

The “Schedule Name” field can be populated with any name that you wish to use for identifying the export task, whether initiated immediately, or scheduled to run at a later time.

Run Now

Placing a check in the “Run Now” checkbox will disable all schedule-related settings and prepare ExportPST for immediate initialization of the configured export task.

Start Date

In the “Start Date” field select the date on which you would like to run the configured export task.

Start Time

In the “Start Time” field select the time at which you would like to run the configured export task.

Administrator Username

In the “Administrator Username” field, enter the username for any user with Administrator privileges on the computer where ExportPST is installed.

Administrator Password

In the “Administrator Password” field enter the password associated with the user whose username was entered in the “Administrator Username” field.

Previous

The “Previous” button presents the previous screen in the configuration (figure 10), where users and PST files can be added, edited and removed.

Next

Clicking the “Next” button presents a new window (figure 12) in which a list of scheduled exports can be viewed.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.5.Scheduled Exports

A window displaying scheduled exports (figure 12) is displayed when ExportPST first starts, if exports have been previously scheduled and are currently queued. This same window is also displayed following the configuration of a new export task.

Figure 12 Saved Schedules

Schedule Exports

The “Schedule Exports” window displays a list of the currently queued export tasks.

Schedule Details

The “Schedule Details” window provides detailed information about the currently scheduled exports.

Add

Clicking the “Add” button allows you to add a new schedule.

Edit

Clicking on a queued schedule, to highlight it in the list, then clicking the “Edit” button allows you to edit the selected schedule.

Remove

Clicking on a queued schedule, to highlight it in the list, then clicking the “Remove” button will remove the selected schedule from the queue.

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Previous

Clicking “Previous” returns you to the previous screen.

Save/Close

Clicking the “Save/Close” button will begin the export, if an export has been configured with the “Run Now” (section 2.4, Initiating the Export) option selected. If the “Run Now” option has not been selected for any currently queued export tasks, clicking the “Save/Close” button will close ExportPST, saving all configuration and schedule information.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

3.Log Settings

Clicking the “Log Settings” button on the main ExportPST configuration window provides access to the various ExportPST log-related features.

Figure 13 Log Settings

Log File

In the “Log File” field choose the desired log file name and location by entering a complete path to the file (including the filename). The browse button may also be used to select a location for the log file. The example in figure 13 creates a log file named “SampleLog.log” and places it in the top level of the C drive.

Maximum log size

The “Maximum Log Size” drop-down menu provides six options for controlling the size of the logs generated by ExportPST.

The six different log size options are:

None

100kb

200kb

300kb

400kb

500kb

Selecting “None” from the “Maximum Log Size” drop-down menu will place no restrictions on the maximum size of the log file.

Log level

The “Log Level” drop-down menu provides a choice between writing all ExportPST activity to the log, or writing only error-related activity to the log.

OK

Clicking the “OK” button will close the log configuration window, and save all changes.

Cancel

Clicking the “Cancel” button will close the log configuration window without saving any changes.

4.Product Registration

4.1.Demo Mode

Export PST will operate in “Demo” mode until registered. “Demo” mode provides an opportunity to try ExportPST before making the decision to purchase. ExportPST is fully functional when in “Demo” mode, with the following exceptions.

The options in the “Export Folder Type” drop-down menu are limited to “All Folders”, “Inbox Folder Only”, “All Calendars”, and “All Contacts” when Export PST is used in demo mode.

When “All Folders” is chosen from the “Export Folder Type” drop-down menu, the export is limited to 15 items. In Demo mode selecting “All Folders” will export PST data from the Inbox, Calendars and Contacts folders only.

When “Inbox Folder Only”, “All Calendars”, or “All Contacts” is chosen in the “Export Folder Type” drop-down menu, the export is limited to five items, while running in demo mode.

4.2.Registering ExportPST

There are no restrictions placed on fully registered ExportPST installations. Product registration information is accessed through the ExportPST “About” window. The “About” window can be displayed by clicking the “About” button on the main ExportPST configuration window.

Figure 14 About ExportPST

Clicking the “About” window’s “License” button displays detailed license and registration information, as well as providing an opportunity to register a previously unregistered copy of ExportPST.

Figure 15 Entering Product License Key

Enter your product license key

An ExportPST license key will be provided at the time of purchase. The license key enables the full functionality of ExportPST. The license key must be entered into the “Enter your product license key” field in order to register ExportPST.

Manual Registration

For systems with limited or no Internet access it may be necessary to register ExportPST manually. In order manually register ExportPST you must request a PGP signed certificate from a Bynari representative. Placing a check in the “Manual Registration” checkbox allows access to the “Enter the license certificate below” field, where the PGP signed certificate can be entered.

Note: Manual registration requires both a license key and a PGP signed certificate.

Which port would you like to use to register?

The “Which port would you like to use to register” drop-down menu provides a choice between port 80 and port 3080 for connecting to the Bynari registration server to register ExportPST. The default setting is 80, which is the best choice for most installations. If the system on which ExportPST is installed is unable to connect to the Bynari registration server on either port 80 or 3080, it will be necessary to register manually.

OK

Once the license key (and the PGP signed certificate, if required) has been entered and the registration port has been selected, clicking the “OK” button on the license window will initiate the ExportPST registration.

Cancel

Clicking the “Cancel” button on the license window will close the window, making no attempt to register ExportPST.

Once registered, ExportPST will display the following information in the license window.

The license key used to register ExportPST

The date, if any, on which the license expires

The number of licenses currently in use

The total number of licenses provided for use by the license key

The versions of ExportPST supported by the license

Supported, special, additional options provided by the license

Once the registered, the license window will also display the following button changes.

Refresh

If changes are made to the license information, clicking the “Refresh” button will display the changes immediately. Otherwise the changes will be displayed after ExportPST is closed and reopened.

Unregister

Clicking the “Unregister” button will remove the ExportPST registration and disable all features other than starting and re-registering the software.

OK

Clicking the “OK” button will close the license window.

Figure 16 Registered

5 Reporting Problems

Be sure to include the following information when reporting problems to Bynari:

The Microsoft Windows version number and patch level.

The Microsoft Windows version number and patch level are obtained by right-clicking on the “My Computer” icon on the “Desktop” (or in the “Start” menu) and selecting “Properties” from the pop-up menu.

In Windows 7/Vista, the Windows version and patch level will be listed in the “System” section of this window.

In Windows XP, the Windows version and patch level will be listed under “System” on the “General” tab of this window.

The full version number of ExportPST.

The Bynari ExportPST full version number is obtained by clicking the “About” button on the main configuration window.

Overview

ExportPST exports Microsoft Personal Storage Table (PST) files to IMAP servers. This simplifies the process of migrating between PST files, and from one email server to another. Single or multiple PST files can be exported for a single or multiple users. Export tasks can be configured to run immediately, or scheduled to run at a later time.

1.Installation

Once the installation file has been downloaded, extract the installer from within the .zip file. After the installer has been extracted from the .zip file, double-click on the Installer’s icon to begin the installation process.

Figure 1- Installer Icon

Welcome

On the installer’s Welcome screen, click the “Next” button to begin the installation.

Figure 2 – Welcome

License Agreement

If you choose to accept the terms of the license agreement, select the “I accept the agreement” radio button then click the “Next” button. If you choose not to accept the terms of the agreement, the installation will be cancelled.

Figure 3 – License Agreement

Select Destination Location

On the “Select Destination Location” window, select the folder in which you would like to install ExportPST. In most situations, selecting the default location is recommended.

Once the installation location has been selected, click the “Next” button.

Figure 4 – Select Destination Location

Select Start Menu Folder

On the “Select Start Menu Folder” window, select the location of the ExportPST Start Menu folder. In most situations, selecting the default location is recommended.

Once the location for the Start Menu folder has been selected, click the “Next” button.

Figure 5 – Start Menu Folder

Ready to Install

On the “Ready to Install” screen, click the “Install” button to begin installing ExportPST on your computer.

Figure 6 – Ready to Install

Installation Complete

On the final screen of the installation, click the “Finish” button to complete the process. Placing a check in the “Run Export PST” checkbox will start ExportPST immediately after clicking the “Finish” button.

Figure 7 – Installation Complete

The installation is complete. ExportPST can now be opened by selecting its icon in the Windows Start menu.

2.Exporting Email Data

2.1.Getting Started

After ExportPST is launched, the main configuration window (figure 8) is presented. From here one or more user accounts can be added, edited or removed. From this window PST files can also be modified, previously configured export schedules can be accessed, and information about the ExportPST installation can be viewed.

The “User Accounts” window displays a list of all user accounts currently configured.

PST Files

The “PST Files” window displays a list of all PST files which have been added for whichever user has been selected, and is currently highlighted in the “User Accounts” window.

Add

Clicking the “Add” button allows the user to browse for and select both user accounts and their associated PST files for export to the server. Files may be selected from either the user’s local system, or a network share.

Edit

Clicking on a user account, to highlight it in the list, then clicking the “Edit” button will allow editing of the configuration information related to that user.

Remove

The “Remove” button is used to remove user accounts by clicking on the desired user account, to highlight it in the list, then clicking the “Remove” button.

Modify

The “Modify” button is used to make changes to PST data intended for export. The PST data is modified by clicking on the PST file, to highlight it in the list, then clicking the “Modify” button. Changes that can be made include selecting only certain mail folders for export rather than exporting all of the email data contained within the PST file.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Exit

Clicking the “Exit” button will close ExportPST without exporting any PST data to the server.

Previous

The “Previous” button takes the user to the previous screen in the configuration. The “Previous” button is only accessible when user accounts and PST files from a previous session already exist in the in the “User Accounts” and “PST Files” windows.

Next

Clicking the “Next” button presents the next step in the configuration.

2.2.Adding Users

Clicking the “Add” or “Edit” (when at least one account already exists) buttons on the main configuration screen presents an window (figure 9) from which details about the user account being added (or edited) may be entered.

Figure 9 – Configuration Window

IMAP Username

In the “IMAP Username” field enter the username for the email account to which the PST data is being exported.

IMAP Password

Enter the password for the email account to which the PST data is being exported, in the “IMAP Password” field.

Use Global Administrator Account

The “Use Global Administrator Account” feature allows server administrators with access to a global administrator account to export on behalf of any user on the server by using that user’s username in conjunction with the global administrator accounts user’s password.

Note: The “Use Global Administrator Account” feature is currently tested and supported only for users who are exporting PST files to a Bynari Server, and using the Bynari Server’s “manager” password as the global administrator account password.

Server AddressIn the “Server Address” field place the IP (Internet Protocol) address or fully qualified domain name of email server to which the data is to be exported.

Note: If you do not know the IP address or fully qualified domain name of the email server, it can be provided by the email server administrator.

Server Port

Enter the port number for the mail server in the “Server Port” field. Port 143 is the default value for this field.

Note: If you do not know the email server’s server port number, it can be provided by the email server administrator.

Use secured connection (SSL)

Place a check mark in the “Use secured connection (SSL)” checkbox if the email server requires a secured connection (SSL).

Note: If you are unsure whether or not the email server requires a secured connection, contact the email server administrator.

Note: Placing a check in the “Use secured connection (SSL)” checkbox will automatically change the Incoming Mail Port field to 993 (the default SSL port). If you are unsure the port required by the server for SSL, contact the email server administrator.

Test Account Settings

It is recommended that when account information is edited or entered for the first time that the account information is tested by clicking the “Test Account Settings” button before configuring additional accounts or proceeding to the next stage of the export process.

2.3.Adding PST Files

After adding a user and clicking the “Next” button a window (figure 10) from which you can to add one or more PST files to be exported for the user is presented.

Figure 10 Adding PST Files

PST Files

The “PST Files” window displays all PST files which have been added for the user.

Add

Clicking the “Add” button allows you to browse your computer for PST files to export.

Remove

Clicking on a PST file, to highlight it in the list, then clicking the “Remove” button will remove the selected PST file from the list.

Export Folder Type

In order to select which portion of a particular PST is to be exported, select the PST in the “PST Files” window, to highlight it within the list, then select from the “Export Folder Type” drop-down menu the portion of the PST file that you would like to have exported to the email server. The “Export Folder Type” drop-menu options are: “Inbox Folder Only”, “All Folders”, “All Calendars”, “All Contacts”, “All Tasks”, and “Select Folders”, which allows selecting one or more specific folders (including custom folders) from within the PST file.

Use global settings for folder type

Placing a check mark in the “Use global settings for folder type” checkbox allows you to use the menu to the right of the checkbox to make a single selection about which part of a PST file to export, and have that selection automatically applied to every PST file in the list.

Clicking the “Next” button presents a new window (figure 11) from which the Export task can be set to initiate immediately, or scheduled to run at a later time.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.4.Initiating the Export

Once at least one user has been added with at least one PST file added for that user, clicking the “Next” button will present the scheduling screen (figure 11). From this screen the export can be either initiated immediately, or scheduled for a later time.

Figure 11 Scheduling the Export

Schedule Name

The “Schedule Name” field can be populated with any name that you wish to use for identifying the export task, whether initiated immediately, or scheduled to run at a later time.

Run Now

Placing a check in the “Run Now” checkbox will disable all schedule-related settings and prepare ExportPST for immediate initialization of the configured export task.

Start Date

In the “Start Date” field select the date on which you would like to run the configured export task.

Start Time

In the “Start Time” field select the time at which you would like to run the configured export task.

Administrator Username

In the “Administrator Username” field, enter the username for any user with Administrator privileges on the computer where ExportPST is installed.

Administrator Password

In the “Administrator Password” field enter the password associated with the user whose username was entered in the “Administrator Username” field.

Previous

The “Previous” button presents the previous screen in the configuration (figure 10), where users and PST files can be added, edited and removed.

Next

Clicking the “Next” button presents a new window (figure 12) in which a list of scheduled exports can be viewed.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.5.Scheduled Exports

A window displaying scheduled exports (figure 12) is displayed when ExportPST first starts, if exports have been previously scheduled and are currently queued. This same window is also displayed following the configuration of a new export task.

Figure 12 Saved Schedules

Schedule Exports

The “Schedule Exports” window displays a list of the currently queued export tasks.

Schedule Details

The “Schedule Details” window provides detailed information about the currently scheduled exports.

Add

Clicking the “Add” button allows you to add a new schedule.

Edit

Clicking on a queued schedule, to highlight it in the list, then clicking the “Edit” button allows you to edit the selected schedule.

Remove

Clicking on a queued schedule, to highlight it in the list, then clicking the “Remove” button will remove the selected schedule from the queue.

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Previous

Clicking “Previous” returns you to the previous screen.

Save/Close

Clicking the “Save/Close” button will begin the export, if an export has been configured with the “Run Now” (section 2.4, Initiating the Export) option selected. If the “Run Now” option has not been selected for any currently queued export tasks, clicking the “Save/Close” button will close ExportPST, saving all configuration and schedule information.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

3.Log Settings

Clicking the “Log Settings” button on the main ExportPST configuration window provides access to the various ExportPST log-related features.

Figure 13 Log Settings

Log File

In the “Log File” field choose the desired log file name and location by entering a complete path to the file (including the filename). The browse button may also be used to select a location for the log file. The example in figure 13 creates a log file named “SampleLog.log” and places it in the top level of the C drive.

Maximum log size

The “Maximum Log Size” drop-down menu provides six options for controlling the size of the logs generated by ExportPST.

The six different log size options are:

None

100kb

200kb

300kb

400kb

500kb

Selecting “None” from the “Maximum Log Size” drop-down menu will place no restrictions on the maximum size of the log file.

Log level

The “Log Level” drop-down menu provides a choice between writing all ExportPST activity to the log, or writing only error-related activity to the log.

OK

Clicking the “OK” button will close the log configuration window, and save all changes.

Cancel

Clicking the “Cancel” button will close the log configuration window without saving any changes.

4.Product Registration

4.1.Demo Mode

Export PST will operate in “Demo” mode until registered. “Demo” mode provides an opportunity to try ExportPST before making the decision to purchase. ExportPST is fully functional when in “Demo” mode, with the following exceptions.

The options in the “Export Folder Type” drop-down menu are limited to “All Folders”, “Inbox Folder Only”, “All Calendars”, and “All Contacts” when Export PST is used in demo mode.

When “All Folders” is chosen from the “Export Folder Type” drop-down menu, the export is limited to 15 items. In Demo mode selecting “All Folders” will export PST data from the Inbox, Calendars and Contacts folders only.

When “Inbox Folder Only”, “All Calendars”, or “All Contacts” is chosen in the “Export Folder Type” drop-down menu, the export is limited to five items, while running in demo mode.

4.2.Registering ExportPST

There are no restrictions placed on fully registered ExportPST installations. Product registration information is accessed through the ExportPST “About” window. The “About” window can be displayed by clicking the “About” button on the main ExportPST configuration window.

Figure 14 About ExportPST

Clicking the “About” window’s “License” button displays detailed license and registration information, as well as providing an opportunity to register a previously unregistered copy of ExportPST.

Figure 15 Entering Product License Key

Enter your product license key

An ExportPST license key will be provided at the time of purchase. The license key enables the full functionality of ExportPST. The license key must be entered into the “Enter your product license key” field in order to register ExportPST.

Manual Registration

For systems with limited or no Internet access it may be necessary to register ExportPST manually. In order manually register ExportPST you must request a PGP signed certificate from a Bynari representative. Placing a check in the “Manual Registration” checkbox allows access to the “Enter the license certificate below” field, where the PGP signed certificate can be entered.

Note: Manual registration requires both a license key and a PGP signed certificate.

Which port would you like to use to register?

The “Which port would you like to use to register” drop-down menu provides a choice between port 80 and port 3080 for connecting to the Bynari registration server to register ExportPST. The default setting is 80, which is the best choice for most installations. If the system on which ExportPST is installed is unable to connect to the Bynari registration server on either port 80 or 3080, it will be necessary to register manually.

OK

Once the license key (and the PGP signed certificate, if required) has been entered and the registration port has been selected, clicking the “OK” button on the license window will initiate the ExportPST registration.

Cancel

Clicking the “Cancel” button on the license window will close the window, making no attempt to register ExportPST.

Once registered, ExportPST will display the following information in the license window.

The license key used to register ExportPST

The date, if any, on which the license expires

The number of licenses currently in use

The total number of licenses provided for use by the license key

The versions of ExportPST supported by the license

Supported, special, additional options provided by the license

Once the registered, the license window will also display the following button changes.

Refresh

If changes are made to the license information, clicking the “Refresh” button will display the changes immediately. Otherwise the changes will be displayed after ExportPST is closed and reopened.

Unregister

Clicking the “Unregister” button will remove the ExportPST registration and disable all features other than starting and re-registering the software.

OK

Clicking the “OK” button will close the license window.

Figure 16 Registered

5 Reporting Problems

Be sure to include the following information when reporting problems to Bynari:

The Microsoft Windows version number and patch level.

The Microsoft Windows version number and patch level are obtained by right-clicking on the “My Computer” icon on the “Desktop” (or in the “Start” menu) and selecting “Properties” from the pop-up menu.

In Windows 7/Vista, the Windows version and patch level will be listed in the “System” section of this window.

In Windows XP, the Windows version and patch level will be listed under “System” on the “General” tab of this window.

The full version number of ExportPST.

The Bynari ExportPST full version number is obtained by clicking the “About” button on the main configuration window.

Overview

ExportPST exports Microsoft Personal Storage Table (PST) files to IMAP servers. This simplifies the process of migrating between PST files, and from one email server to another. Single or multiple PST files can be exported for a single or multiple users. Export tasks can be configured to run immediately, or scheduled to run at a later time.

1.Installation

Once the installation file has been downloaded, extract the installer from within the .zip file. After the installer has been extracted from the .zip file, double-click on the Installer’s icon to begin the installation process.

Figure 1- Installer Icon

Welcome

On the installer’s Welcome screen, click the “Next” button to begin the installation.

Figure 2 – Welcome

License Agreement

If you choose to accept the terms of the license agreement, select the “I accept the agreement” radio button then click the “Next” button. If you choose not to accept the terms of the agreement, the installation will be cancelled.

Figure 3 – License Agreement

Select Destination Location

On the “Select Destination Location” window, select the folder in which you would like to install ExportPST. In most situations, selecting the default location is recommended.

Once the installation location has been selected, click the “Next” button.

Figure 4 – Select Destination Location

Select Start Menu Folder

On the “Select Start Menu Folder” window, select the location of the ExportPST Start Menu folder. In most situations, selecting the default location is recommended.

Once the location for the Start Menu folder has been selected, click the “Next” button.

Figure 5 – Start Menu Folder

Ready to Install

On the “Ready to Install” screen, click the “Install” button to begin installing ExportPST on your computer.

Figure 6 – Ready to Install

Installation Complete

On the final screen of the installation, click the “Finish” button to complete the process. Placing a check in the “Run Export PST” checkbox will start ExportPST immediately after clicking the “Finish” button.

Figure 7 – Installation Complete

The installation is complete. ExportPST can now be opened by selecting its icon in the Windows Start menu.

2.Exporting Email Data

2.1.Getting Started

After ExportPST is launched, the main configuration window (figure 8) is presented. From here one or more user accounts can be added, edited or removed. From this window PST files can also be modified, previously configured export schedules can be accessed, and information about the ExportPST installation can be viewed.

The “User Accounts” window displays a list of all user accounts currently configured.

PST Files

The “PST Files” window displays a list of all PST files which have been added for whichever user has been selected, and is currently highlighted in the “User Accounts” window.

Add

Clicking the “Add” button allows the user to browse for and select both user accounts and their associated PST files for export to the server. Files may be selected from either the user’s local system, or a network share.

Edit

Clicking on a user account, to highlight it in the list, then clicking the “Edit” button will allow editing of the configuration information related to that user.

Remove

The “Remove” button is used to remove user accounts by clicking on the desired user account, to highlight it in the list, then clicking the “Remove” button.

Modify

The “Modify” button is used to make changes to PST data intended for export. The PST data is modified by clicking on the PST file, to highlight it in the list, then clicking the “Modify” button. Changes that can be made include selecting only certain mail folders for export rather than exporting all of the email data contained within the PST file.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Exit

Clicking the “Exit” button will close ExportPST without exporting any PST data to the server.

Previous

The “Previous” button takes the user to the previous screen in the configuration. The “Previous” button is only accessible when user accounts and PST files from a previous session already exist in the in the “User Accounts” and “PST Files” windows.

Next

Clicking the “Next” button presents the next step in the configuration.

2.2.Adding Users

Clicking the “Add” or “Edit” (when at least one account already exists) buttons on the main configuration screen presents an window (figure 9) from which details about the user account being added (or edited) may be entered.

Figure 9 – Configuration Window

IMAP Username

In the “IMAP Username” field enter the username for the email account to which the PST data is being exported.

IMAP Password

Enter the password for the email account to which the PST data is being exported, in the “IMAP Password” field.

Use Global Administrator Account

The “Use Global Administrator Account” feature allows server administrators with access to a global administrator account to export on behalf of any user on the server by using that user’s username in conjunction with the global administrator accounts user’s password.

Note: The “Use Global Administrator Account” feature is currently tested and supported only for users who are exporting PST files to a Bynari Server, and using the Bynari Server’s “manager” password as the global administrator account password.

Server AddressIn the “Server Address” field place the IP (Internet Protocol) address or fully qualified domain name of email server to which the data is to be exported.

Note: If you do not know the IP address or fully qualified domain name of the email server, it can be provided by the email server administrator.

Server Port

Enter the port number for the mail server in the “Server Port” field. Port 143 is the default value for this field.

Note: If you do not know the email server’s server port number, it can be provided by the email server administrator.

Use secured connection (SSL)

Place a check mark in the “Use secured connection (SSL)” checkbox if the email server requires a secured connection (SSL).

Note: If you are unsure whether or not the email server requires a secured connection, contact the email server administrator.

Note: Placing a check in the “Use secured connection (SSL)” checkbox will automatically change the Incoming Mail Port field to 993 (the default SSL port). If you are unsure the port required by the server for SSL, contact the email server administrator.

Test Account Settings

It is recommended that when account information is edited or entered for the first time that the account information is tested by clicking the “Test Account Settings” button before configuring additional accounts or proceeding to the next stage of the export process.

2.3.Adding PST Files

After adding a user and clicking the “Next” button a window (figure 10) from which you can to add one or more PST files to be exported for the user is presented.

Figure 10 Adding PST Files

PST Files

The “PST Files” window displays all PST files which have been added for the user.

Add

Clicking the “Add” button allows you to browse your computer for PST files to export.

Remove

Clicking on a PST file, to highlight it in the list, then clicking the “Remove” button will remove the selected PST file from the list.

Export Folder Type

In order to select which portion of a particular PST is to be exported, select the PST in the “PST Files” window, to highlight it within the list, then select from the “Export Folder Type” drop-down menu the portion of the PST file that you would like to have exported to the email server. The “Export Folder Type” drop-menu options are: “Inbox Folder Only”, “All Folders”, “All Calendars”, “All Contacts”, “All Tasks”, and “Select Folders”, which allows selecting one or more specific folders (including custom folders) from within the PST file.

Use global settings for folder type

Placing a check mark in the “Use global settings for folder type” checkbox allows you to use the menu to the right of the checkbox to make a single selection about which part of a PST file to export, and have that selection automatically applied to every PST file in the list.

Clicking the “Next” button presents a new window (figure 11) from which the Export task can be set to initiate immediately, or scheduled to run at a later time.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.4.Initiating the Export

Once at least one user has been added with at least one PST file added for that user, clicking the “Next” button will present the scheduling screen (figure 11). From this screen the export can be either initiated immediately, or scheduled for a later time.

Figure 11 Scheduling the Export

Schedule Name

The “Schedule Name” field can be populated with any name that you wish to use for identifying the export task, whether initiated immediately, or scheduled to run at a later time.

Run Now

Placing a check in the “Run Now” checkbox will disable all schedule-related settings and prepare ExportPST for immediate initialization of the configured export task.

Start Date

In the “Start Date” field select the date on which you would like to run the configured export task.

Start Time

In the “Start Time” field select the time at which you would like to run the configured export task.

Administrator Username

In the “Administrator Username” field, enter the username for any user with Administrator privileges on the computer where ExportPST is installed.

Administrator Password

In the “Administrator Password” field enter the password associated with the user whose username was entered in the “Administrator Username” field.

Previous

The “Previous” button presents the previous screen in the configuration (figure 10), where users and PST files can be added, edited and removed.

Next

Clicking the “Next” button presents a new window (figure 12) in which a list of scheduled exports can be viewed.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

About

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

2.5.Scheduled Exports

A window displaying scheduled exports (figure 12) is displayed when ExportPST first starts, if exports have been previously scheduled and are currently queued. This same window is also displayed following the configuration of a new export task.

Figure 12 Saved Schedules

Schedule Exports

The “Schedule Exports” window displays a list of the currently queued export tasks.

Schedule Details

The “Schedule Details” window provides detailed information about the currently scheduled exports.

Add

Clicking the “Add” button allows you to add a new schedule.

Edit

Clicking on a queued schedule, to highlight it in the list, then clicking the “Edit” button allows you to edit the selected schedule.

Remove

Clicking on a queued schedule, to highlight it in the list, then clicking the “Remove” button will remove the selected schedule from the queue.

Clicking the “About” button presents a screen with basic information about ExportPST, as well as access to the software registration information (section 4, Product Registration).

Previous

Clicking “Previous” returns you to the previous screen.

Save/Close

Clicking the “Save/Close” button will begin the export, if an export has been configured with the “Run Now” (section 2.4, Initiating the Export) option selected. If the “Run Now” option has not been selected for any currently queued export tasks, clicking the “Save/Close” button will close ExportPST, saving all configuration and schedule information.

Exit

Clicking the “Exit” button will exit the program, discarding all settings.

3.Log Settings

Clicking the “Log Settings” button on the main ExportPST configuration window provides access to the various ExportPST log-related features.

Figure 13 Log Settings

Log File

In the “Log File” field choose the desired log file name and location by entering a complete path to the file (including the filename). The browse button may also be used to select a location for the log file. The example in figure 13 creates a log file named “SampleLog.log” and places it in the top level of the C drive.

Maximum log size

The “Maximum Log Size” drop-down menu provides six options for controlling the size of the logs generated by ExportPST.

The six different log size options are:

None

100kb

200kb

300kb

400kb

500kb

Selecting “None” from the “Maximum Log Size” drop-down menu will place no restrictions on the maximum size of the log file.

Log level

The “Log Level” drop-down menu provides a choice between writing all ExportPST activity to the log, or writing only error-related activity to the log.

OK

Clicking the “OK” button will close the log configuration window, and save all changes.

Cancel

Clicking the “Cancel” button will close the log configuration window without saving any changes.

4.Product Registration

4.1.Demo Mode

Export PST will operate in “Demo” mode until registered. “Demo” mode provides an opportunity to try ExportPST before making the decision to purchase. ExportPST is fully functional when in “Demo” mode, with the following exceptions.

The options in the “Export Folder Type” drop-down menu are limited to “All Folders”, “Inbox Folder Only”, “All Calendars”, and “All Contacts” when Export PST is used in demo mode.

When “All Folders” is chosen from the “Export Folder Type” drop-down menu, the export is limited to 15 items. In Demo mode selecting “All Folders” will export PST data from the Inbox, Calendars and Contacts folders only.

When “Inbox Folder Only”, “All Calendars”, or “All Contacts” is chosen in the “Export Folder Type” drop-down menu, the export is limited to five items, while running in demo mode.

4.2.Registering ExportPST

There are no restrictions placed on fully registered ExportPST installations. Product registration information is accessed through the ExportPST “About” window. The “About” window can be displayed by clicking the “About” button on the main ExportPST configuration window.

Figure 14 About ExportPST

Clicking the “About” window’s “License” button displays detailed license and registration information, as well as providing an opportunity to register a previously unregistered copy of ExportPST.

Figure 15 Entering Product License Key

Enter your product license key

An ExportPST license key will be provided at the time of purchase. The license key enables the full functionality of ExportPST. The license key must be entered into the “Enter your product license key” field in order to register ExportPST.

Manual Registration

For systems with limited or no Internet access it may be necessary to register ExportPST manually. In order manually register ExportPST you must request a PGP signed certificate from a Bynari representative. Placing a check in the “Manual Registration” checkbox allows access to the “Enter the license certificate below” field, where the PGP signed certificate can be entered.

Note: Manual registration requires both a license key and a PGP signed certificate.

Which port would you like to use to register?

The “Which port would you like to use to register” drop-down menu provides a choice between port 80 and port 3080 for connecting to the Bynari registration server to register ExportPST. The default setting is 80, which is the best choice for most installations. If the system on which ExportPST is installed is unable to connect to the Bynari registration server on either port 80 or 3080, it will be necessary to register manually.

OK

Once the license key (and the PGP signed certificate, if required) has been entered and the registration port has been selected, clicking the “OK” button on the license window will initiate the ExportPST registration.

Cancel

Clicking the “Cancel” button on the license window will close the window, making no attempt to register ExportPST.

Once registered, ExportPST will display the following information in the license window.

The license key used to register ExportPST

The date, if any, on which the license expires

The number of licenses currently in use

The total number of licenses provided for use by the license key

The versions of ExportPST supported by the license

Supported, special, additional options provided by the license

Once the registered, the license window will also display the following button changes.

Refresh

If changes are made to the license information, clicking the “Refresh” button will display the changes immediately. Otherwise the changes will be displayed after ExportPST is closed and reopened.

Unregister

Clicking the “Unregister” button will remove the ExportPST registration and disable all features other than starting and re-registering the software.

OK

Clicking the “OK” button will close the license window.

Figure 16 Registered

5 Reporting Problems

Be sure to include the following information when reporting problems to Bynari:

The Microsoft Windows version number and patch level.

The Microsoft Windows version number and patch level are obtained by right-clicking on the “My Computer” icon on the “Desktop” (or in the “Start” menu) and selecting “Properties” from the pop-up menu.

In Windows 7/Vista, the Windows version and patch level will be listed in the “System” section of this window.

In Windows XP, the Windows version and patch level will be listed under “System” on the “General” tab of this window.

The full version number of ExportPST.

The Bynari ExportPST full version number is obtained by clicking the “About” button on the main configuration window.