How to enable Workflow operations within DRA

  • 7016201
  • 17-Feb-2015
  • 31-Aug-2018

Environment

NetIQ Directory and Resource Administrator 8.7.x
NetIQ Directory and Resource Administrator 9.0.x
NetIQ Directory and Resource Administrator 9.1.x

NetIQ Aegis 3.2
NetIQ Directory and Resource Administrator 9.1.x Workflow Automation 3.3

Situation

How to configure DRA to generate workflow events for use by Aegis.

How to register DRA and Aegis interoperability DLLs.

How to configure the Aegis Business service connection for DRA.

Resolution

Configure the DRA to Aegis connection details
  1. Launch an Administrator 32 bit CMD Prompt (Located in C:\Windows\syswow64\cmd.exe)
  2. Using 32bit version of cscript.exe (Located in C:\Windows\syswow64) run the following CMD
  3. cscript.exe <Path to the DRA Program Files location (Default: C:\Program Files (X86)\Netiq\DRA)> ConfigureAegisSettings.vbs
    1. Fill in the required information via the prompts
    1. Hitting enter at a prompt will leave the previous values in place
    2. The values configured by the script are stored under HKLM\Software\Wow6432\Mission Critical Software\OnePoint\Administration\Data\Modules\AegisIntegration ; and are encrypted.
Register the DRA Application DLLS 
  1. Launch an Administrator 32bit CMD Prompt (Located in c:\Windows\syswow64\cmd.exe)
  2. Register the Aegis Operations Library and Legacy Web Console Library Files
    1. Launch a Windows Administrator CMD prompt to the DRA Application Path (Default C:\Program Files (X86)\Netiq\DRA
      1. regsvr32 NqAegisOperations.dll
        1. Note: This applies to DRA 8.7.x thru DRA 9.1.x
      2. regsvr32 DraWcAegisUtility.dll
        1. Note: This file applies only to the legacy ASP Web Console. This file must be registered on the OS hosting the IIS site for the legacy web console (Default URL http://<IISServer/DRA)
    1. Register the Aegis operations library with the Windows DOT Net Subsystem
      1. Launch a Windows Administrator CMD Prompt to the Microsoft DOT Net Framework Path (Default c:\Windows\Microsoft.NET\Framework\v4.0.30319\) and rnn
        1. RegAsm.exe NetIQ.DRA.Interop.Aegis.dll

Import the Aegis Workflow Registry settings into the Windows Registry

  1. Use the 32 Windows Registry Editor, located within the c:\Windows\SysWOW64\Regedit.exe path
  2. For DRA 8.7 and DRA 9.0 import the following Registry Files:
    1. <Path to DRA Program Files (Default C:\Program Files (X86)\Netiq\DRA)>\NqAegisOperations.reg
    2. <Path to DRA Program Files (Default C:\Program Files (X86)\Netiq\DRA)>\NqAegisOperationsPowerTemplate.reg
  3. For DRA 9.1 import the following Registry Files:
    1. <Path to DRA Program Files (Default C:\Program Files (X86)\Netiq\DRA)>\NqRequestOperations.reg
    2. <Path to DRA Program Files (Default C:\Program Files (X86)\Netiq\DRA)>\NqRequestOperationsPowerTemplate.reg

After all of the above steps are completed, restart the NetIQ Administration Service

Additional Information

Before editing the Windows Registry, it is recommended to have a valid backup in place.

These steps must be performed on EVERY DRA Server, as the configuration data modified does not replicate globally to all DRA servers.

The values entered using the ConfigureAegisSettings.VBS script should be the exact same for every DRA Server as well.

This KB does NOT apply to versions of DRA from version 9.2 , and newer.

For details on the DRA 9.2 DRA Server to Workflow Server configuration, including post upgrade steps; please see: www.netiq.com/documentation