Client Profile Updating Utility 4.3 Administrator Guide

© 2010 Quest Software, Inc. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written permission of Quest Software, Inc. The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document. If you have any questions regarding your potential use of this material, contact: Quest Software World Headquarters LEGAL Dept 5 Polaris Way Aliso Viejo, CA 92656 e-mail: [email protected] Refer to our Web site (www.quest.com) for regional and international office information.

TRADEMARKS AccessManager, Active Administrator, ActiveDL, ActiveGroups, ActiveRoles, AKONIX, Benchmark Factory, Big Brother, BOX & WAVE Design, BridgeAccess, BridgeAutoEscalate, BridgeSearch, BridgeTrak, ChangeAuditor, ChangeManager, CI Discovery, DataFactory, Defender, Deploy the Whole Desktop, Desktop Authority, Directory Analyzer, DirectoryExpert, DS Analyzer, DS Expert, Embargo, Enterprise Security Explorer, Enterprise Security Reporter, File System Auditor, Foglight, GPOAdmin, Help Desk Authority, InstantAssist , IntelliProfile, InTrust, iToken, J.CLASS and Design, JClass, Jint, JProbe, Kemma Software, Knowledge Xpert and Design, LiteSpeed, LiveReorg, LogAdmin, MessageStats, Move Mailbox Manager, MultSess, NBSpool, NetBase, NETPRO, PASSGO, PassGo Technologies (and design), Password Reset Manager, Patch Authority, PerformaSure, POINT, CLICK, DONE!, PowerGUI, Privilege Authority, Q.DESIGNER and Design, Quest, Quest Central, Quest Software, Quest Software and Design, Quest Software logo, ReportAdmin, RestoreAdmin, SCRIPTLOGIC, SCRIPTLOGIC (and Design), Secure Copy, Security Explorer, Security Lifecycle Map, SelfServiceAdmin, SharePlex, Spotlight, SQL Navigator, SQL TURBO, SQL TURBO and Design, SQL Watch, SQLAB, STAT, StealthCollect, T.O.A.D, Tag and Follow, TOAD, TOAD WORLD, vAutomator, vConverter, vEcoShell, VESI, vFoglight, VINTELA, VIZIONCORE, Vizioncore Automation Suite, Vizioncore vEssentials, vMigrator, vRanger, vSpotlight, vToad, WebDefender, Webthority, XRT are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries. For a complete list of Quest Software’s trademarks, please see http://www.quest.com/legal/trademark-information.aspx . Other trademarks and registered trademarks are property of their respective owners. Client Profile Updating Utility Updated – May 7, 2010 Software version – 4.3

CONTENTS Overview..................................................................................................................... 3 Terminology Used.............................................................................................................. 3 Configuring and Running the Client Profile Updating Utility ............................................. 4 Supported Configurations.................................................................................................. 4

What the Utility Updates ........................................................................................... 5 Modes ......................................................................................................................... 9 Update ............................................................................................................................... 9 Cache Target Exchange Address Lists ............................................................................. 9 Creating a Cache File .............................................................................................. 10 Rollback ........................................................................................................................... 10 Cleanup............................................................................................................................ 10

Usage ........................................................................................................................ 11 Location ........................................................................................................................... 11 Typical Scenario .............................................................................................................. 11 1. Create a Batch File .............................................................................................. 11 2. Create a Cache File (Optional)............................................................................ 13 3. Add the Batch File to the Logon Script................................................................ 14 4. Switch Mailboxes ................................................................................................. 15 5. Update Profiles .................................................................................................... 15 6. Cleanup................................................................................................................ 15 Updating Microsoft Outlook Offline Profiles .................................................................... 16 Using a Dial-Up Connection While Updating Profiles ..................................................... 17 Setting RPC over HTTP Access...................................................................................... 18

Updating Resource Mailboxes ............................................................................... 19 Overview .......................................................................................................................... 19 System Requirements ..................................................................................................... 20 Usage............................................................................................................................... 20 Command Line Syntax ............................................................................................ 20 Parameters .............................................................................................................. 20 Example ................................................................................................................... 21 Batch File Syntax ..................................................................................................... 21 Credentials............................................................................................................... 22

Troubleshooting ...................................................................................................... 23 Restoring OST Files ........................................................................................................ 23 Rolling Back Changes ..................................................................................................... 23 Before You Call Support.................................................................................................. 24

Technical Reference ............................................................................................... 25 Notification File Format.................................................................................................... 25 File Format............................................................................................................... 25 Variables .................................................................................................................. 26 Command-Line Parameters ............................................................................................ 26 Critical Functionalities...................................................................................................... 32 EMWProf Return Codes .................................................................................................. 32

i

About Quest Software, Inc. .................................................................................... 34 Contacting Quest Software.............................................................................................. 34 Contacting Quest Support ............................................................................................... 34

Third Party Contributions....................................................................................... 35 Boost 1.0 License Agreement ......................................................................................... 35 Loki 0.1.4 License Agreement ................................................................................. 35 Loki 0.1.6 License Agreement ................................................................................. 36 ZLib 1.1.4 License Agreement ........................................................................................ 36

ii

Administrator Guide

Overview During migration, Quest® Migration Manager™ for Exchange and Quest Exchange Migration Wizard™ switch mailboxes from the source Exchange server to the target Exchange server. Before users can start working with the new target mailbox, their Microsoft Outlook profiles must also be updated. The Client Profile Updating Utility (EMWProf) allows you to update these profiles automatically and transparently. The utility is used for updating end-user Microsoft Outlook profiles from the source to the target Exchange server once the user mailbox is migrated and switched either manually or by the Mail Agent. The Client Profile Updating Utility supports migration from Exchange 5.5 and Exchange 2000/2003/2007 to Exchange 2000/2003/2007/2010. It can be used in conjunction with the following Quest products: • •

Quest Migration Manager for Exchange 4.0 or later Quest Exchange Migration Wizard 3.1 or later

Terminology Used Throughout this document, the following terms are used: Source servers: the Exchange servers from which the messaging system is migrated Target servers: the servers to which the system is migrated Console: the computer on which Migration Manager for Exchange or Exchange Migration Wizard is installed Hereafter, unless a specific Exchange version is meant, "Exchange" denotes Exchange 2000, Exchange 2003, Exchange 2007, and Exchange 2010 organizations, servers, mailboxes, and so on.

3

Client Profile Updating Utility 4.3

