Changes

From Amahi Wiki
Jump to: navigation, search
718 bytes added ,  15:37, 5 April 2014
no edit summary
{{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. 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:
# 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.
==Setup VNC Server==
Sorry, some manual work is needed to run the server:
# 1. Log into the computer running the HDA as a normal user# 2. Launch a command line/terminal session (From the GNOME desktop, select Applications > System Tools > Terminal)# 3. Login as super user:<br /><br />#: su-#:password: ''enter root password''<br /><br /># 4. Change the permissions of /etc/sysconfig/vncservers to allow editing with the following command:<br /><br />#: chmod 775 777 /etc/sysconfig/vncservers<br /><br /># 5. 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="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. If you set it slightly less than the native resolution of the display on the remote computer, the scrolling bars can be eliminated.  ::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 ==
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>
* # 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."
::[[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.
 
* [http://content.screencast.com/users/spatialguru/folders/Jing/media/996c7c1d-05a9-4a92-9d87-f89167742a3c/00000032.png Screenshot] of desktop sharing setup below (sorry it's so huge).
== Quickly Change Resolution ==
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
== 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: ~/.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). rm ~/.gnome2/keyrings/defaultInstead, install a VNC client on your remote computer and [[VNC|VNC Server]] on the HDA.keyring
or backup:
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. mv ~ You need to modify you xorg.conf to emulation a monitor.  cd /.gnome2etc/keyringsX11/default 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.keyring ~conf  nano /.gnome2boot/keyringsgrub/defaultgrub.keyringconf:save it as grub.conf.bak nano /boot/grub/grub.conf:add above title Fedora GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nomodeset"
== Headless Servers ==Reboot
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.
[[Category:Apps]]
12,424

edits