Skip to main content

Porting Central

Usage instructions for VNC

Some of the tools in the Tools for Developers for i5/OS PRPQ use the X Windowing System to display windows. This would require you to have a Unix or Linux based client as your desktop PC. Alternatively, you could run a product such as Hummingbird Exceed which emulates X on the Windows platform. Yet another alternative is an open source product VNC.

The V4R5M1 and later versions of 5799-PTL include VNC.

If you are using V5R3 of i5/OS you will need to apply PTF 5799PTL SI09622. This PTF resolves a problem that prevents VNC from successfully starting on V5R3 of i5/OS.

To use VNC follow these instructions:

(1) Download and install the VNC viewer. Go to www.RealVNC.com and follow links to download. (You can use the Free Edition, and you need only install the VNC viewer, though it might be packaged with the VNC server. Instead, you will use the VNC server packaged with the Tools for Developers for i5/OS PRPQ, as explained below.)

(2) Create a vnc password file
You only need to do this the first time you want to use VNC and when you want to change your VNC password. Create a passwd file containing your encrypted password by running the following commands on your iSeries box:

    mkdir '/home/youruserid/.vnc'
    QAPTL/VNCPASSWD USEHOME(*NO) PWDFILE('/home/youruserid/.vnc/passwd')

(3) Start the VNC server
Run the following command on i5/OS to start your VNC Server environment:

    STRPTL CLIENT(*VNC)

When the server starts you will see a message similar to the following:
New 'X' desktop is yoursystemname:1

(note that each time another vncserver is started, you will see a different number in the place of :1 in the example above)

(4) Next start the vncviewer you downloaded to your pc earlier:

Starting the VNC Server

Additional information:

 

 
Tool Kit
Overview
Tools list
VNC
OpenSSH
Installation/Setup
FAQs

Topics
Overview
Tailoring
Porting
Infrastructure