Configuring and Running the Client Profile Updating Utility To configure the Client Profile Updating Utility, create a batch file for it using the EMWProf Configuration Wizard. Include the resulting batch file in the logon script for the domain users. Then, when a user logs on to the network, the Client Profile Updating Utility starts automatically on his or her workstation with the configuration saved in the batch file. On a workstation, the Client Profile Updating Utility processes all the Microsoft Outlook user profiles that you selected to be processed when you configured the batch file. A profile is processed whether or not it is set as the default for Microsoft Outlook. When updating Microsoft Outlook profiles, the Client Profile Updating Utility looks for a correspondence between the source and target recipients, using the custom attribute populated by the Directory Synchronization Agent. The Client Profile Updating Utility will not start if Microsoft Outlook or other MAPI clients are running. Please close all such applications before starting the utility.

Offline Microsoft Outlook profiles are updated according to the settings you made when you configured the batch file for the Client Profile Updating Utility. The Client Profile Updating Utility can process either all offline profiles or only the profiles for the remote users whose mailboxes were added to Remote Users Collections. For information about Remote Users Collections, refer to the Migration Manager for Exchange or Exchange Migration Wizard documentation.

Supported Configurations The Client Profile Updating Utility supports the vast majority of client computer configurations. Specifically, all mail clients and operating systems listed below are supported in any valid combinations.

Mail Clients • • • •

Microsoft Outlook 2000 Microsoft Outlook XP Microsoft Outlook 2003 Microsoft Outlook 2007

Operating Systems • • • •

4

Microsoft Windows 2000 Microsoft Windows XP Microsoft Windows 2003 Microsoft Windows Vista

Administrator Guide

What the Utility Updates The Client Profile Updating Utility updates the profile settings, and also finalizes mailbox migration by migrating additional features of user mailboxes. Additional features are specific custom settings of a particular user mailbox and its environment. Additional features include sets of services, groups of settings, Microsoft Outlook controls, and links to the mailbox objects, public folders, Global Address List, and so on. Specifically, while updating a profile, the Client Profile Updating Utility also updates the following additional features: Microsoft Outlook Bar Shortcuts User-defined shortcuts added to the Microsoft Outlook Bar are automatically updated to remain valid in the user’s new mailbox. The shortcuts to any folders are updated, including folders located in the mailbox, personal folders (PST) files, or public folders. Other Users' Folder Shortcuts The shortcuts to folders for which the File | Open | Other User’s Folder operation has been performed are automatically updated to remain valid in the user’s new mailbox. Move to Folder Shortcuts The shortcuts to folders for which the Edit | Move to Folder operation has been performed are automatically updated to remain valid in the user’s new mailbox. Outlook Wunder Bar User-defined shortcuts created in Microsoft Outlook 2003 and later are automatically updated to remain valid in the user’s new mailbox. The shortcuts to any folders are updated, including folders located in the mailbox, personal folders (PST) files, or public folders. Junk E-mail Sender Lists All settings related to junk e-mail are updated for each profile. The Client Profile Updating Utility preserves the junk e-mail sender lists. Adult E-mail Sender Lists All settings related to adult content senders are updated for each profile. The Client Profile Updating Utility preserves the adult content sender lists.

5

Client Profile Updating Utility 4.3

Group Schedules Members of the user-created group schedules are updated according to the Address Lists in the new environment. User can continue to see the group’s free/busy information and schedule meetings after the migration. Folder Groups for Contact Activities In Microsoft Outlook, the Activities tab of any contact folder shows an overview of all the other items related to that contact. By default, Microsoft Outlook searches for links to items only in the main Microsoft Outlook folders, such as Calendar, Contacts, and so on. The Client Profile Updating Utility updates any additional folder groups defined by the user. Microsoft Outlook Address Book The Client Profile Updating Utility updates the Microsoft Outlook Address Book service in the new target mailbox profile so that the user can work with address books after the update. Personal Address Book The utility searches the Personal Address Book for links to source server GAL recipients and distribution lists and replaces them with links to target server GAL recipients and distribution lists. Offline Address Book Offline Address Book processing consists in backup or recovery of files containing information about the Offline Address Book. Profile Properties and Logon Network Settings The Client Profile Updating Utility preserves all profile settings, including the order of services and address lists, Logon Network Security settings, and connection type. Rules The Client Profile Updating Utility copies to the target mailbox all the rules created by the Rules Wizard and by the Out of Office Assistant for the source mailbox. Delegates If a user selects delegates to send mail on his or her behalf using the Tools | Options dialog box (the Delegates tab), the migration of these settings will be performed by the Exchange Migration Wizard agents and finalized by the Client Profile Updating Utility. Net Folder Subscribers During migration of Net Folders, the Client Profile Updating Utility updates Net Folder subscribers. This additional feature is available in Outlook 2000 and previous versions; it allows users to subscribe to updates of the folder, including the user's personal store. After the migration process has been completed, a request to re-subscribe is sent to all folder subscribers. 6

Administrator Guide

Additional Mailboxes The Client Profile Updating Utility updates links to additional mailboxes in the target profile. Read/Unread Status The read/unread status of the mailbox messages is updated by the Client Profile Updating Utility. User-Defined Folder Names If a user has defined new names for the mailbox, additional mailboxes, the Public Folders folder, the Favorites folder, or the All Public Folders folder, these names will be updated. Folder Views The Client Profile Updating Utility updates such current view settings of the folder as Filters and Automatic Formatting. Search Folders Microsoft Outlook search folders are copied to the target mailbox with all their settings. The target search folders are created as not active. To activate a folder, click on it. Send/Receive Settings The Client Profile Updating Utility preserves users' Send/Receive settings in their target mailboxes. Public Folder Favorites The Client Profile Updating Utility preserves public folder favorites that are included in the profile. The Client Profile Updating Utility will not preserve public folder favorites if the mailbox was migrated in a Remote Users Collection and the Outlook profile uses an OST file. Distribution Lists The Client Profile Updating Utility updates distribution lists in Microsoft Outlook address book folders and restores links to recipients and other distribution lists for the target mailbox profile. Contact Nicknames Contact nicknames are used in Microsoft Outlook XP and higher to speed up searching of contacts typed into the To, CC or BCC fields. The Client Profile Updating Utility preserves information about nicknames in target profile after the profile switch.

7

Client Profile Updating Utility 4.3

RSS Feeds RSS Feeds are available in Microsoft Outlook 2007 only. The Client Profile Updating Utility preserves RSS Feeds configured in source mailbox after the profile switch. Microsoft Outlook Favorites This additional feature is available only in Outlook 97/98/2000/XP. Information about Outlook Favorites as links to the processed objects sorted by groups is preserved by the Client Profile Updating Utility.

8

Administrator Guide

Modes The Client Profile Updating Utility can work in any of the modes described below. You select the mode when you run the EMWProf Configuration Wizard to create the batch file for processing your profiles. Alternatively, you can run the Client Profile Updating Utility from the command line using the appropriate command-line parameters to specify the mode. For details, refer to the Modes and Command-Line Parameters sections of this guide.

