Troubleshooting the configuration

If any of your users experience problems when connecting to a Reflection ZFE web application after you have made the configuration changes, check the following:

  • Users experience a 503 Service Unavailable message when connecting to a Reflection ZFE web application. First check the log file (<session-server>/logs/server.log), then:

    • -- If the log file contains this message: “Unable to create AnonymousPrincipalNameProvider instance for class...”, then the zfe.principal.name.provider property is probably mis-typed. Check the spelling and letter case to remedy this issue.
    • --If the log file contains this message:”zfe.principal.name.identifier is not defined”, then the property is missing. Ensure the property is defined to remedy this issue.

  • Users are unable to properly authenticate.

    Users should receive an error message indicating the initial HTTP request to the Reflection ZFE web application did not contain the required information.