Troubleshooting
Problem
This document describes the process for collecting data for problems with the SPNEGO component on IBM WebSphere® Application Server traditional. Gathering this MustGather information before you call IBM support can help you understand the problem and save time analyzing the data.
Resolving The Problem
Runtime:
This document is for collecting data for WEBSPHERE TRADITIONAL. If you want to collect data for Liberty, see MustGather: SPNEGO problems on WebSphere Liberty or click the Liberty tab above.
- Read first and related MustGathers
MustGather: Read first for WebSphere Application Server and Liberty
EJB container problem Servlet engine and Web container problem Security problem
For a listing of all technotes, downloads, and educational materials specific to the Security component, search the WebSphere Application Server support portal.
- Exchange data with IBM Support
To diagnose or identify a problem, it is sometimes necessary to provide Technical Support with data and information from your system. In addition, Technical Support might also need to provide you with tools or utilities to be used in problem determination. You can submit files by using one of following methods to help speed problem diagnosis:
- Service Request (SR)
- FTP to the Enhanced Customer Data Repository (ECuRep)
- SPNEGO on WebSphere traditional trace specifications
- Java ™ Virtual Machine (JVM) properties:
Name: com.ibm.security.jgss.debug
Value: all
Name: com.ibm.security.krb5.Krb5Debug
Value: all
- Diagnostic trace specification:
*=info:SecurityDomain=all:com.ibm.ws.security.*=all:com.ibm.websphere.security.*=all:com.ibm.wsspi.security.*=all
- Java ™ Virtual Machine (JVM) properties:
- Diagnostic questions
Provide answers to the following diagnostic questions:
- Obtain versions information:
WebSphere Application Server version :
Active Directory version :
Client OS version : - What is the full web request URL accessed by the client browser?
- Is the requested hostname a DNS alias (CNAME Record) or real hostname (A Record)?
- What Active Directory user ID is used to map to the wanted SPN's?
Provide a screen capture of the Active Directory User properties Account Tab for this user. - Provide the commands issued to create the keytab and SPN-mappings on the AD server.
- If possible, also provide the command output.
- Provide screen captures of SPN hostname filter entries in the WebSphere admin console.
- Are more SPNEGO filter criteria being used?
- If yes, what are they?
- Find all SPN-mapping occurrences mapped to AD user names; on the Active Directory Server, run following command:
C:\ldifde -f output.txt -r "(servicePrincipalName=HTTP/hostname.domain.com)" - Are there any load balancers, firewalls, proxies, or web servers in the mix, or any devices/appliances between the client browser and WebSphere?
- If so, provide basic login flow details with relevant topology involved.
- Is this a single Active Directory domain or do you have trusted domains/forests?
- Elaborate if the latter.
- Screen captures of client browser SPNEGO settings.
- Provide your krb5 config and keytab files.
- Is SPNEGO configured within a security domain?
- If so, provide the ../<profile_root>/config/waspolicies directory.
- Obtain versions information:
- Collect data for WebSphere traditional (step by step)
This section is for collecting data for WEBSPHERE TRADITIONAL. If you want to collect data for Liberty click here or see the Liberty tab above.
Before you collect data, be sure to answer the Diagnostic questions in the section above.
You may choose to follow this step-by-step document or you can watch the video in the Collect data for WebSphere traditional (Video) section.
SPNEGO issues on WebSphere may be difficult to troubleshoot. Make sure to collect all the information below. When all the information for your issue is ready, follow the instructions on Exchanging information with IBM Technical Support for problem determination to send the information and files that you collected.
SET UP WEBSPHERE TRADITIONAL FOR SPNEGO TRACING
NOTE: If possible, when capturing the traces, attempt a re-create using the default application /snoop servlet instead of any custom application. This can help rule out any application issues and confirm if SPNEGO configuration is truly working or not.
Set up the JVM for SPNEGO tracing:- In the administrative console, navigate to Servers > Application Servers > server_name. Under Server Infrastructure, expand Java and process management. Click Process Definition > Java Virtual Machine > Custom Properties. Create two new Java ™ Virtual Machine (JVM) properties:
Name: com.ibm.security.jgss.debug
Value: all
Name: com.ibm.security.krb5.Krb5Debug
Value: all
Set up the WebSphere traditional for SPNEGO tracing:- Expand TroubleShooting > Logs and Trace > server_name.
- Click Diagnostic Trace Service. Increase the Maximum Number of Historical Files from 1 to 10.
- Click Apply, then click Change Log Detail Levels.
- Clear the trace string in the box and replace it with the following trace string:
*=info:SecurityDomain=all:com.ibm.ws.security.*=all:com.ibm.websphere.security.*=all:com.ibm.websphere.wim.*=all:com.ibm.wsspi.wim.*=all:com.ibm.ws.wim.*=all - Click Apply, and Save.
COLLECT WEBSPHERE TRADITIONAL SPNEGO TRACES
Stop the server and clean the logs, re-create the issue, so we have a fresh and concise set of information- Stop the server and delete or rename all the logs in the profile_home/logs directory. Then restart the server.
- Reproduce the problem, making note of the following information:
Time when the problem occurs
The client user ID which logged in to the Microsoft Domain
The Microsoft Domain name itself
The exact URL being invoked.
GATHER WEBSPHERE TRADITIONAL SPNEGO DATA TO SEND TO IBM SUPPORT
- Run the Collector Tool, which is located in the profile_home/bin directory, on both Network Deployment (for federated environment only) and base Application Server profiles.
- In the administrative console, navigate to Servers > Application Servers > server_name. Under Server Infrastructure, expand Java and process management. Click Process Definition > Java Virtual Machine > Custom Properties. Create two new Java ™ Virtual Machine (JVM) properties:
- Collect data for WebSphere traditional (Video)
This section is for collecting data for Problems with SPNEGO on WebSphere traditional. If you want to collect data for Problems with SPNEGO on WebSphere Liberty click here or see the Liberty tab above.
Before you collect data, be sure to answer the Diagnostic questions in the section above.
You may choose to watch this video or follow the step-by-step instructions in the Collect data for WebSphere traditional (step by step) section.
SPNEGO issues on WebSphere may be difficult to troubleshoot. Make sure to collect all the information described in the video. When all the information for your issue is ready, follow the instructions on Exchanging information with IBM Technical Support for problem determination to send the information and files that you collected.
The following video goes over the necessary steps to collect data for a SPNEGO problem on WebSphere traditional.
Note:
Related Information
Was this topic helpful?
Document Information
Modified date:
26 September 2022
UID
swg21255030