Update If this mode is selected, direct profile switch without using a cache file will be performed. This is the only mode available if you update profiles for mailboxes migrated by Migration Manager, and it is the recommended mode if you are migrating from Exchange 5.5 with Exchange Migration Wizard. The Client Profile Updating Utility updates all the profile settings associated with the Exchange server. When updating Microsoft Outlook profiles, the utility looks for correspondence between the source and target recipients.

Cache Target Exchange Address Lists If this mode is selected, profiles will be updated using a cache file created in accordance with the Global Address List. This mode is available only if you use the Client Profile Updating Utility in conjunction with Exchange Migration Wizard. If many mailboxes are switched at the same time and therefore many client profiles are simultaneously updated by the Client Profile Updating Utility, the load on the Global Catalog server might increase, although improvements to recent versions of Migration Manager have significantly reduced the load on the Global Catalog during profile update. If you want to avoid this increased load, you can update the profiles using a cache file. The cache file contains the information used to match the Exchange address list objects. Using a cache file improves the performance of the Client Profile Updating Utility and minimizes the Global Catalog server load. If you plan to use a cache file during profile update, configure the Client Profile Updating Utility to create it when you run the EMWProf Configuration Wizard.

9

Client Profile Updating Utility 4.3

Creating a Cache File If you plan to use a cache file during profile update, configure the Client Profile Updating Utility to create it when you run the EMWProf Configuration Wizard. The Configuration Wizard creates a batch file containing the parameters that force the Client Profile Updating Utility to create a cache file. If you want the cache file to be updated from time to time so that it contains the actual information about the address books, schedule the batch file created by the EMWProf Configuration Wizard to be executed as often as the cache file should be updated. It is recommended that the batch file be scheduled to be executed during off hours in order to decrease the network load and to avoid running it simultaneously with the Client Profile Updating Utility.

Rollback The changes made by the Client Profile Updating Utility to the Microsoft Outlook profiles can be rolled back. This mode should be used for advanced troubleshooting in the following situations: • •

If any issues occurred during profile processing by the Client Profile Updating Utility. If a user experiences problems while working with the new Exchange mailbox after the switch. In this case, first switch the mailbox back to the source Exchange server, and then roll back the changes made to its profiles.

Cleanup All the auxiliary and backup information saved by the Client Profile Updating Utility during update can be cleaned up. This mode should be selected only after all the profiles have been successfully updated and no rollback is required. The rollback operation will be impossible after the Client Profile Updating Utility cleans up the backup information.

10

Administrator Guide

Usage Location By default, the utility is installed in the %Program Files%\Quest Software\Profile Updating Utility folder. If Exchange Migration Wizard is installed on the computer where you run Client Profile Updating Utility setup, the utility will be installed in the %Program Files%\Quest Software\Exchange Migration Wizard\Resource Kit\EMWProf folder. The EMWProf Configuration Wizard is always installed in the same folder as the Client Profile Updating Utility.

Typical Scenario It is recommended that all the preparations needed for updating client mailbox profiles be made before the mailboxes are switched to the target Exchange server by the Mail Agent. The typical procedure for switching the mailboxes and updating client profiles is described below:

1. Create a Batch File To configure the Client Profile Updating Utility to process the Microsoft Outlook profiles, perform the following steps: 1. 2.

3. 4.

Run the EMWProf Configuration Wizard. If you install and run the wizard on a console computer, it will automatically detect the product version you are using. If you run the wizard on a different computer, select whether you are configuring the Client Profile Updating Utility to work with Migration Manager or Exchange Migration Wizard. Select the Update option on the Select Action page of the wizard. Make the following choices: • Specify the account or accounts under which the Client Profile Updating Utility will log on to the profiles. It can be either the account of the user in whose logon script EMWProf.exe is included, an administrative account that allows the Client Profile Updating Utility to log on to both source and target Exchange mailboxes, or two accounts: one for the source mailbox and another for the target mailbox (if trust relationships are not established between the source and target domains). Alternatively, you can force the Client Profile Updating Utility to prompt the user for credentials to log on to each of the mailboxes. • Select the profiles to be updated by the Client Profile Updating Utility. You can choose to process all the profiles or select particular profiles. 11

Client Profile Updating Utility 4.3

• If you want the Client Profile Updating Utility to process offline Outlook profiles, select whether the offline profiles should be processed always or only when the OST file can be kept. For more information about processing offline profiles, please refer to the Updating Microsoft Outlook Offline Profiles section of this document.

5.

If you are using the Client Profile Updating Utility with Exchange Migration Wizard, specify the source custom attribute (CA) to be used for searching the Exchange address lists on all the source servers. By default, CA-13 is used for this purpose. By default, the Client Profile Updating Utility skips a profile if any services other than the default are configured. You can configure it to update profiles with non-default services, which will be copied as-is and might need to be reconfigured in the updated profiles. For more information, please refer to the EMWProf Configuration Wizard online help. When used with Migration Manager, the Client Profile Updating Utility can be optimized for slow and unreliable dial-up connections. With this option, the Client Profile Updating Utility will update most of the profile information but will skip the time-consuming operations, including read/unread message status synchronization and Outlook naming cache update. If you are going to use a cache file for Exchange Migration Wizard, specify its name. For more information, please refer to the Create a Cache File section below.

6.

Specify whether you want to receive email notifications about the results of the profile update by. Configure the following settings for the notification: • Select whether a notification should be send each time a profile is updated or only when the Client Profile Updating Utility could not update a profile. • Specify an e-mail address or addresses to which the notifications should be sent. • Select what information should be attached to the notification. You can select to attach a summary or a full log file. If you choose not to include any attachments, the necessary short information will still be included in the subject and body of the notification message (if you do not change the default templates). By default the subject and the body of the notification message contain the following information:

Subject: %R: Profile %P on computer %H Body: The mail client profile %P for user %U on computer %H has been processed by EMW Client Profile Updating Utility (EMWProf), and was %R. The profile was processed at %T, %D. See the EMWProf log file for details. The variables mean the following: VARIABLE

MEANING

%R

UPDATED or NOT UPDATED

%P

Name of the profile

%H

Name of the computer where the profile was updated

%U

Name of the user whose profile was updated

%T

Time of the profile update

%D

Date of the profile update

For more information about the format of the notification message, refer to the Technical Reference section of this document. 12

Administrator Guide

7. 8.

