Troubleshooting

This troubleshooting guide helps find solutions to the following problems:

• Page Not Found Error (404)
• Access Denied Error (403)
• Http Error 500.19 - Internal Server Error
• Configuration Error
• Can't login - the login box keeps flashing up no matter what I enter
• Unhandled Exception
• Other Problems

Page Not Found Error 404

The page not found error (number 404) is usually caused by the ASP .NET features being unavailable or disabled within IIS. The following solutions are available:

• Either Open up the Contract Eagle Setup Assistant, and click "Reinstall IIS" under the IIS Web Server task.
• Or, if running Windows Server 2003, Open up the IIS Management Console and Allow the ASP .NET v2 Web Service Extension:
  • My Computer
  • -> Right-Click
  • -> Manage
  • -> Services and Applications
  • -> Internet Information Services
  • -> Web Service Extensions
  • -> Click on ASP .NET v2.0.50727

  • -> Click "Allow"

Access Denied Error 403

The access denied error (number 403) is a refusal by the IIS web server to accept your connection to the web site.

The most common cause for this is that your Internet Explorer settings are in a "secure" mode which prevents it from sending its credentials to the website.  The solution to this is to follow the  automatic login instructions for Internet Explorer.

The other possible cause is that the physcial directory on the web server does not have sufficient privileges to be accessed by your Web Server. This is unlikely however as the Contract Eagle setup assistant will update the privileges to ensure they allow access.

Http Error 500.19 - Internal Server Error

This error will occur under WIndows Vista if ASP .NET has not been enabled within IIS.  Either

• Either Open up the Contract Eagle Setup Assistant, and click "Reinstall IIS" under the IIS Web Server task.
• Or Open up the "Programs and features" control panel and enable the feature ASP .NET feature:
  • Start Menu
  • -> Programs and features
  • -> Turn Windows features on or off
  • -> Internet Information Services
  • -> World Wide Web Services
  • -> Application Development Features
  • -> ASP .NET (This must be checked)

Configuration Error

The configuration error  may indicate that the wrong version of the .NET framework has been used to load Contract Eagle.

Windows XP Professional / Windows Server 2003

The .NET framework version is assigned via script mappings that get defined when the Web SIte is set up within the Contract Eagle Setup assistant. To fix the issue:

• Open the Contract Eagle Setup Assistant
• -> Web Site
• -> Click "Remove Application"
• -> Click "Create Application"

With Windows Server 2003 it is important to note that Contract Eagle runs within an application pool and it may not share that application pool with an application running version 1.1 of the .NET framework.

Windows Vista / Windows 7 / WIndows Server 2008

The .NET framework version is assigned to the Application Pool.

• Open the Internet Information Services management console
• Navigate to the "ContractEagle"  virtual directory and examine the "Basic Settings" to see that the application pool assigned (normally the "Default Application Pool" is assigned by default) use .NET framework version 2.0.50727.
• If it doesn't then navigate to "Application Pools" and create a new application pool for version 2.0.50727 of the .NET framework. Then return to the "ContractEagle" virtual directory and use the "Basic Settings" to assign the new application pool.

Can't Login

Note: The article "How to login to Contract Eagle" provides other supporting information that can help you to solve your login issues.

The inability to login normally comes down to one of the following reasons:

• Contract Eagle is not properly installed
• You are using the wrong user id or password
• Internet Explorer uses too high a security restriction and prevents login

• Underlying file-system privileges (NTFS) prevent the web server from seeing Contact Eagle.

Contract Eagle is not properly installed

Contract Eagle requires certain website configurations that are made during installation. These include the disabling of anonymous access and the enabling of Integrated (NTLM) authentication or Plain Text authentication (for Windows Vista Home Premium Edition and Windows 7 Home Premium Edition).

To ensure that configurations are made correctly you may open the Contract Eagle Setup Assistant and ensure that there are no installation issues that require attention. If everything has a check (tick) then nothing is required here.

Under IIS version 7.0 and later it is possible to install IIS without the "Integrated Authentication" or "Plain Text" features available. The Contract Eagle Setup assistant does not explicitly test for the availability of these features, however you may use the "Reinstall IIS" feature within the Contract Eagle setup assistant to ensure these features are enabled.

Unhandled Exception

When you attempt to run Contract Eagle but your browser simply states that an unhandled exception has occurred this may be a permissions issue with your system.  Please click here for the solution.

Other Problems

Most problems will be fixed via the following processes:

1. Reinstall IIS (Use the button in the Contract Eagle Setup Assistant or, if using Windows XP, following the instructions here.
2. Register or Reinstall the .Net framework using the "aspnet_regiis" tool, which is described here. The only framework version you need to register is v2.0.50727. The commands you use to do this should either be "aspnet_regiis -iru" or "aspnet_regiis -i".
3. Open up the Contract Eagle Setup Assistant and ensure that all tasks have a "check" (tick) next to them.
4. Within the Contract Eagle setup assistant "delete" and "create" the application within the "Website" section.
5. Restart windows.

If you've still got problems contact Contract Eagle support here.