What is the purpose of Aegis Adapter for DRA 2.0 Hotfix 7012466?

Hotfix

This hotfix resolves specific previous issues. This document outlines why you should install this hotfix. Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure our products meet all your needs. You can post feedback in the Directory and Resource Administrator forum, our community Web site that also includes product notifications, blogs, and product user groups.

For more information about this release and for the latest release notes, see the Directory and Resource Administrator Documentation Web site. To download this product, see the Directory and Resource Administrator Product Upgrade Web site.

What's New?
This hotfix adds new configuration options to control how frequently the DRA Adapter performs certain background tasks.

The default interval for how often the DRA Adapter polls the configured DRA servers for changes to the MMS topology and the managed domains and servers has been increased from 1 minute to 27 minutes. The default interval for registering resources with IQRM remains 1 hour.

These two intervals can be controlled by the following registry keys that the DRA Adapter will read when the Aegis Namespace service starts. Both are DWORD and represent the desired interval in seconds:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NetIQ\AegisIQConnect73\providers\IQDRA\DraConnectionInterval
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NetIQ\AegisIQConnect73\providers\IQDRA\IqrmRegistrationInterval
With this hotfix, the DRA Adapter provider is now multithreaded. The number of simultaneously executing adapter threads is controlled by the following registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NetIQ\AegisIQConnect73\providers\IQDRA\threadPoolSizeThe default value is 5.
The value can be increased to allow the adapter to handle more requests from different workflows and activities at the same time.

 Note
Setting the value too high will adversely affect performance as the overhead incurred by the system in managing the threads outweighs the gains of being multi-threaded. Testing has shown that a value of 20 is not unreasonable dependending on your operating system and hardware.
 

Enhancements and Software Fixes
NetIQ Aegis Adapter for NetIQ Directory and Resource Administrator Hotfix 7012466 includes software fixes that resolve several previous issues.

Check Power Over Object Does Not Return True Unless User is a DRA Administrator
Modifying the Name in Modify User Activity Generates Error
Restore from Recycle Bin Activity Fails After 60 Seconds
Adding an Alias in the Modify Group Activity Generates Not enabled EmailAddress Error
Creating Mailboxes for New Users With the Create Exchange Mailbox Activity Generates The Exchange Administration Support is Not Enabled in DRA Server Error
Aegis Workflows Fail if DRA Sever is Unavailable
Get Object Properties Activity Generates Execution Time Execution Status Error
Add Member to Group Activity Takes Too Long to Complete.
Check Power Over Object Does Not Return True Unless User is a DRA Administrator
After you install this hotfix, the Check Power Over Object activity can return a value of True, even if the specified user is not a DRA Admin. (ENG327425)

Modifying the Name in Modify User Activity Generates Error
After you install this hotfix, modifying a user name in the Modify User Activity no longer generates the error Length cannot be less than 0 during the workflow. (ENG327436)

Restore from Recycle Bin Activity Fails After 60 Seconds
After you install this hotfix, the Recycle Bin activity no longer attempts to return all recycle bin objects and only returns the requested object. (ENG322739)

Adding an Alias in the Modify Group Activity Generates Not enabled EmailAddress Error
After you install this hotfix, you must manually update the IQDRA activity library to include a new activity introduced with this hotfix. The new library definition installs to the Aegis hotfix directory, by default: (C:\Program Files (x86)\NetIQ\Aegis\IQConnect73\HotFixes\AegisDRAAdapter_Hotfix7012466).

Complete the following steps to update the activity library.

Open the Aegis Configuration Console.
Open the Workflow editor to create a new process or edit an existing one.
Select Activity Library.
Click Delete libraries and delete the NetIQ Directory and Resource Administrator (NetIQ) activity library.
Click the Import library button and select NetIQ Directory and Resource Administrator (NetIQ).nxlb.
These steps are only required to get the new Establish group email address activity to show up in the activity library browser. All other fixes and features are available by running the hotfix installer. (ENG326694)

Creating Mailboxes for New Users With the Create Exchange Mailbox Activity Generates The Exchange Administration Support is Not Enabled in DRA Server Error
After you install this hotfix, creating mailboxes for new users with the Create Exchange Mailbox Activity no longer generates an error. (ENG325313)

Aegis Workflows Fail if DRA Sever is Unavailable
Before you install this hotfix, the DRA Adapter opens a single connection to each DRA server when the DRA Adapter starts, and that connection is used for the lifetime of the DRA Adapter. If the DRA server stops responding, the connection is invalidated, and all subsequent calls fail until you restart the namespace service.

After you install this hotfix, the adapter opens and closes a new connection for each call to DRA. If any connection error does occur, the DRA Adapter will attempt to reconnect on the next operation attempt. While an activity may fail when the connection is dropped, once DRA is back online all subsequent activities will succeed without requiring the namespace service to be restarted. (ENG327161)

Get Object Properties Activity Generates Execution Time Execution Status Error
Before you install this hotfix, the background update threads slow down the the DRA Adapter provider such that it would not respond to activities.

After you install this hotfix, the DRA Adapter provider is now multithreaded. The number of simultaneously executing adapter threads is controlled by the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NetIQ\AegisIQConnect73\providers\IQDRA\threadPoolSize. The default value for IQRM resource registration is 1 hour and the DRA connection interval is 27 minutes. (ENG327954)

Add Member to Group Activity Takes Too Long to Complete
After you install this hotfix, the Add Member to Group activity completes in an appropriate amount of time during the workflow. (ENG328450)

System Requirements
This hotfix requires NetIQ Aegis Adapter for NetIQ Directory and Resource Administrator Version 2.0.

Installing This Hotfix
Complete the following steps to install this hotfix.

To install:

Log on to the Aegis Server computer with a local administrator account.
Run the AegisDRAAdapter20_Hotfix7012466.exe file.
Follow the instructions in the wizard until you have finished installing the hotfix.

Modified Files
This hotfix modifies the following files (Build 179) in the client installation folder, by default %Program Files%\NetIQ\Aegis:

\IQConnect73\bin\IQDRA.dll
\IQConnect73\bin\IQDRA.pdb
\IQConnect73\bin\IQDRAUtil_2_0.dll
\IQConnect73\bin\IQDRAUtil_2_0.pdb
\IQConnect73\bin\NetIQDRA_2_0.dll
\IQConnect73\bin\NetIQDRA_2_0.pdb
\pgapps\NetIQDRA_2_0\bin\IQDRAUtil_2_0.dll
\pgapps\NetIQDRA_2_0\bin\IQDRAUtil_2_0.pdb
\pgapps\NetIQDRA_2_0\bin\NetIQDRA_2_0.dll
\pgapps\NetIQDRA_2_0\bin\NetIQDRA_2_0.pdb
\pgapps\cat\en-US\46.cat

This hotfix addresses issues found in the Aegis Adapter for DRA 2.0.