Configure the HTTP connection settings. Specify a name for the Client Profile Updating Utility log file that will help you to find useful information during troubleshooting. Select whether to add the current time, date, and client computer name to the log file name to prevent the log file from being overwritten each time the Client Profile Updating Utility is started. Alternatively, you can use the existing environment variable values to form the Client Profile Updating Utility log file name. For example, you can add the logged-in username to the name of the log file by typing the following expression in the Log file field: %username%_EMWProf.log The %username% parameter will be replaced with the real user name in whose security context the Client Profile Updating Utility was started. It is also recommended that you configure the Client Profile Updating Utility to put log files in a network share, where these files will be accessible by administrators. In this case, use the UNC path syntax to specify the log file name, for example: \\Servername\Sharename\%username%_EMWProf.log Note that users must be granted at least Write permission to put Client Profile Updating Utility log files in the share. Select the appropriate logging level. The Extended and Advanced logging levels are recommended for troubleshooting only. If you do not want the Client Profile Updating Utility to display a progress bar showing what action it is currently performing, select the Do not display progress bar and warnings to users check box. Note that the most critical warnings will be displayed even if the check box is selected. For example, if you force the Client Profile Updating Utility to prompt for credentials, the dialog box for entering credentials will be displayed.

9. Specify a name for the batch file and click Finish. 10. The wizard will create a batch file with the parameters you indicated. This batch file will be used to start the Client Profile Updating Utility in order to update profiles.

2. Create a Cache File (Optional) This step is relevant only if you are using the Client Profile Updating Utility in conjunction with Exchange Migration Wizard. For updating profiles, the Client Profile Updating Utility searches for the correspondence between the source and target users. If many mailboxes are switched at the same time and therefore many client profiles are simultaneously updated by the Client Profile Updating Utility, the load to the Global Catalog server might increase. If you want to avoid this additional load, create a cache file containing the properties used for matching the Exchange address list objects.

13

Client Profile Updating Utility 4.3

To configure the Profile Updating Utility to create a cache file, take the following steps: 1. 2. 3.

Run the EMWProf Configuration Wizard. Select the Cache target Exchange address lists option. Specify the name of the Exchange server to be used to retrieve address lists. Specify the name of the cache file. If only default GAL entries should be saved in a cache file, select the Retrieve GAL only check box. This option is useful if the address lists in your organization include the same entries as the default Global Address List. To decrease the network load, you can compress the cache file by selecting the Compress cache file check box. The Compress.exe file must be located in the same directory as EMWProf.exe.

4.

5.

6. 7.

8.

Specify a name for the Client Profile Updating Utility log file. Choose a name that will help you to find the required information during troubleshooting. Select whether to add the current time, date, or client computer name to the log file name to prevent the log file from being overwritten each time the Client Profile Updating Utility is started. Select the appropriate logging level. The Extended and Advanced logging levels are recommended for troubleshooting only. If you do not want the Client Profile Updating Utility to display a progress bar showing what action it is currently being performed, select the Do not display progress bar and warnings to users check box. Note that the most critical warnings will be displayed even if the check box is selected. Specify a name for the batch file and click Finish. The wizard will create a batch file with the parameters you indicated. To save the target Exchange address list properties in the cache, select the Run the batch file after closing this wizard check box on the last page of the wizard. If you want the cache file to be updated from time to time so that it contains the actual information about the address books, schedule the batch file to be executed as often as needed.

3. Add the Batch File to the Logon Script Add the batch file configured in Step 1 to the logon script, and make sure that the following files are located in the same share as the batch file: • • • •

EMWProf.exe DlgHookHandle.dll The cache file (if used) Compress.exe (if the cache file is compressed)

Then, as soon as the mailboxes are switched and the users log on to their network, the Client Profile Updating Utility will start processing the profiles.

14

Administrator Guide

4. Switch Mailboxes As soon as the Client Profile Updating Utility is configured and ready to be started, you can start switching the source mailboxes to the target Exchange servers. For more information, please refer to the relevant product documentation.

5. Update Profiles As soon as the mailboxes are switched, the Client Profile Updating Utility will start updating user profiles. For details, please refer to the Client Profile Updating Utility: How It Works document. Wait while all profiles are updated.

6. Cleanup After the migration has been completed, all profiles have been successfully updated, and you are absolutely sure that no rollback is required, you can configure the Client Profile Updating Utility to clean up the backup and auxiliary information it saved during update, as follows: 1. 2. 3.

4.

5.

6. 7.

8.

Run the EMWProf Configuration Wizard. Select the Cleanup option on the Select Action page of the wizard. Specify the account under which the Client Profile Updating Utility will log on to the profile during cleanup. It can be either the account of the user in whose logon script EMWProf.exe is included, or an administrative account that allows the Client Profile Updating Utility to log on to Exchange mailboxes. Alternatively, you can force the Client Profile Updating Utility to prompt the user for credentials to log on to the target mailbox. Specify a name for the Client Profile Updating Utility log file that will help you to find the required information during troubleshooting. Select whether to add the current time, date, or client computer name to the log file name to prevent the log file from being overwritten each time the Client Profile Updating Utility is started. Select the appropriate logging level. The Extended and Advanced logging levels are recommended for troubleshooting only. If you do not want the Client Profile Updating Utility to display a progress bar showing what action it is currently performing, select the Do not display progress bar and warnings to users check box. Note that the most critical warnings will be displayed even if the check box is selected. For example, if you force the Client Profile Updating Utility to prompt for credentials, the dialog box for entering credentials will be displayed. Specify a name for the batch file and click Finish. The wizard will create a batch file with the parameters you indicated. This batch file will be used to start the Client Profile Updating Utility in order to clean up backup information. Add the newly created batch file to the logon script.

15

Client Profile Updating Utility 4.3

Updating Microsoft Outlook Offline Profiles One widely-used Microsoft Outlook feature is offline access to a user’s mailbox folders. The offline folders (OST) file is stored on a user’s computer, and a local replica of the corresponding folders is kept for the user’s Exchange mailbox. Cache mode, which was introduced in Outlook 2003, is treated by the Client Profile Updating Utility the same way as offline mode from earlier versions. In this document, users using offline folder (OST) files are referred to as remote users. Because each OST file is associated with only one Exchange mailbox and cannot be used with any other mailbox, a remote user cannot continue to use the same OST file with the new mailbox after the migration. Therefore, the Mail Agent is designed to recreate the target Exchange mailboxes so that the Client Profile Updating Utility can keep the source mailbox OST file and assign it to the target mailbox profile. The typical and recommended procedure for updating Microsoft Outlook offline profiles is as follows: 1. 2.

Decide for which remote users the Microsoft Outlook offline profiles should be updated. Group the mailboxes of those remote users into one or more Remote Users Collections. For more information about Remote Users Collections, refer to the Quest Migration Manager for Exchange User Guide or Quest Exchange Migration Wizard User Guide.

3. 4.

