16
edits
Changes
From Amahi Wiki
rewrite to improve clarity
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. WebVNC is simpler to setup than regular VNC, but you You must have a desktop session open on your HDA to be able to open a WebVNC session.
To establish remote desktop connectivity on a Fedora-based Amahi install, two elements are required:
#:password: ''enter root password''<br /><br />
# Change the permissions of /etc/sysconfig/vncservers to allow editing with the following command:<br /><br />
#:chmod 775 777 /etc/sysconfig/vncservers<br /><br /># 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 /><br />#:VNCSERVERS="0:''yourusername''"#:VNCSERVERARGS[0]="-geometry 1024x768 -depth 16"<br /><br />#:''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.<br /><br />#: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 />#Change the file permissions back:<br /><br />#:chmod 244 /etc/sysconfig/vncservers
== Turn on Desktop Sharing ==
Unless you do this, your VNC session or your desktop will have a message asking someone to accept or refuse connections, and your client will be stuck waiting!
</div>
::[[File:Remote_Desktop_Preferences.PNG]]
'''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.
* Leave any questions or discussion on the [[Talk:WebVNC]] page.
== Quickly Change Resolution ==
== Troubleshooting ==
*A very basic issue -- : '''you must have a desktop session open''' on your HDA to be able to open a WebVNC session. * Make sure you have a password defined as above.
* 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.
* 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).
* 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 delete or rename the default keyring:
:To delete:
:or backup:
== Headless Servers ==
