'''Note: This 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 anyone with network access to this machine you to connect to your session, if they know a desktop on the the passwordAmahi server from a remote computer via a browser. Be sure this is what you wantYou must have a desktop session open on your HDA to be able to open a WebVNC session.'''

== Install To establish remote desktop connectivity on a Fedora-based Amahi install, two elements are required: #installation of the Package ==WebVNC application on the Amahi server and #installation of a VNC client on the remote computer.

* Goto http<div style="border://setup1px solid #B66; padding: .5em 1em; color: #000; background-color: #FEE; margin: 3px 3px 1em 3px;">* 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 The procedure below allows anyone in your network to access a desktop session open'' on your HDA to be able to open a WebVNC sessionAmahi server if they know the password. If Be sure this is what you have a headless HDA server, see belowwant.'''</div>

That should be all you need to do for == Install the web application setup!WebVNC Package ==

==Setup VNC Server==# Go to http://setup(this will be automated in # Select the future)Apps tab* Log into # Select the computer running HDA, e.g. as a normal userAvailable option* Edit the file /etc/sysconfig/vncservers (with your favorite text editor)# Click on WebVNCSet # Click the lines starting with VNCSERVER install icon to read (remove install the # at the start of the line)WebVNC server package on your HDA

<small>VNCSERVERS="1'''NOTE:''yourusername' ''You must have a desktop session open''"VNCSERVERARGS[1]="-geometry 1024x768 -depth 16" </small>on your HDA to be able to open a WebVNC session. If you have a headless HDA server, see below.

Sorry, some manual work is needed to run the server:1. Log into the computer running the HDA as a normal user2. Launch a command line/terminal session (From the GNOME desktop, select Applications > System Tools > Terminal)3. Login as 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 /> chmod 777 /etc/sysconfig/vncservers5. Open the file /etc/sysconfig/vncservers with a text editor (Applications > Accessories > gedit Text Editor on the GNOME desktop) and add the following two lines to the bottom of the file:<br /> VNCSERVERS="0:''yourusername''" VNCSERVERARGS[[VNC|Click Here0]] more details on setting up VNC ="-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 HDAremote 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

== 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::[[File:Remote_Desktop_Preferences.PNG]]

'''NoteNOTE: ''' 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.'''

Note'''Reminder: ''' You must have a desktop session started on your HDA for WebVNC to display. * Leave any questions or discussion on the [[Talk:WebVNC]] page. == 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.class 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.html file and create a symlink to the appropriate new file: rm index.html ln -s /home/%USER%/.amahi.webvnc.800x600.index.html index.html

Leave any questions or discussion on Now you need a script in order to change the [[Talkresolution of the desktop AND update the symlink to the correct configuration. Create a file in /home/%USER%/Scripts/ for each desired resolution, for example, amahi.webvnc.reschange.800x600.sh containing the following, making sure to enter your sudo password and the desired resolution:WebVNC]] page.

Screenshot of desktop sharing setup below #!/bin/bash echo ::password:: | sudo -S rm -f /var/hda/web-apps/webvnc/html/index.html sudo ln - sorry it's so huge/home/%USER%/.amahi.webvnc.800x600.index.html /var/hda/web-apps/webvnc/html/index.html sudo xrandr -s 800x600

http://contentFinally, make each of your scripts executable (chmod 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.screencast.com/users/spatialguru/folders/Jing/media/996c7c1d-05a9-4a92-9d87-f89167742a3c/00000032.png

*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 * 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 * Ensure the present timeconfirmation checkbox is deactivated, and according to unless you are sitting in front of the above, only port 5900 (VNC display :0) is supportedHDA itself. If you want Otherwise it will just sit there indefinitely waiting for someone 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)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 when trying to connect with WebVNC you get a message on the Amahi box "Enter password for default keyring want to unlock" change that, then you need manually edit /var/hda/web-apps/webvnc/html/index.html and change 5900 to delete or rename the default keyringdesired number (e.g. :1 = 5901, :2=5902, etc).

* If when trying to connect with WebVNC you get a message on the Amahi box "Enter password for default keyring to unlock" then you need to deleteor rename the default keyring:

rm :To delete: ~/.gnome2/keyrings/default.keyring:or backup: mv ~/.gnome2/keyrings/default.keyring ~/.gnome2/keyrings/default.keyring.bak

mv ~/If your HDA server is headless, then WebVNC is not for you (because you will not have a desktop session running).gnome2/keyrings/default Instead, install a VNC client on your remote computer and [[VNC|VNC Server]] on the HDA.keyring ~/.gnome2/keyrings/default.keyring.bak

If your HDA There is however a hack to allow you to run WebVNC from a headless server . This is headlessrather complex, then webVNC is and will not for allow you (because to boot with a monitor attached without changing files again.  You need to modify you will not have xorg.conf to emulation a desktop session running)monitor.   Instead, install a VNC client on your remote computer 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 vncserver on the HDAclose xorg.conf  nano /boot/grub/grub.conf:save it as grub. [[VNC|Instructions to install VNC]]conf. bak nano /boot/grub/grub.conf:add above title Fedora GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nomodeset" Reboot

TightVNC is If you ever want to use a more up-monitor, you just need to-date implementation of VNC. As of July 2009, TightVNC server is not yet packaged for Fedora 10, however restore the TightVNC client is compatible with (regular) VNC. You may install either the VNC or TightVNC clientbak files.