Schedule the Remote Users Collection to be processed during the night or some other time when the users do not use their mailboxes. Wait until the Mail Agent switches the Remote Users Collections. While processing a Remote Users Collection, the Mail Agent recreates the target Exchange mailboxes corresponding to the source mailboxes included in the collection and puts a hidden recreate message into each of the source mailboxes. This message will be then used by the Client Profile Updating Utility. The recreate message contains information about the successful recreation of the target mailbox and allows the Client Profile Updating Utility to keep the offline folder (OST) file for the target mailbox profile.

5. 6. 7.

Run the EMWProf Configuration Wizard. Select the Update option on the Select Action page of the wizard. Specify the account which the Client Profile Updating Utility uses to log on to the profile. 8. Select that the Client Profile Updating Utility should update offline profiles when it is possible to keep OST files. 9. Make other settings required for running the Client Profile Updating Utility. For more information, refer to the Typical Scenario section of this document and to the EMWProf Configuration Wizard online help. 10. Specify the name of the batch file and click Finish. 11. The wizard will create a batch file with the parameters you specified. This batch file will be used to start the Client Profile Updating Utility in order to update profiles. Include the batch file in the users’ logon script.

16

Administrator Guide

12. The Client Profile Updating Utility will start updating offline profiles as soon as the mailboxes of the Remote Users Collection are switched to the target Exchange environment. To determine that the mailboxes are switched, the Client Profile Updating Utility uses the switch message. To determine that the mailboxes were successfully recreated and the OST file can be kept, the Client Profile Updating Utility uses the recreate message. Both messages are put in the mailbox by the Mail Agent. The switch message is a hidden message that contains the Legacy Exchange DN of the target Exchange server and the user’s new mailbox. If there is no switch message in the mailbox, the Client Profile Updating Utility will log off the mailbox and stop processing the profile. Before profile update is started, the remote users should be warned not to click the Check Name button in the Exchange service properties of the profile when they log on to their updated profiles. If the account name is checked, the OST file will not function for the target profile any more. However, the OST file can be restored using the REG file created by the Client Profile Updating Utility in the same directory where the OST file is located. The REG file will have the name of the profile and the extension REG. For more information about using the REG file for restoring the OST file, refer to the Troubleshooting section of this document.

When configuring the Client Profile Updating Utility, you can also select the following options for updating offline profiles: 1.

2.

Never update offline profiles The offline profiles will be skipped and the users will have to recreate their profiles manually. Always update offline profiles If you select this option, you should be aware of the risk of data loss for those remote users whose target mailboxes were not prepared for migration by the Mail Agent when it processed them within the Remote Users Collections.

Using a Dial-Up Connection While Updating Profiles If a user’s profile is updated over a dial-up connection, the performance of the Client Profile Updating Utility may appear to be slow; it may take several hours to update the profile. The following data take the longest to be updated over a dial-up connection: • • •

Nicknames (AutoNameCheck) Read/Unread message status Junk e-mail senders list and Adult content senders list

If you are updating a profile for a mailbox migrated by Exchange Migration Wizard, you can force the Client Profile Updating Utility to skip processing of the data listed above and to remove all nicknames from the profile. For that, include the following string in the command line: -Skip JunkSenders AdultSenders ReadStatus -Remove Nicks

17

Client Profile Updating Utility 4.3

Where: JunkSenders—Junk e-mail senders list AdultSenders—Adult content senders list ReadStatus—The read/unread status of the messages Nicks—Nickname functionality

Setting RPC over HTTP Access The Client Profile Updating Utility can automatically set RPC over HTTP Exchange access for the target Outlook profile. To configure RPC over HTTP access for the target account: 1. 2. 3. 4.

5.

In the EMWProf Configuration Wizard, go to the Configure HTTP Connection Settings step. Select the Connect Using HTTP check box. Specify the proxy server URL and other parameters, and click Next. In the Configure Advanced HTTP Connection Settings step, select First Logon Over TCP if you want the Client Profile Updating Utility to try using RPC/TCP and set PRC/HTTP only if TCP access fails. If the option is not selected, the Client Profile Updating Utility will not try RPC/TCP access and will set RPC/HTTP access for the target mailbox in all cases. Proceed with other options.

Alternatively you can manually create an INI file and make the Client Profile Updating Utility use it by specifying the -RPCOverHTTP -SkipPing command-line parameters. The INI file should have the following format: [RPCOverHTTP] ConnectUsingHTTP={0,1}

[1]

ProxyServer= SSLOnly={0,1}

[1]

MutualAuth={0,1}

[0]

PrincipalName=

[""]

HTTPFirstOnFast={0,1}

[1]

HTTPFirstOnSlow={0,1}

[0]

AuthType={Basic, NTLM}

[NTLM]

FirstLogonOverTCP={0,1}

[1]

The values in [square brackets] are the defaults; the values in the {curly braces} are the options; and provide the format information. The Client Profile Updating Utility configures only the Outlook profile. You must still set up the rest of the RPC over HTTP configuration as described in the Microsoft KB article at http://support.microsoft.com/?id=833401.

18

Administrator Guide

Updating Resource Mailboxes Overview Resource mailboxes are mailboxes that represent company resources you can book (such as conference rooms and equipment). Since resource mailboxes are used only to book resources, normally no one logs on to them and therefore no Outlook profiles are created for them. However, when migrating resource mailboxes, not all settings you configured in the source environment are migrated to the target by the agents. These settings can be updated by the Client Profile Updating Utility only after the mailbox is migrated. This raises an issue since the Client Profile Updating Utility requires Outlook profile to exist in order to update mailbox settings. If the number of resource mailboxes is large, it can be a challenge to create an Outlook profile for each resource mailbox manually. The Switch Resource Mailboxes utility (SwitchResMb.exe) is a complementary utility to the Client Profile Updating Utility designed to help update resource mailboxes. With the help of SwitchResMb.exe you can update resource mailboxes in bulk without manually creating Outlook profiles. The Switch Resource Mailboxes utility transfers the following resource mailbox settings from source to target: • •

Delegate can see my private items Send meeting requests and responses only to my delegates, not to me • The Switch Resource Mailboxes utility uses the Client Profile Updating Utility to process resource mailboxes, so all mailbox settings processed by the Client Profile Updating Utility will be also transferred, in addition to resource mailbox settings mentioned above. • It is recommended to switch and process the resource mailboxes after the user mailboxes are already switched (that is, when the users log on to the target mailboxes).

19

Client Profile Updating Utility 4.3

System Requirements SwitchResMb.exe is installed with the Client Profile Updating Utility and is located in the Client Profile Updating Utility installation folder (see the Location section above in this document). The following files are required for SwitchResMb.exe to run: • • •

