Aegis Web Console generates error when login prompt should be presented

  • 7015907
  • 18-Nov-2014
  • 18-Nov-2014

Environment

NetIQ Aegis 3.0
NetIQ Aegis 3.1
NetIQ Aegis 3.2
Aegis Web Operations Console

Situation

Error received after attempting to launch Web Console:  'Could not initialize the application'.  The error occurs at the moment where you would expect the Log-on Prompt to appear in the Web UI.

Resolution

To correct this issue, you will need to edit a config file as follows:

  1. Edit the following file, using a text editor:

    <install path>\NetIQ\Aegis\AegisWebApp\web.config

    Note that you will need to edit the file "as Administrator", or you will need to save your changes to a file in another directory (making sure to name the file web.config), and then copy the modified file over the original in the above directory.

  2. Once you have the web.config file opened within an editor (Notepad will suffice), navigate to the following section:

    <authentication mode="Windows" />
    <identity impersonate="true" />
    <httpRuntime requestValidationMode="2.0" />

  3. To correct the error, you will need to change the first two lines as follows:

    <authentication mode="None" />
    <identity impersonate="false" />
    <httpRuntime requestValidationMode="2.0" />

  4. Once the change is made, close the Web.Config file (making sure to save your changes).

  5. Ensure that the updated web.config file is present in the path from Step 1.
This will then allow you to launch a new copy of the Web Console, and be presented with the expected Log-on Prompt.

Cause

In some rare cases during the Aegis Web Component installation, security settings in IIS (such as Group Policies, or the system's own Security settings) may prevent you from installing the Web Components with Windows Authentication enabled.

However, it is possible that despite these restrictions, the installer may still succeed in setting the 'Windows' authentication type in the Web Operator Console's config file.  This will result in the Web Console throwing an error when it tries to launch the Log-on Prompt at start-up, because IIS will not be willing to accept the Windows Authentication setting.