IBM Support

"The underlying connection was closed: An unexpected error occurred on a receive" when launching Controller client, caused by disabling some SSL/TLS protocols



User launches Controller client. User receives an error.


An error occurred while trying to access the server


The underlying connection was closed: An unexpected error occurred on a receive.
at System.Web.Services.Protocols.WebClientProtocol.GetWebResponse(WebRequest request)
at System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(String methodName, Object[] parameters)
at Cognos.Controller.ControllerSoapHttpClientProtocol.Invoke(String methodname, Object[] parameters)
at Cognos.Controller.Proxy.Light.WSLight.CheckServerConnection(String sGuid, String sUser)
at Cognos.Controller.Direct.ServerInfoD.CheckServerConnection()
at CCR.AppContext.CheckConnectionToServer()


There are several known causes for this error.

  • See separate IBM Technote #0741571 for more examples.

This Technote specifically relates to the scenario where the cause is that both of the following are true:

  • Controller client configured to use SSL (HTTPS) for its communication (to the Controller application server)
  • Client (and/or the application server) has been configured to disable some required SSL/TLS communication protocols.


In one real-life example, the client device has been configured so that only the following protocols are enabled:

Specifically, the following protocols were disabled:

  • TLS 1.0
  • TLS 1.1

Resolving The Problem


Reconfigure all of Controller to force the use of TLS 1.2.

  • TIP: For instructions, see separate IBM Technote #0883036.


Reconfigure the client device (plus also the application server if necessary) so that the required protocols are enabled.


In one real-life example, the solution was to reconfigure the client device so that it allowed the following protocols:

Specifically, enabling:

  • TLS 1.0
  • TLS 1.1

[{"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Controller","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.3","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
30 April 2019