EMWprof.exe—Client Profile Updating Utility executable DlgHookHandler.dll—required library file Config.ini—A configuration file that contains SwitchResMb.exe parameters and the list of resource mailboxes to be updated

Usage Command Line Syntax The utility can be run in either of the following modes: •

Password encryption—In this mode the password you type will be encrypted and saved to the TrgDCPassword parameter of the config.ini file. Both the PathToConfig.ini and Password parameters must be specified.

SwitchResMB.exe PathToConfig.ini Password Password encryption is obligatory and must be completed before starting the utility in the Processing resource mailboxes mode, described below.

•

Processing resource mailboxes—In this mode the utility processes resource mailboxes. Only the PathToConfig.ini parameter is required.

SwitchResMB.exe PathToConfig.ini > PathToSwitchResMbx.log

Parameters • •

PathToConfig.ini—The path to the config.ini file. Password—The password for encryption.

PathToSwitchResMbx.log is the path to the log file that the utility will create. If output redirection (>) to this file is not used, messages will be written to standard output. The config.ini file should contain the following parameters: • • • • • • 20

SrcExchServer—The source Exchange server name TrgExchServer—The target Exchange server name Version—Indicates whether Exchange Migration Wizard (V1) or Quest Migration Manager for Exchange (V4) is used EMWProfBat—The full path to the EMWProf.bat batch file TrgDCName—The target domain controller name TrgDCAccount—The account used to connect to the target domain controller

Administrator Guide

• •

TrgDCPassword—The encrypted password used to connect to the target domain controller One of the following: • A list of distinguished names (attribute: obj-Dist-Name) of resource mailboxes to be updated, if you migrate from Exchange 5.5 using Exchange Migration Wizard • A list of legacyExchangeDNs of resource mailboxes in the source Exchange 2000/2003/2007 organization to be updated, if you migrate using Migration Manager for Exchange

Example Below is an example of the INI file for Exchange Migration Wizard: [Settings] SrcExchServer = RSOURCE TrgExchServer = ROM2K3SRV2 Version = v1 EMWProfBat = EMWProf.bat TrgDCName = ROM2K3DC TrgDCAccount = GLOBEX\EMWAdmin TrgDCPassword = password [Mailboxes] /o=SourceEx/ou=UptonRd/cn=Recipients/cn=Resources/Room1 /o=SourceEx/ou=UptonRd/cn=Recipients/cn=Resources/Room2 /o=SourceEx/ou=UptonRd/cn=Recipients/cn=Resources/Room3

Batch File Syntax The recommended syntax for the batch file to run EMWProf is as follows: EMWprof.exe -skip FAV AddBoxes PublicFAV CONTAB DistLists PAB Services Shares UserNames Activities MoveToFolder OtherUsersFolders FolderViews GroupSchedules AdultSenders JunkSenders Nicks OfflineAB SearchFolders Shortcuts SRS Wunderbar -Log #t_LogFileName.log

It is also recommended to use the -Silent switch so that EMWprof does not display any dialog boxes.

21

Client Profile Updating Utility 4.3

Credentials You must either run this tool under the Single Administrative Account, as in the example above, or use the following additional parameters: -AskCredentials—The user will be asked to specify credentials to log on to source and target mailboxes. -Admin -Password (-AdminTrg -PasswordTrg)—The Client Profile Updating Utility will use credentials you specify by these parameters to log on to the source and target mailboxes. For more information about the Single Administrative Account, refer to the Exchange Migration Wizard Quick Start Guide and Migration Manager System Requirements and Access Rights document.

22

Administrator Guide

Troubleshooting Restoring OST Files If a remote user whose offline profile has been successfully updated by the Client Profile Updating Utility clicks the Check name button in the Exchange service properties of the profile, the link between the OST file and the profile will be lost and the user will not be able to use the OST file any longer. To restore the OST file, have the user run on his or her workstation the REG file created by the Client Profile Updating Utility in the same directory where the OST file is located. The REG file will have the name of the profile and the extension REG.

Rolling Back Changes The changes made by the Client Profile Updating Utility in the Microsoft Outlook profiles can be rolled back if any issues occurred during the update. You will likely need to undo changes made in one or several selected profiles. Unless you want to roll back changes made in all mailboxes’ profiles, do not start the Client Profile Updating Utility from the logon script. Instead, copy the EMWProf.exe file and a batch file to a user’s workstation and start the utility manually from that workstation. To undo the changes made by the Client Profile Updating Utility, take the following steps: 1. 2. 3. 4. 5. 6. 7.

Run the EMWProf Configuration Wizard. Select the Rollback option. Specify the account or accounts under which the Client Profile Updating Utility will log on to the profiles. Select the profiles where the changes should be undone. Specify the name under which the Client Profile Updating Utility log file will be saved. Specify the name of the batch file. The batch file now stores the parameters with which the Client Profile Updating Utility will be started. As soon as the batch file is created and copied to the user’s workstation, the Client Profile Updating Utility can be started. No rollback is possible if the Cleanup operation has been performed. For more information about Cleanup mode, refer to the Modes section of this document.

23

Client Profile Updating Utility 4.3

Before You Call Support If a profile was not updated, please do the following before you call Quest Support: 1. 2. 3. 4. 5. 6. 7.

Run the EMWProf Configuration Wizard. Select Update mode. Select the Advanced logging level on the Select Logging Options step. Complete the wizard and copy the resulting batch file to the problem workstation. Copy the EMWProf.exe_ file to the problem workstation and rename it to EMWProf.exe. Run the Client Profile Updating Utility with the batch file you created. Call Quest Support, describe the issue in detail, and send the resulting log file.

If a profile was updated but some error occurred during update, first run the Client Profile Updating Utility in Rollback mode on the problem workstation and then perform all the steps described above.

24

Administrator Guide

Technical Reference Notification File Format Usually you do not need to create the notification file manually. The EMWProf Configuration Wizard creates the notification file according to the settings you made. You need to reference this section only if you want to create the command line yourself and receive notifications about Client Profile Updating Utility activities.

File Format Here is an example of the notification file that should be located in the same directory where EMWProf.exe file is located: [Admin notification] SMTP [email protected] SMTP [email protected] Priority=normal Attach log=statistics Notification=fail Profile=current Subject=%R: Profile %P on computer %H Body=The mail client profile %P for user %U on computer %H has been processed by Client Profile Updating Utility (EMWProf), and was %R. The profile was processed at %T, %D. See the EMWProf log file for details.

Admin notification

The name of the section. Cannot be changed.

SMTP Address

Specifies one or several SMTP addresses to which the notification will be sent.

Priority

Defines the priority of the notification. Possible values: low, high, normal. The default is normal.

Attach log

