AMHealth Discovery Initialization error

  • 7016697
  • 21-Jul-2015
  • 21-Jul-2015

Environment

AppManager Agent 8.2
AppManager Agent 8.0.x
AppManager for Self-Monitoring (AMHealth)

Situation

You receive the following error message when trying to run the Discovery_AMHealth:
 
Short Message:      Discovery Job Initialization error
Detail Message:     Failed to initialize SQL Common Object, verify agent install. Error:

                               ActiveX component can't create object

Resolution

Verify that you have .NET Framework 2.0 installed on the Agent Machine.  If .NET Framework 2.0 is not installed, please install .NET Framework 2.0 on the Agent Machine.

You can check what versions of .NET Framework that you have installed by viewing the following directories:

    - %windir%\Microsoft.NET\Framework
    - %windir%\Microsoft.NET\Framework64

    There you will find folders that are name “v<VersionNumber>” (Example “v2.0.50727”)

Once you have installed .NET Framework 2.0 you will then have to register the NQCommonSQL.dll. Please follow these steps for registering:

    1) Open an Administrator Command Prompt on the Agent Machine and navigate to the following directory:

        cd "<Install Path>\NetIQ\AppManager\bin"
   
        Where <Install Path> is the path to the NetIQ install directory

    2) Run the following two commands to register the DLL file:

        %windir%\Microsoft.NET\Framework\<v2.0>\RegAsm.exe NQCommonSQL.dll
        %windir%\Microsoft.NET\Framework64\<v2.0>\RegAsm.exe NQCommonSQL.dll
           
        Where <v2.0> is the .NET Framework version that is installed on your machine. Please check “%windir%\Microsoft.NET\Framework\” for you 2.0 version number.

        Example: %windir%\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe NQCommonSQL.dll

After registering the DLL files, rerun Discovery_AMHealth and verify that AMHealth Discovers successfully.

Cause

The AppManager for Windows OS module does not install .NET Framework 2.0.  It does install and register the NQCommonSQL.dll.  The NQCommonSQL.dll requires .NET Framework 2.0 in order to be registered during the Windows OS module installation.  If .NET 2.0 was not present on the Agent at the time that the Windows OS module was applied to the Agent, the installer would have been unable to register the NQCommonSQL.dll file, and as a result, Discovery_AMHealth will generate an initialization failure.