IBM Support

** Troubleshooting ** "The request failed with HTTP status 401: Unauthorized" when launching Controller client

Troubleshooting


Problem

User launches Controller. User receives error.

Symptom


An error occurred while trying to access the server

Details:
The request failed with HTTP status 401: Unauthorized

Cause

There are several possible causes for this error:

 

Scenario #1 (most likely) - The end user is logged onto Windows (on the client device) using a Windows userID that is not authorised to logon to the Controller application server's website.
  • See separate IBM Technote #2004400 for more details.
 
Scenario #2 - The Controller application server's website (IIS) has been incorrectly configured to have no enabled providers.
  • See separate IBM Technote #1662830 for more details.
  

Scenario #3 - The Controller application server's website (IIS) has been incorrectly configured to have "Enable Kernel-mode authentication" disabled.
  • See separate IBM Technote #1662742 for more details.
  

Scenario #4 - (Rare) The gateway server's subsystem cannot connect to the Controller application server's website, because it cannot successfully re-use the end user's Windows credentials.
  • See separate IBM Technote #1653226 for more details.

Resolving The Problem

Scenario #1 (most likely)

Logon to the client device using a Windows userID that is authorised to logon to the Controller application server's website.

  • See separate IBM Technote #2004400 for more details.
 

Scenario #2

Enable the relevant provider(s) on the Controller application server.
  • See separate IBM Technote #1662830 for more details.
 

Scenario #3

Enable "Enable Kernel-mode authentication" on the Controller application server.
  • See separate IBM Technote #1662742 for more details.
 

Scenario #4 (Rare - only for environments using t=controller)

Reconfigure 'main' Controller application server's 'controllerserver' IIS virtual directory to use anonymous authentication.
  • See separate IBM Technote #1653226 for more details.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"ARM Category":[{"code":"a8m0z000000Gmx2AAC","label":"Error"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Version(s)","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
21 July 2020

UID

swg22004398

Page Feedback