Defines what should be attached to the notification message. Possible values:

none

No attachment will be send with the notification.

all

The full log will be attached to the notification.

statistics

The statistics gathered from the log file will be attached to the notification. This is the default value.

25

Client Profile Updating Utility 4.3

Notification

Defines in what cases notification should be sent. Possible values:

success

Notification will be sent if the profile has been successfully updated.

fail

Notification will be sent if the profile has not been updated. This is the default value.

all

Notification will be sent in any case.

none

Notification is turned off.

Profile

Defines which profile should be used to send notifications. default

Notification will be sent via the default profile as soon as this profile is updated. This is the default value.

current

Notification will be sent via the current profile as soon as this profile is updated.

Subject

Specifies the notification subject.

Body

Specifies the notification body.

Variables The following variables can be used in the subject and body of the notification message: %r, %R

UPDATED or NOT UPDATED

%u, %U

User name (for Windows 9x, the Profile name parameter value is used)

%p, %P

Profile name

%h, %H

Computer name

%t, %T

Time

%d, %D

Date

%%

%

Command-Line Parameters Entering or reviewing command-line parameters is usually not necessary. The EMWProf Configuration Wizard creates a batch file with the appropriate parameters for you. You need to reference this section only in the following cases: • •

26

You read about a parameter in the EMWProf Configuration Wizard online help and want more information. You want to create the command line by yourself (though this is not recommended) and run the Client Profile Utility from the command line rather than using the batch file configured by the EMWProf Configuration Wizard.

Administrator Guide

The utility can be run with the following command-line parameters: PARAMETER

DESCRIPTION

MODES

-Profiles [ProfileName2] [ProfileName3] [...]

Makes the Client Profile Updating Utility process the specified profiles only.

Update Using Cache File

-Undo [ProfileName2] [ProfileName3] [...]

Rolls back changes made to the specified profiles. Specify the names of the profiles you want to undo the changes in.

Rollback

Update Without Using Cache File

If the utility is run with this parameter from a logon script, the changes will be rolled back on every workstation. -UndoAll

Rolls back all changes made by the utility to all updated profiles.

Rollback

If the utility is run with this parameter from a logon script, the changes will be rolled back on every workstation. -Admin

Allows the user to specify the administrative account to be used for working with Exchange mailboxes. This parameter can be used only together with the -Password parameter.

All modes

-Password

Specifies the password for the Admin account. The password must be encrypted by the Exchange Migration Wizard Password Manager utility.

All modes

-AdminTrg

Allows the user to specify the administrative account to log on to the target mailboxes. This parameter can be used only together with the -PasswordTrg parameter. The parameter is helpful when no trust relationships are established between the source and target domains.

Update Using Cache File Update Without Using Cache File

If this parameter is omitted, then the account specified by the -Admin parameter will be used.

27

Client Profile Updating Utility 4.3 PARAMETER

-PasswordTrg

DESCRIPTION

MODES

Specifies password for the AdminTrg account. The password must be encrypted by the Exchange Migration Wizard Password Manager utility.

Update Using Cache File

Makes the utility prompt for credentials to log on to the source server. If the specified credentials do not allow logon to the target server, the utility prompts for target server credentials also. If the parameter was used in update mode, the Client Profile Updating Utility will prompt for credentials automatically when the profile is cleaned up or rolled back.

Update Using Cache File

-ProcessOfflineProfiles On | Off

A value of On forces the utility to back up the OST file and update the offline profiles. After a profile has been updated by the utility, Microsoft Outlook will create a new OST file at the profile’s first logon.

Update Using Cache File

-KeepOST On [NoReg] [Backup] | Off | UseTarget

A value of On forces the Client Profile Updating Utility to keep the OST file for the target mailbox profile if the corresponding source mailbox was processed within a Remote Users Collection by the Mail Agent. NoReg prevents the utility from creating the registry (REG) file used for restoring a lost link between OST file and a profile. Backup forces the utility to create a backup copy of the original OST file. UseTarget is used only during rollback. This option tells the Client Profile Updating Utility to keep the OST file for the target mailbox after rollback.

Update Using Cache File

-AllowAdditionalServices Svc1 [Svc2] [Svc3] [...]

Forces the utility to process the non-default service providers whose MAPI names are specified as the parameter values. To process all the existing services, specify the value All as the parameter.

Update Using Cache File

-AskCredentials

28

Update Without Using Cache File Rollback

Update Without Using Cache File Rollback Cleanup

Update Without Using Cache File

Update Without Using Cached File

Update Without Using Cache File

Administrator Guide PARAMETER

DESCRIPTION

MODES

The services updated by default are: • Microsoft Exchange Server (MSEMS) • Personal Address Book (MSPST AB) Personal Folders (.pst) File (MSPST MS; MSUPST MS) • Outlook Address Book (CONTAB) • Microsoft LDAP Directory (EMABLT) • Internet Folders (INTERSTOR) • Internet E-mail (IMAIL) -SrcTag

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Specifies the MAPI tag to be used for searching the Exchange address lists on all the source servers.

Update Using Cache File

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Specifies the MAPI tag to be used for searching the Exchange address lists on all the target servers.

Update Without Using Cache File

-ALMap

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Forces the utility to use the specified map file for matching objects retrieved from the Exchange address lists.

Update Using Cache File

-CreateALMap

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Forces the utility to create a map file containing properties used for matching the Exchange address lists objects.

Creating Cache file

-RetrieveGALOnly

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Forces the utility to retrieve objects from the default GAL only while creating a map file.

Creating Cache file

-TrgTag

Update Without Using Cache File

Creating Cache File

29

Client Profile Updating Utility 4.3 PARAMETER

DESCRIPTION

MODES

-LZCompression

This parameter is relevant only when the Client Profile Updating Utility is used with Exchange Migration Wizard. Forces the utility to compress the map file.

Creating Cache file

-Servers [Server2] […]

Specifies the servers from which the Exchange address lists will be retrieved.

Creating Cache file

-Silent

Prevents the utility from displaying any dialog boxes while updating profiles.

All modes

-Critical [Value2] [Value3] [...]

Forces the utility to skip profiles for which the critical functionalities specified as the values of this parameter cannot be updated. As values of this parameter, you can specify such functionalities as Rules and CONTAB. A complete list of functionalities can be found in the Critical Functionalities section.

Update Using Cache File

-Cleanup

Deletes all backup profiles and cleans up all auxiliary backup information. Please make sure that all profiles have been successfully updated and no rollback is required before running the utility with this parameter.

Cleanup

Notification

Forces the utility to send a notification message about update results to the addresses specified in the file. The format of the file can be found in the Notification File Format section of this document.

Update Using Cache File

