IBM Support

MUSTGATHER: Getting assistance for X11 errors through AIX Support

General Page

This document describes information required to get prompt resolutions for X11 issues through IBM AIX Support.


1.  Describe the error, provide exact codes, etc.

2.  Describe the graphical environment, including the OS and location of the physical display

  • See TABLE 1 BELOW

3.  Fully describe the steps you are taking to invoke the X11 client, including the method to connect to AIX 

  • See TABLE 1 BELOW

4.  If you require SSH X11 forwarding, confirm the enablement as follows:

From a remote desktop (where an X server/emulator is running)

  i)  ssh -X to AIX system (this can be on command line, or through the terminal emulator configured for X11 forwarding)

 ii)  Once logged in to AIX "echo $DISPLAY"

     * If DISPLAY is not set (localhost:n.0 by default),  then X11 forwarding is not enabled.

     * You should not have to set the DISPLAY when X11 forwarding is properly configured.

     * Be sure the following is enabled in /etc/ssh/sshd_config : X11Forwarding yes

 *** Known Issue: X11 forwarding fails in OpenSSH 7.1.102.1100 and 7.5.102.1100
     http://www-01.ibm.com/support/docview.wss?uid=ibm10716755

 *** You can collect sshd debug which will assist the support team with analysis 
     How to collect SSHD debug for X11 Forwarding issues

TABLE 1:  Required Info (Minimum)

Please note: Since there are many varying configurations possible, full details are essential to quick resolution.

CONFIGURATION QUESTIONS ANSWER
1 DISPLAY PRODUCT:  This is the graphical Xserver/X emulator (Hummingbird, Xming, Exceed, Linux, etc)
2 DISPLAY LOCATION:  Local AIX console or remote PC
3 DISPLAY IP AND HOSTNAME:  
4 SSH OR TELNET?:  Specify connection type
5 SSH/TELNET CLIENT:  Putty, xterm, etc
6 SSH/TELNET CLIENT LOCATION:  Local AIX console or remote PC
7 USING X11 FORWARDING?:  Yes/No
  **IF YES **  
7.1 X11 FORWARDING ENABLED?:  grep X11Forwarding /etc/ssh/sshd_config. Upload /etc/ssh/sshd_config for further review.
7.2 SSH CLIENT CONFIGURATION :  Describe configuration details
For example   
Putty configuration ->   
X11--> X11 Forwarding   
  -->Enable X11 Forwarding is enabled  
  -->X Display Location value   
  -->Remote Authentication Protocol  
  Tunnels--> Describe any settings in these fields  
8 CONNECTION SEQUENCE:
Describe all connection steps.  
If using an Xserver Emulator (Exceed, Xming, etc.,) describe all steps to connect to the
AIX host (XDMCP... SSH..etc ..)  
Provide details from any session configuration files
For example
On <hostname>
SSH/Telnet to <hostname>
Run <command>

 
SUPPORT

If additional assistance is required after completing all of the instructions provided in this document, please follow the step-by-step instructions below to contact IBM to open a case for software under warranty or with an active and valid support contract.  The technical support specialist assigned to your case will confirm that you have completed these steps.

1.  Document and/or take screen shots of all symptoms, errors, and/or messages that might have occurred. 

2.  Capture any logs or data relevant to the situation, including the information from the "TABLE 1: Required Info (Minimum) above"

3.  Contact IBM to open a case:

   -For electronic support, please visit the IBM Support Community:
     https://www.ibm.com/mysupport
   -If you require telephone support, please visit the web page:
      https://www.ibm.com/planetwide/

4.  Provide a good description of your issue, and reference this Technote, and any issues you had with the instructions.

5.  Collect the system snap and upload all of the details and data for your case.

To collect a complete snap of your system information:

5.1) Remove previously gathered data

   # snap -r

5.2) Copy related files from #1 and #2 to the snap data directory

   # mkdir -p /tmp/ibmsupt/testcase
   # cp <logs, screenshots, etc> /tmp/ibmsupt/testcase

5.3) Run the snap command with one of the following options to collect all info.

     * If you have already engaged with a support engineer, use the flags specified by your support team.
   # snap -aZc (Omits system dump data)   
     OR 
   # snap -ac (Use if system dump data is needed)

5.4) Rename the testcase to include your case number to ensure it is properly attached to your case

  # mv /tmp/ibmsupt/snap.pax.Z /tmp/ibmsupt/yourcase#[.optional_description].snap.pax.Z

5.5) Upload the file by one of the following options (a, b, or c)

     a) Attach to your case
     https://www.ibm.com/mysupport/s/my-cases

     b) Upload to the Enhanced Customer Data Repository(ECuRep) 
     https://www.secure.ecurep.ibm.com/app/upload_sf

     c) Upload to the Blue Diamond FTP server (Blue Diamond Customers Only)
     https://msciportal.im-ies.ibm.com

* Note: For information about blue diamond upload see:

     http://www.ibm.com/support/docview.wss?uid=nas8N1020947

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG10","label":"AIX"},"Component":"X11","Platform":[{"code":"PF002","label":"AIX"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
12 April 2019

UID

ibm10719953

Page Feedback