Parallels H-Sphere Documentation System Administrator Guide

 

Installing the Hosted Exchange Offline Address Book (OAB) Update Batch Application

 
 

Related Docs:   Preparing Servers for MS Exchange Hosting

Last modified: 27 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

The Hosted Exchange OAB Update batch application runs on a daily schedule in order to rebuild OAB for organizations that have had membership modifications. To install and configure it to run as a scheduled job, do the following:

  1. Install the Hosted Exchange OAB Update Batch Application
  2. Configure Security for the Hosted Exchange OAB Update Batch Application Registry Keys
  3. Configure Security Access For the Applications Local File Resources
  4. Configure Option Settings for the Hosted Exchange OAB Update Batch Application
  5. Execute the Hosted Exchange OAB Update Batch Application
  6. Create a Scheduled Task for the Hosted Exchange OAB Update Batch Application

Install the Hosted Exchange OAB Update Batch Application

  1. Log on to Server2(Exchange) using an account that is a member of the Domain Administrators group.
  2. From a command prompt in the Service Provisioning\MPS\Install folder, run the ExchangeOABUpdate.msi file. You must specify a password as follows:
    msiexec.exe /i ExchangeOABUpdate.msi OABUSERPW=password
    where password meets your Active Directory security requirements.
  3. On the License Agreement page, select I accept the terms in the license agreement, and then click Next.
  4. On the Customer Information page, enter the User Name and Organization, and then click Next.
  5. On the Setup Type page, select Complete, and then click Next.
  6. Click Install.
  7. Click Finish to complete the installation and close the Installation Wizard.
  8. Log on to Server1(DC) using an account that is a member of the Domain Administrators group.
  9. On the taskbar, click Start, point to Administrative Tools, and then click Active Directory Users and Computers.
  10. Expand fabrikam.com, and then select Users.
  11. In the right pane, locate and right-click the MPFClientAccts user object, and then select Properties.
  12. In the Properties dialog box, select the Members tab.
  13. Click Add, type MPSOABUpdateAccts and then click Check Names. Verify that MPSOABUpdateAccts is underlined, and then click OK.
  14. Click OK to close the Properties dialog box.

Note: By default, the MPSOabUpdateAcct is the only account that can execute the HEOabUpdate.exe application. If you want other users to be able to run the application, you must add them to the MpsOabUpdateAccts group. After adding users to the MpsOabUpdateAccts group, you muse restart the Microsoft Provisioning Framework (MPF) engine for the changes to take effect.

Configure Security for the Hosted Exchange OAB Update Batch Application Registry Keys

In the following procedures you will configure security access for the applications registry keys, local resources, and MPF procedures.

WARNING:
Incorrectly editing the registry can cause serious problems that may require you to reinstall your operating system. Problems resulting from editing the registry incorrectly may not be resolved. Before editing the registry, back up any valuable data.

To configure security access for the Hosted Exchange OAB Update Batch Application registry keys:

  1. Log onto Server2(Exchange) using an account that is a member of the Domain Administrators group
  2. Start Registry Editor (regedit).
  3. Navigate to the HKEY_LOCAL_MACHINE\Software\Microsoft\Provisioning\HeOabUpdate key.
  4. Click the Edit menu and select Permissions.
  5. In the Permissions for HeOabUpdate dialog box, click Add.
  6. Type MpsOabUpdateAccts and click Check Names to verify that the group exists.
  7. Click OK.
  8. Click Advanced.
  9. Select MPSOabUpdateAccts in the permissions entries list and click Edit.
  10. In the Apply onto list, ensure that this key and subkeys is selected.
  11. In the Permissions list, leave the default values selected, and then select the Allow check box for the Set Value and Create Subkey permissions.
  12. Click OK three times.
  13. Close Registry Editor.

Configure Security Access For the Applications Local File Resources.

To configure security access for the Hosted Exchange OAB Update Batch Application local resources

  1. Open File Explorer and navigate to <drive>:\Program Files\Microsoft Hosting\Provisioning.
  2. Right-click the Exchange OAB Update directory and select Properties.
  3. Select the Security tab and click Add.
  4. Type MpsOabUpdateAccts and click Check Names to verify that the group exists. Click OK.
  5. Ensure that the Allow check box for the Modify permission is selected.
  6. Click OK.

Configure Option Settings for the Hosted Exchange OAB Update Batch Application

In this procedure, you will edit the applications configuration file to change settings to appropriate values for your deployment.

To configure optional settings for the Hosted Exchange OAB Update Batch Application:

  1. Remove the read-only attribute from :\Program Files\Microsoft Hosting\Provisioning\Exchange OAB Update\HeOabUpdate.exe.config, and then open the file.
  2. Set the preferredDomainController value to the fully qualified domain name (FQDN) of your preferred domain controller as in the following example:
    <configuration>
        <appSettings>
        <add key="eventLogLevel" value="Minimum"/>
        <add key="screenLogLevel" value="Minimum"/>
        <add key="logAllEventsToFile" value="true"/>
        <add key="preferredDomainController" value="AD01.fabrikam.com"/>
        </appSettings>
    </configuration>
    Note: AD01.fabrikam.com is full computer name of Server1(Domain controller)
  3. Save the file after making your changes

Execute the Hosted Exchange OAB Update Batch Application

In the following procedure you execute the Hosted Exchange OAB Update batch application from the command line.

To execute Hosted Exchange OAB Update from a command line:

  1. Open a command prompt and navigate to :\Program Files\Microsoft Hosting\Provisioning\ Exchange OAB Update.
  2. Type the following, and press Enter:
    HeOabUpdate.exe
  3. Close the command prompt when the application has finished processing.
 

Create a Scheduled Task for the Hosted Exchange OAB Update Batch Application

In the following procedures you will create a scheduled task for the application.

To create a scheduled task to run Hosted Exchange OAB Update daily

  1. Point to Settings, and then click Control Panel.
  2. Double-click Scheduled Tasks.
  3. Double-click Add Scheduled Task.
  4. In the Scheduled Task Wizard, click Next.
  5. Click Browse, and then select :\Program Files\Microsoft Hosting\Provisioning\Exchange OAB Update\HeOabUpdate.exe.
  6. Click Open.
  7. Select the Daily option, and then click Next.
  8. Set Start Time to 6:00 AM.
  9. Click Next.
  10. Enter the Fabrikam\MPSOabUpdateAcct user name and the password for this account. Click Next.
    Where Fabrikam is active directory domain name
  11. Note: Task Scheduler does not verify that the password you enter for the MPSOabUpdateAcct matches the password set for the user in Active Directory. If you enter an incorrect password, the task will fail when it runs at its scheduled time.

  12. Click Finish.

Related Docs:   Preparing Servers for MS Exchange Hosting



© Copyright 2017. Parallels Holdings. All rights reserved.