Specifies the name and path to the log file. You can specify either the full path to the log file or only the file name, in which case the log will be written to the folder from which the utility is started. If this parameter is not specified, the log file will be created with the default name, EMWProf.log. You can use the following additional parameters to add the client computer name and the current date and time: #H—inserts client computer name #D—inserts the current date #T—inserts the current time

All modes

-Log

30

Update Without Using Cache File

Update Without Using Cache File

Administrator Guide PARAMETER

DESCRIPTION

MODES

You can also use the existing environment variable values to form the Client Profile Updating Utility log file name. For example, you can add the user name of the account currently logged on to the name of the log file by typing the following expression: %username%_EMWProf.log The %username% parameter will be replaced with the real user name associated with the security context in which the Client Profile Updating Utility was started. -LogLevel

Specifies the maximum level of records that will be written to the log file. The value must be in the range from 1 to 10. The default value is 2.

All modes

-LogStack

Forces the log file to include a stack tracing if errors occur.

All modes

-Skip [Value2] [Value3] [...]

Forces the utility to skip the specified functionalities. For more information, see the Using a Dial-Up Connection while Updating Profiles section.

Update Using Cache File Update Without Using Cache File

-RPCOverHTTP

Set RPC over HTTP in the target Outlook profile according to the INI file generated by the configuration wizard. For details, see the Setting RPC over HTTP Access section.

Update Using Cache File Update Without Using Cache File

-SkipPing

Specifies that the utility should not ping the target Exchange server to verify its availability. Always use this parameter when the target network has no RPC/TCP connectivity and relies only on HTTP.

Update Using Cache File Update Without Using Cache File

-Remove Nicks

Forces the utility to remove all nicknames from the profile. If the nickname functionality is also specified in the -Critical key and errors occur during nickname removal, the update will automatically be rolled back.

Update Using Cache File Update Without Using Cache File

-RemoveJunkEmail Messages

Forces the Client Profile Updating Utility to remove all junk e-mail settings from the updated profile.

Update Using Cache File Update Without Using Cache File

-?

Displays help information.

All modes 31

Client Profile Updating Utility 4.3

Critical Functionalities If you run the Client Profile Updating Utility from the command line rather than using the batch file configured by EMWProf Configuration Wizard, you can force the Client Profile Updating Utility to skip profiles in which it cannot update the functionalities that you define as critical. For example, if it is critical that rules be updated, you can specify Rules as the value of the –Critical command-line parameter. Below you will find the list of critical functionalities that can be specified as values for the -Critical parameter and the names of the appropriate Microsoft Outlook settings: VALUE

MICROSOFT OUTLOOK SETTING

Activities

Activities

AddBoxes

Additional Mailboxes

CONTAB

Outlook Address Book

Delegates

Delegates

FAV

FAV files

FolderViews

Folder Views (Filters, Automatic Formatting)

GroupSchedules

Group Schedules

PAB

Personal Address Book

Rules

Rules

SRS

Send/Receive Settings

SearchFolders

Search Folders

Shortcuts

Microsoft Outlook Shortcuts

Most of the functionalities listed here are described in the What the Utility Updates section of this document.

EMWProf Return Codes When the Client Profile Updating Utility finishes, it sets the value of the errorlevel variable based on its exit status. The following bit mask can be used to retrieve the Client Profile Updating Utility completion status from the errorlevel code: 1

EMWP_SUCCESS

2

EMWP_NO_SWITCH_MSG

4

EMWP_SWITCH_ERR

8

EMWP_USER_ABORT

16 EMWP_GLOBAL_ERR

32

Administrator Guide

The following table lists the errorlevel flags that can be set for each mode the Client Profile Updating Utility runs in: STATUS

1. Exit after running in Update mode.

RETURN CODE (ERRORLEVEL)

0—Nothing to update. EMWP_SUCCESS—One or more profiles were updated. EMWP_NO_SWITCH_MSG—No switch message was found for one or more profiles. EMWP_SWITCH_ERR—Update failed for one or more profiles. EMWP_GLOBAL_ERR—Update failed. EMWP_USER_ABORT—Update was aborted by the user.

2. Exit after running in Undo mode.

0—Nothing to undo. EMWP_SUCCESS—One or more profiles were un-done. EMWP_SWITCH_ERR—Undo failed for one or more profiles.

3. Exit after creation of a map file.

0—Map file was successfully created.

4. Exit after running in Cleanup mode.

0—Nothing to clean up.

EMWP_GLOBAL_ERR—Failed to create a map file.

EMWP_SUCCESS—One or more profiles were cleaned up. EMWP_USER_ABORT—Cleanup was aborted by the user. EMWP_GLOBAL_ERR—Cleanup failed.

33

Client Profile Updating Utility 4.3

About Quest Software, Inc. Now more than ever, organizations need to work smart and improve efficiency. Quest Software creates and supports smart systems management products—helping our customers solve everyday IT challenges faster and easier. Visit www.quest.com for more information.

Contacting Quest Software Phone

949.754.8000 (United States and Canada)

Email

[email protected]

Mail

Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA 92656 USA

Web site

www.quest.com

Please refer to our Web site for regional and international office information.

Contacting Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to SupportLink, our self-service portal. Visit SupportLink at http://support.quest.com/ From SupportLink, you can do the following: •

Retrieve thousands of solutions from our online Knowledgebase

•

Download the latest releases and service packs

•

Create, update and review Support cases

View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures. The guide is available at: http://support.quest.com.

34

Administrator Guide

Third Party Contributions Quest® Migration Manager, version 8.6 contains some third party components (listed below). Copies of their licenses may be found at http://www.quest.com/legal/third-party-licenses.aspx. COMPONENT

LICENSE OR ACKNOWLEDGEMENT

Boost 1.34.1

Boost 1.0

Loki 0.1.4

MIT

Loki 0.1.6

MIT

TinyXml 2.2.1

This product contains portions of the PAWN scripting software (formerly known as SMALL).

ZLib 1.1.4

Copyright (C) 1995-2005 Jean-loup Gailly and Mark Adler

* A copy of the source code for these components may be available at http://rc.quest.com, if necessary to fulfill attribution requirements. .

Boost 1.0 License Agreement Boost Software License - Version 1.0 - August 17th, 2003 Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machineexecutable object code generated by a source language processor. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

Loki 0.1.4 License Agreement Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

35

Client Profile Updating Utility 4.3

Loki 0.1.6 License Agreement Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

ZLib 1.1.4 License Agreement /* zlib.h -- interface of the 'zlib' general purpose compression library version 1.2.3, July 18th, 2005 Copyright (C) 1995-2005 Jean-loup Gailly and Mark Adler This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. Jean-loup Gailly [email protected] Mark Adler [email protected]

36