Add ipv6 hint
[linux_from_scratch_hints.git] / tightvnc.txt
blobc2b3beb80e3ad44e713f6df75da217588d78dd70
1 AUTHOR:         Jim Gifford <lfs-hints at jg555.com>
3 DATE:           2003-10-09
5 LICENSE: GNU Free Documentation License Version 1.2
7 SYNOPSIS:       Setup Tightvnc for LFS
9 DESCRIPTION:    This hint will show you how to setup tightvnc
10                 to access a desktop over the internet.
11         
12 PREREQUISITES:  Xinetd Xfree86 kdm or gdm
14 HINT:
15 Introduction to tightvnc
17 Download location       http://osdn.dl.sourceforge.net/sourceforge/vnc-tight
18 Version used            1.2.9
20 VNC (an abbreviation for Virtual Network Computing) is a great client/server
21 software package allowing remote network access to graphical desktops. With
22 VNC, you can access your machine from everywhere provided that your machine
23 is connected to the Internet. 
25 ---
26 Installation of tightvnc
28 Install tightvnc by running the following commands:
30                 xmkmf
31                 make World
32                 cd Xvnc 
33                 /configure
34                 make -s
35                 ./vncinstall /usr/vnc/bin /usr/vnc/man
36                 mkdir /usr/vnc/classes
37                 cp classes/* /usr/vnc/classes
39 ----
40 Configuring kdm
42 Important NOTE:: Files may be in a different location. It depends on your 
43 installation.
45 Config files
47 /etc/X11/xdm/xdm-config
49 Comment out the entry "DisplayManager.requestPort: 0" by adding a !.
50 The line should look like this "! DisplayManager.requestPort: 0".
52 /opt/kde3/share/config/kdm/kdmrc
54 Locate the line XDMCP and change it from false to true.
56 /etc/X11/xdm/Xaccess
58 Uncomment out the entry "# *    #any host can get a login window" by remove
59 the first #. The line should look like this
60 " *     #any host can get a login window".
62 ----
63 Configuring gdm
65 Important NOTE:: Files may be in a different location. It depends on your
66 installation.
68 Config files
70 /etc/X11/xdm/xdm-config
72 Comment out the entry "DisplayManager.requestPort: 0" by adding a !.
73 The line should look like this "! DisplayManager.requestPort: 0".
75 Run gdm-config
77 Start gdmconfig. Select Expert Mode. Ensure that Enable XDMCP is 
78 checked
80 Locate the line XDMCP and change it from false to true.
82 /etc/X11/xdm/Xaccess
84 Uncomment out the entry "# *    #any host can get a login window" by remove
85 the first #. The line should look like this
86 " *     #any host can get a login window".
88 ----
89 Configuring xinetd
91 /etc/services 
93 Edit the services file and add the following entries.
95 # VNC Ports
96 vnc-640x480x8           5950/tcp
97 vnc-800x600x8           5951/tcp
98 vnc-1024x768x8          5952/tcp
99 vnc-1280x1024x8         5953/tcp
100 vnc-1600x1200x8         5954/tcp
101 vnc-640x480x16          5960/tcp
102 vnc-800x600x16          5961/tcp
103 vnc-1024x768x16         5962/tcp
104 vnc-1280x1024x16        5963/tcp
105 vnc-1600x1200x16        5964/tcp
106 vnc-640x480x24          5970/tcp
107 vnc-800x600x24          5971/tcp
108 vnc-1024x768x24         5972/tcp
109 vnc-1280x1024x24        5973/tcp
110 vnc-1600x1200x24        5974/tcp
111 vnc-640x480x32          5980/tcp
112 vnc-800x600x32          5981/tcp
113 vnc-1024x768x32         5982/tcp
114 vnc-1280x1024x32        5983/tcp
115 vnc-1600x1200x32        5984/tcp
117 /etc/xinetd.conf
119 Edit the xinetd.conf file and add the following entries.
121 service vnc-640x480x8
123   disable = no
124   flags = REUSE
125   protocol = tcp
126   socket_type = stream
127   wait = no
128   user = nobody
129   server = /usr/vnc/bin/Xvnc
130   server_args = -inetd -query localhost -once -geometry 640x480 -depth 8
133 service vnc-800x600x8
135   disable = no
136   flags = REUSE
137   protocol = tcp
138   socket_type = stream
139   wait = no
140   user = nobody
141   server = /usr/vnc/bin/Xvnc
142   server_args = -inetd -query localhost -once -geometry 800x600 -depth 8
145 service vnc-1024x768x8
147   disable = no
148   flags = REUSE
149   protocol = tcp
150   socket_type = stream
151   wait = no
152   user = nobody
153   server = /usr/vnc/bin/Xvnc
154   server_args = -inetd -query localhost -once -geometry 1024x768 -depth 8
157 service vnc-1280x1024x8
159   disable = no
160   flags = REUSE
161   protocol = tcp
162   socket_type = stream
163   wait = no
164   user = nobody
165   server = /usr/vnc/bin/Xvnc
166   server_args = -inetd -query localhost -once -geometry 1280x1024 -depth 8
169 service vnc-1600x1200x8
171   disable = no
172   flags = REUSE
173   protocol = tcp
174   socket_type = stream
175   wait = no
176   user = nobody
177   server = /usr/vnc/bin/Xvnc
178   server_args = -inetd -query localhost -once -geometry 1600x1200 -depth 8
181 service vnc-640x480x16
183   disable = no
184   flags = REUSE
185   protocol = tcp
186   socket_type = stream
187   wait = no
188   user = nobody
189   server = /usr/vnc/bin/Xvnc
190   server_args = -inetd -query localhost -once -geometry 640x480 -depth 16
193 service vnc-800x600x16
195   disable = no
196   flags = REUSE
197   protocol = tcp
198   socket_type = stream
199   wait = no
200   user = nobody
201   server = /usr/vnc/bin/Xvnc
202   server_args = -inetd -query localhost -once -geometry 800x600 -depth 16
205 service vnc-1024x768x16
207   disable = no
208   flags = REUSE
209   protocol = tcp
210   socket_type = stream
211   wait = no
212   user = nobody
213   server = /usr/vnc/bin/Xvnc
214   server_args = -inetd -query localhost -once -geometry 1024x768 -depth 16
217 service vnc-1280x1024x16
219   disable = no
220   flags = REUSE
221   protocol = tcp
222   socket_type = stream
223   wait = no
224   user = nobody
225   server = /usr/vnc/bin/Xvnc
226   server_args = -inetd -query localhost -once -geometry 1280x1024 -depth 16
229 service vnc-1600x1200x16
231   disable = no
232   flags = REUSE
233   protocol = tcp
234   socket_type = stream
235   wait = no
236   user = nobody
237   server = /usr/vnc/bin/Xvnc
238   server_args = -inetd -query localhost -once -geometry 1600x1200 -depth 16
241 service vnc-640x480x24
243   disable = no
244   flags = REUSE
245   protocol = tcp
246   socket_type = stream
247   wait = no
248   user = nobody
249   server = /usr/vnc/bin/Xvnc
250   server_args = -inetd -query localhost -once -geometry 640x480 -depth 24
253 service vnc-800x600x24
255   disable = no
256   flags = REUSE
257   protocol = tcp
258   socket_type = stream
259   wait = no
260   user = nobody
261   server = /usr/vnc/bin/Xvnc
262   server_args = -inetd -query localhost -once -geometry 800x600 -depth 24
265 service vnc-1024x768x24
267   disable = no
268   flags = REUSE
269   protocol = tcp
270   socket_type = stream
271   wait = no
272   user = nobody
273   server = /usr/vnc/bin/Xvnc
274   server_args = -inetd -query localhost -once -geometry 1024x768 -depth 24
277 service vnc-1280x1024x24
279   disable = no
280   flags = REUSE
281   protocol = tcp
282   socket_type = stream
283   wait = no
284   user = nobody
285   server = /usr/vnc/bin/Xvnc
286   server_args = -inetd -query localhost -once -geometry 1280x1024 -depth 24
289 service vnc-1600x1200x24
291   disable = no
292   flags = REUSE
293   protocol = tcp
294   socket_type = stream
295   wait = no
296   user = nobody
297   server = /usr/vnc/bin/Xvnc
298   server_args = -inetd -query localhost -once -geometry 1600x1200 -depth 24
301 service vnc-640x480x32
303   disable = no
304   flags = REUSE
305   protocol = tcp
306   socket_type = stream
307   wait = no
308   user = nobody
309   server = /usr/vnc/bin/Xvnc
310   server_args = -inetd -query localhost -once -geometry 640x480 -depth 32
313 service vnc-800x600x32
315   disable = no
316   flags = REUSE
317   protocol = tcp
318   socket_type = stream
319   wait = no
320   user = nobody
321   server = /usr/vnc/bin/Xvnc
322   server_args = -inetd -query localhost -once -geometry 800x600 -depth 32
325 service vnc-1024x768x32
327   disable = no
328   flags = REUSE
329   protocol = tcp
330   socket_type = stream
331   wait = no
332   user = nobody
333   server = /usr/vnc/bin/Xvnc
334   server_args = -inetd -query localhost -once -geometry 1024x768 -depth 32
337 service vnc-1280x1024x32
339   disable = no
340   flags = REUSE
341   protocol = tcp
342   socket_type = stream
343   wait = no
344   user = nobody
345   server = /usr/vnc/bin/Xvnc
346   server_args = -inetd -query localhost -once -geometry 1280x1024 -depth 32
349 service vnc-1600x1200x32
351   disable = no
352   flags = REUSE
353   protocol = tcp
354   socket_type = stream
355   wait = no
356   user = nobody
357   server = /usr/vnc/bin/Xvnc
358   server_args = -inetd -query localhost -once -geometry 1600x1200 -depth 32
361 ----
362 Final Step
364 Reboot the machine. After reboot go to another computer and try the following.
365 You will need to load the vncviewer on another computer to test. There are
366 clients for Windows and Unix. The java viewer is not supported under this
367 configuration.
369 To connect to your server you will need to start the vncviewer. Enter in the
370 IP address or the FQDN of the service with the last two numbers of the port
371 you want to connect to. In our suggested installation here is a list of the
372 ports and associated desktop configurations.
374 Example:        vnc.server.com:60 
375 Would connect to vnc.server.com at 640x460 16 bit color
377 Screen          Port #  Last 2 of Port
378 640x480x8       5950    50
379 800x600x8       5951    51
380 1024x768x8      5952    52
381 1280x1024x8     5953    53
382 1600x1200x8     5954    54
383 640x480x16      5960    60
384 800x600x16      5961    61
385 124x768x16      5962    62
386 1280x1024x16    5963    63
387 1600x1200x16    5964    64
388 640x480x24      5970    70
389 800x600x24      5971    71
390 1024x768x24     5972    72
391 1280x1024x24    5973    73
392 1600x1200x24    5974    74
393 640x480x32      5980    80
394 800x600x32      5981    81
395 1024x768x32     5982    82
396 1280x1024x32    5983    83
397 1600x1200x32    5984    84
399 VERSION: 1.6
401 CHANGELOG:      1.6 Update CVS Location
402                 1.5 Updated to New Hint Format 
403                 1.4 Updated to 1.29
404                 1.3 Fixed Download Link
405                 1.2 Fixed Typos
406                 1.1 Added Pre-requisites
407                 1.0 Intial Version
409  New Version of this document can be viewed from http://cvs.jg555.com/viewcvs.cgi/lfs-hints