IBM Support

How to tunnel VNC over SSH through a Jump Host

How To


Summary

Basic steps to use Xvnc through a jump host.

Environment

ASSUMPTIONS:

This document uses the following names for the systems:

remoteDisplay: This is the PC or Desktop where a VNC Viewer is run.
jumpHost: The AIX System used to connect through the firewall to 'aixClient'.
aixClient: The AIX System where the vncserver and X11 clients are run.

Steps

======================================
On 'aixClient'
======================================

1) Start the vncserver on 'aixClient' (This example uses display number'99')

# vncserver :99

*Tip: If you use UTF-8 locales, you might need to use a fontserver on your vncserver. See Installing and Using the AIX Fontserver

======================================
On 'remoteDisplay'
======================================

2) Invoke ssh from 'remoteDisplay'

# ssh -N -L 5902:aixClient:5999 user@jumpHost

Syntax Summary:

  • jumpHost establishes aixClient as the other end of the tunnel.
  • -N: Do not start a client (the connection will 'hang' until you close the window.)
  • -L 5902 : The connection will originate on port 5902 of 'remoteDisplay'
  • 5902 is used for an example. You can specify any available port.

======================================
On 'aixClient'
======================================

3) Start the vncviewer to connect to vncserver localhost:5902

Additional Information

SUPPORT

If you require more assistance, use the following step-by-step instructions to contact IBM to open a case for software with an active and valid support contract.  

1. Document (or collect screen captures of) all symptoms, errors, and messages related to your issue.

2. Capture any logs or data relevant to the situation.

3. Contact IBM to open a case:

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

4. Provide a clear, concise description of the issue.

 - For guidance, see: Working with IBM AIX Support: Describing the problem.

5. If the system is accessible, collect a system snap, and upload all of the details and data for your case.

 - For guidance, see: Working with IBM AIX Support: Collecting snap data


[{"Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG10","label":"AIX"},"ARM Category":[{"code":"a8m0z000000cw2mAAA","label":"Desktop->X11 Clients"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Document Information

More support for:
AIX

Component:
Desktop->X11 Clients

Software version:
All Version(s)

Document number:
6436077

Modified date:
24 March 2021

UID

ibm16436077

Manage My Notification Subscriptions