Scribd
Upload
258 views2 pages

ICM Web Dispatcher Does Not Launch Auth Handler Fails

The document describes an SAP note about ICM or the Web Dispatcher failing to start due to an authentication handler configuration error. The error prevents startup for security reasons. Common causes are incorrect configuration of the authentication handler parameter or permission errors accessing related files. The solution is to correct the configuration or set related parameters to blank as a workaround.

Uploaded by

ankurbamel
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
258 views2 pages

ICM Web Dispatcher Does Not Launch Auth Handler Fails

The document describes an SAP note about ICM or the Web Dispatcher failing to start due to an authentication handler configuration error. The error prevents startup for security reasons. Common causes are incorrect configuration of the authentication handler parameter or permission errors accessing related files. The solution is to correct the configuration or set related parameters to blank as a workaround.

Uploaded by

ankurbamel
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 2

SAP Note

1916794 - ICM/Web Dispatcher does not launch: auth handler fails


Component: BC-CST-IC (Internet Communication Manager), Version: 1, Released On: 07.11.2013

Symptom
ICM or the Web Dispatcher do not start because the auth handler cannot be initialized. The
reason for this is a configuration error.

Since this involves a security-relevant configuration, the launch of ICM or the Web
dispatcher is prevented in current releases.

The trace file (dev_icm or dev_webdisp) and the standard error output (stderr) contain a
message, such as

"FATAL: HttpAuthHandlerInit: Failed to open perm file permfile.txt"

Several common configuration errors are listed in the "Solution" section.

Other Terms

Reason and Prerequisites


The cause is an incorrect configuration of the auth handler (profile parameter
icm/HTTP/auth_< n >).

The response has been changed in Release 7.40 and later, so ICM and the Web Dispatcher do
not start if the auth handler is configured incorrectly.

The exact cause of the error can be determined based on the error message.

Solution
Correct the configuration problems.

As a workaround, you can set the following profile parameters to a blank value:
icm/HTTP/auth_0=
(In rare cases, several rewrite handlers are configured. In this case, you also have to set
icm/HTTP/auth_2, for example, to a blank value.)

A list of the most frequent error messages follows:


"Failed to open perm file <file name>":
The file specified in the PERMFILE parameter could not be opened. Make sure the
file exists and that the user of the instance has read access.
"Syntax error in perm file <file name>":
The file specified in the PERMFILE parameter has incorrect syntax.
"Failed to open auth file <file name>":
The file specified in the AUTHFILE parameter could not be opened. Make sure the
file exists and that the user of the instance has read access.

"Failed to load content filter":


The SAP content filter could not be loaded. Make sure the content scan library
exists and that the user of the instance has access. The content scan library is specified
in the profile parameter csi/SAP/csa_lib.

Manual Activities

Attributes
Key Value

Other Components BC-CST-WDP (Web Dispatcher)

Software Components
Software Component And subsequent

KRNL64NUC

KRNL64NUC

KRNL64UC

KRNL64UC

KERNEL

KERNEL

Support Package Patches


Software Component Version Patch Level Patch Level

SAP KERNEL 7.41 64-BIT UNICODE SP009 000009


SAP KERNEL 7.41 64-BIT SP009 000009


SAP KERNEL 7.41 64-BIT UNICODE SP010 000010


SAP KERNEL 7.41 64-BIT SP010 000010


SAP KERNEL 7.40 64-BIT SP043 000043


SAP KERNEL 7.40 64-BIT SP044 000044


SAP KERNEL 7.40 64-BIT UNICODE SP043 000043


SAP KERNEL 7.40 64-BIT UNICODE SP044 000044


This document is referenced by


SAP Note/KBA Title

You might also like