A hotfix rollup package (build 4.0.3714.2) is available for Forefront Identity Manager 2010

Applies to: Forefront Identity Manager 2010

Introduction


A hotfix rollup package (build 4.0.3714.2) is available for Microsoft Forefront Identity Manager (FIM) 2010. This hotfix rollup package resolves some issues and adds some features that are described in the "More Information" section.

Update information

A supported update is available from Microsoft. We recommend that all customers apply this update to their production systems.

This update is available from the following Microsoft websites:

Microsoft Update


Microsoft Update Catalog

Microsoft Support

If this update is available for download from Microsoft Support, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix. Additionally, you can obtain the update from Microsoft Update or from Microsoft Update Catalog.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, go to the following Microsoft website: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Component update packages
The following table contains the component update packages that are included in the download from Microsoft Support.

ComponentFile name
FIM 2010 Add-ins and ExtensionsFIMAddinsExtensions_x86_KB2887498.msp FIMAddinsExtensions_x64_KB2887498.msp
FIM 2010 Add-ins and Extensions Language PackFIMAddinsExtensionsLP_x86_KB2887498.msp FIMAddinsExtensionsLP_x64_KB2887498.msp
FIM 2010 Certificate ManagementFIMCM_x86_KB2887498.msp
FIMCM_x64_KB2887498.msp
FIM 2010 Certificate Management ClientFIMCMClient_x64_KB2887498.msp
FIM 2010 Certificate Management Bulk Issuance ClientFIMCMBulkClient_x86_KB2887498.msp
FIM 2010 Service and PortalFIMService_x64_KB2887498.msp
FIM 2010 Service Portal Language PackFIMServiceLP_x64_KB2887498.msp
FIM 2010 Synchronization Service FIMSyncService_x64_KB2887498.msp

Known issues in this update

Synchronization Service
After this update is installed, rules extensions and custom management agents (MAs) that are based on Extensible MA (ECMA1 or ECMA 2.0) may not run and may produce a run status of "stopped-extension-dll-load." This issue occurs when you run such rules extensions or custom MAs after you change the configuration file (.config) for one of the following processes:
  • MIIServer.exe
  • Mmsscrpt.exe
  • Dllhost.exe
For example, you edited the MIIServer.exe.config file to change the default batch size for processing sync entries for the FIM Service MA.

In this case, the synchronization engine installer for this update intentionally does not replace the configuration file to avoid deleting your previous changes. Because the configuration file is not replaced, entries that are required by this update will not be present in the files, and the synchronization engine will not load any rules extension DLLs when the engine runs a Full Import or Delta Sync run profile.

To resolve this issue, follow these steps:
  1. Make a backup copy of the MIIServer.exe.config file.
  2. Open the MIIServer.exe.config file in a text editor or in Microsoft Visual Studio.
    • Make sure that you open the text editor by using the Run as Administrator option so that Windows will let you save the changes.
    • If you do not open the text editor by using the Run as Administrator option, and if the UserAccountControl option is enabled, Windows will not let the file be saved to the \bin folder.
  3. Find the <runtime> section in the MIIServer.exe.config file, and then replace the content of the <dependentAssembly> section with the following:

    <dependentAssembly>
    <assemblyIdentity name="Microsoft.MetadirectoryServicesEx" publicKeyToken="31bf3856ad364e35" />
    <bindingRedirect oldVersion="3.3.0.0" newVersion="4.0.2.0" />
    <bindingRedirect oldVersion="4.0.0.0" newVersion="4.0.2.0" />
    <bindingRedirect oldVersion="4.0.1.0" newVersion="4.0.2.0" />
    </dependentAssembly
  4. Save the changes to the file.
  5. Find the Mmsscrpt.exe.config file in the same directory and the Dllhost.exe.config in the parent directory. Repeat steps 1 through 4 for these two files.

    Note You might not have a file that is named Dllhost.exe.config in the parent directory. It is needed only for ECMA1 and ECMA 2.0 management agents that are running out-of-process. If you are running management agents in this mode, copy the MIIServer.exe.config file to the parent folder (..\Synchronization Service), and then rename it as "Dllhost.exe.config."
  6. Restart the Forefront Identity Manager Synchronization Service (FIMSynchronizationService).
  7. Verify that the rules extensions and custom management agents now work as expected.

