WebVNC

From Amahi Wiki
Revision as of 05:38, 24 July 2009 by Cpg (talk | contribs)
Jump to: navigation, search

The WebVNC package is for easily setting up a web-page that let's readers access a Java applet for VNC connections. VNC is, simply put, graphical remote control desktop software. With a Fedora-based Amahi install, it takes a few steps on the server to 1) install the package, 2) turn on desktop sharing.

Note: This allows anyone with network access to this machine to connect to your session, if they know the password. Be sure this is what you want.

Install the Package

  • Goto http://setup
  • Select the applications tab
  • Click on WebVNC
  • Click the install icon to install it on your HDA
  • Note: a very common issue is that you must have a desktop session open on your HDA to be able to open a WebVNC session.

That should be all you need to do for the web application setup!

Setup VNC Server

(this will be automated in the future)

  • Log into the computer running HDA, e.g. as a normal user
  • Edit the file /etc/sysconfig/vncservers (with your favorite text editor)

Set the lines starting with VNCSERVER to read (remove the # at the start of the line)

VNCSERVERS="1:yourusername" VNCSERVERARGS[1]="-geometry 1024x768 -depth 16"

where yourusername is the desktop user you use to access your HDA desktop.

Click Here more details on setting up VNC on your HDA.


Turn on Desktop Sharing

(this will be automated in the future)

  • Log into the computer running HDA, e.g. as a normal user
  • Select SYSTEM menu, then Preferences, then Internet and Network, then Remote Desktop
  • Turn on the top two "sharing" options, turn off the "Ask for confirmation" option, but set a password below it.

Note: This allows anyone with network access to this machine to connect to your session, if they know the password. Be sure this is what you want.

Using the App

You should now be able to access: http://webvnc. Give it a minute to start up, then enter your password.

Note: You must have a desktop session started on your HDA for WebVNC to display.

Leave any questions or discussion on the Talk:WebVNC page.

Screenshot of desktop sharing setup below - sorry it's so huge.

http://content.screencast.com/users/spatialguru/folders/Jing/media/996c7c1d-05a9-4a92-9d87-f89167742a3c/00000032.png

Troubleshooting

A very basic issue -- you must have a desktop session open on your HDA to be able to open a WebVNC session.

Two typical scenarios pop up as problematic. One, is to make sure you have a password defined as above. Second, make sure the confirmation checkbox is deactivated, unless you are sitting in front of the HDA itself. Otherwise it will just sit there indefinitely waiting for someone to click a button on the screen of the HDA.

Please note that at the present time, and according to the above, only port 5900 (VNC display :0) is supported. If you want to change that, then manually edit /var/hda/web-apps/webvnc/html/index.html and change 5900 to desired number (e.g. :1 = 5901, :2=5902, etc)