{{NeedsUpdate}} The [[WebVNC]] application sets up a web page to access a Java applet for VNC connections. VNC is graphical remote control desktop software. VNC allows you to connect to a desktop on the the Amahi server from a remote computer (Windows or Linux)via a browser. You must have a desktop session open on your HDA to be able to open a WebVNC session.

* # Go to http://setup* # Select the Apps tab* # Select the Available option* # Click on WebVNC* # Click the install icon to install the WebVNC server package on your HDA

'''NoteNOTE:''' ''You must have a desktop session open'' on your HDA to be able to open a WebVNC session. If you have a headless HDA server, see below.

* 1. Log into the computer running the HDAas a normal user2. Launch a command line/terminal session (From the GNOME desktop, e.gselect Applications > System Tools > Terminal)3. Login as a normal super user:<br /> su -:password: ''enter root password''<br /><br />4. Change the permissions of /etc/sysconfig/vncservers to allow editing with the following command:<br />* Edit chmod 777 /etc/sysconfig/vncservers5. Open the file /etc/sysconfig/vncservers with your favorite a text editor. Add (Applications > Accessories > gedit Text Editor on the GNOME desktop) and add the following two lines to the bottom of the file:<br /> :: VNCSERVERS="10:''yourusername''":: VNCSERVERARGS[10]="-geometry 1024x768 -depth 16" :'''NOTE:''' ''yourusername'' is the desktop user you use to login to your HDA desktop. Make sure there is no # comment symbol # in front of your entries. This entry will create a 1024 x 768 desktop with 16M colors on your remote machine.<br /><br />You can set the desktop resolution to any value you want -- see below. You can also setup sessions for multiple users and computers. More detailed instructions are available [http://www.g-loaded.eu/2005/11/10/configure-vnc-server-in-fedora/ here].<br /><br />6. Change the file permissions back:<br /> chmod 244 /etc/sysconfig/vncservers

* # Log into your desktop on the HDA computer running HDA, e.g. as a normal user* # Select SYSTEM menu, then System > 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, turn on "Configure Network automatically to accept connections."

* [== Quickly Change Resolution ==You can create a script to quickly change the resolution of your HDA's desktop and update your WebVNC window. This technique involves keeping several different configuration files for your WebVNC and adjusting a symlink to reference the correct configuration. First, as root, make a copy of your WebVNC webpage configuration in your user folder for EACH desired resolution, with the following commands:  cd /var/hda/web-apps/webvnc/html cp index.html /home/%USER%/.amahi.webvnc.800x600.index.html cp index.html /home/%USER%/.amahi.webvnc.1024x768.index.html cp index.html /home/%USER%/.amahi.webvnc.1280x1024.index.html You will need to edit each of these files to change the size of the VNC window inside the web page. The width of the window should match the width of your desktop, however the height of the window should have 22px added to the height of the desktop in order to account for the WebVNC menu. For example, for the resolution 800x600, the html file will look like this: &lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"&gt; &lt;html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"&gt;&gt; &lt;head&gt; &lt;title&gt;WebVNC Client&lt;/title&gt; &lt;meta http-equiv="Content-Language" content="en-us" /&gt; &lt;meta http-equiv="Content-Type" content="text/html;charset=UTF-8" /&gt; &lt;head&gt; &lt;body style="font-size:8px;background-color:#000000;font-family:arial, helvetica, sans-serif;font-color:#007500;text-align:center;"&gt; &lt;div style="position:relative;margin: 0 auto;width:800px;height:622px;"&gt; &lt;applet code=VncViewer.screencastclass codebase=classes/ width="800" height="622"&gt; &lt;param name=PORT value=5900&gt; &lt;param name="Open New Window" value="no"&gt; &lt;/applet&gt;&lt;br /&gt; &lt;/div&gt; &lt;a href="http://hda/"&gt;Return to HDA Home&lt;/a&gt; &lt;/body&gt; &lt;/html&gt; Next, remove the original index.comhtml file and create a symlink to the appropriate new file: rm index.html ln -s /usershome/spatialguru%USER%/folders.amahi.webvnc.800x600.index.html index.html Now you need a script in order to change the resolution of the desktop AND update the symlink to the correct configuration. Create a file in /home/Jing%USER%/mediaScripts/996c7c1dfor each desired resolution, for example, amahi.webvnc.reschange.800x600.sh containing the following, making sure to enter your sudo password and the desired resolution:  #!/bin/bash echo ::password:: | sudo -05a9S rm -f /var/hda/web-4a92apps/webvnc/html/index.html sudo ln -9d87s /home/%USER%/.amahi.webvnc.800x600.index.html /var/hda/web-f89167742a3capps/00000032webvnc/html/index.png Screenshot] html sudo xrandr -s 800x600 Finally, make each of desktop sharing setup below your scripts executable (sorry it's so hugechmod u+x %SCRIPT%), place a drawer on your panel with a launcher to each of your scripts, then to change resolutions select your launcher and refresh your WebVNC window.

*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:# Make sure you have a password defined as above. # * Ensure 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.

:To delete: ~/.gnome2/keyrings/default.keyring:or backup: mv ~/.gnome2/keyrings/default.keyring ~/.gnome2/keyrings/default.keyring.bak == Headless Servers == If your HDA server is headless, then WebVNC is not for you (because you will not have a desktop session running). Instead, install a VNC client on your remote computer and [[VNC|VNC Server]] on the HDA.  There is however a hack to allow you to run WebVNC from a headless server. This is rather complex, and will not allow you to boot with a monitor attached without changing files again.

rm ~/You need to modify you xorg.gnome2/keyrings/defaultconf to emulation a monitor.keyring

or backup cd /etc/X11/ nano xorg.conf:save it as xorg.conf.bak nano xorg.conf:replace everything with

Section "Monitor" Identifier "Monitor0" HorizSync 31-81 VertRefresh 56-75 EndSection Section "Device" Identifier "Card0" Driver "vesa" EndSection Section "Screen" Identifier "Screen0" Device "Card0" Monitor "Monitor0" EndSection :save and close xorg.conf  mv ~nano /.gnome2boot/keyringsgrub/defaultgrub.keyring ~conf:save it as grub.conf.bak nano /.gnome2boot/keyringsgrub/default.keyringgrub.bakconf:add above title Fedora GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nomodeset"

If your HDA server is headless, then WebVNC is not for you (because you will not have ever want to use a desktop session running). Insteadmonitor, install a VNC client on your remote computer and [[VNC|VNC Server]] on you just need to restore the HDA. bak files.