Microsoft.MetadirectoryServicesEx.dll
Included in this hotfix package is an updated version of the Microsoft.MetadirectoryServicesEx.dll file (also known as the interface DLL). This interface DLL is updated from the original release version and is now version 4.0.2.0. If you have MA extensions for ECMA1/XMA, ECMA 2.0, or rules extensions, you might have to take additional actions for these extensions to continue working. This is true because your DLL will have references to an earlier version (4.0.x.0). There are three files that have binding redirect information. They are used as follows:
  • MIIServer.exe.config: All ECMA1 and ECMA2.0 management agents and all rules extensions that are running in-process
  • Mmsscrpt.exe.config: All rules extensions that are running out-of-process
  • Dllhost.exe.config: All ECMA1 and ECMA2.0 management agents that are running out-of-process

Prerequisites

To apply this update, you must have Forefront Identity Manager 2010 build 4.0.2592.0 or a later build installed.

Restart requirement

You must restart the computer after you apply this update. Additionally, you may have to restart the server components.


Replacement information

This update replaces the following updates:
  • 2819338 A hotfix rollup package (build 4.0.3684.2) is available for Forefront Identity Manager 2010
  • 2750673 A hotfix rollup package (build 4.0.3644.2) is available for Forefront Identity Manager 2010
  • 2737503 A hotfix rollup package (build 4.0.3627.2) is available for Forefront Identity Manager 2010
  • 2688078 A hotfix rollup package (build 4.0.3617.2) is available for Forefront Identity Manager 2010
  • 2635086 Update Rollup 2 (build 4.0.3606.2) is available for Forefront Identity Manager 2010
  • 2520954 A hotfix rollup package (build 4.0.3594.2) is available for Forefront Identity Manager 2010
  • 2502631 A hotfix rollup package (build 4.0.3576.2) is available for Forefront Identity Manager 2010
  • 2417774 A hotfix rollup package (build 4.0.3573.2) is available for Forefront Identity Manager 2010
  • 2272389 A hotfix rollup package (build 4.0.3558.2) is available for Microsoft Forefront Identity Manager (FIM) 2010
  • 2028634 A hotfix rollup package (build 4.0.3547.2) is available for Microsoft Forefront Identity Manager (FIM) 2010
  • 978864 Update Package 1 for Microsoft Forefront Identity Manager (FIM) 2010

File information

The global version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

File nameFile sizeDateTime
Fimaddinsextensionslp_x64_kb2887498.msp5,551,61617-Sep-201311:04
Fimaddinsextensionslp_x86_kb2887498.msp4,439,04017-Sep-201310:53
Fimaddinsextensions_x64_kb2887498.msp3,625,47217-Sep-201311:04
Fimaddinsextensions_x86_kb2887498.msp3,011,58417-Sep-201310:53
Fimcmbulkclient_x86_kb2887498.msp5,235,20017-Sep-201310:53
Fimcmclient_x64_kb2887498.msp5,828,60817-Sep-201311:05
Fimcm_x64_kb2887498.msp21,956,60817-Sep-201311:05
Fimcm_x86_kb2887498.msp21,673,98417-Sep-201310:53
Fimservicelp_x64_kb2887498.msp4,855,29617-Sep-201311:05
Fimservice_x64_kb2887498.msp18,562,56017-Sep-201311:05
Fimsyncservice_x64_kb2887498.msp118,294,52817-Sep-201311:05

More Information


Issues that are fixed in this update

This update fixes the following issues.

FIM Synchronization Service

Issue 1
FIM synchronization cannot deprovision computer objects in Active Directory when there are other child objects, such as printers and file share objects, present on the computer object.

Issue 2
An export-only ECMA1 Management Agent might give the error "There is no primary object class on this image" during export of an object delete operation.

References


See the terminology Microsoft uses to describe software updates.