{{MessageBox|backgroundcolor = Using #FBB|image =Warning.png|heading =WARNING|message = '''NOTE:''' This is for Fedora-based systems ONLY.<br />Guidance may not work for Amahi 7 or greater. Sorry, but if you break your HDA we cannot provide support}}{{NeedsUpdate}}  ----  <div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;">'''NOTE:''' The one-click [https://www.amahi.org/apps/vnc VNC to use App] has been discontinued for Amahi 7 or greater. The reason is that it pulls a remote lot of packages, including desktop and that breaks DNS in the HDA Fedora.</div><br /> :'''NOTE:''' See [[TigerVNC]] for Amahi 8/9 (Fedora 21/23) guidance.__TOC__ = VNC remote =

* You would like a Linux desktop to the HDAremotely* You run your HDA headless (no monitor) and like to still use a desktop in it* You would like to use a GUI to configure printer(s)* You enjoy using or have a scanner or other device that requires a desktop program to configure and the Linux desktopmachine is headless

= Client : Installation = Download the client software and install: * Windows: [http://realvnc.com RealVNC], [http://www.uvnc.com UltraVNC], [http://www.tightvnc.com TightVNC]* MAC: [http://sourceforge.net/projects/chicken/ Chicken], [http://cotvnc.sourceforge.net/ Chicken of the VNC] (do not use internal vnc client as there are some issues)* For Linux, you have the vncviewer package, available in most, if not all distros. For Fedora 12, do the following as [[Open_Terminal_as_root|'''root''']] user: yum -y install tigervnc = Server Installation = There are various ways to get the server going in your HDA. All of them require the server software.# Amahi [http://www.amahi.org/apps/VNC VNC] application.# Manually as described below (notes may require some revision). === Manual Install ===* Complete the steps in [[GUI_Install_for_Express_Disc|Express Disc Desktop]] guidance (Amahi 7 ONLY). * As root, install the server:  yum -y install tigervnc-server == Method 1 ==* Open a terminal, become root and install the VNC server (tigervnc-server) as stated in the Manual Install section. When the install has completed, press ctrl-D to end the root session. Leave the terminal open, or open one now. *The following commands are entered as '''User'''.

* [http://realvncType vncpasswd and press enter.com/ For Windows]* [http://cotvnc The system will prompt you for a password.sourceforgeType a password and press the enter key.net/ For MAC]* For Linux, The system will prompt you have to verify the password. Type the vncviewer package, available in most, if not all distrospassword a second time and press the enter key.

To start * You can edit the server in configuration files using your HDAchoice of editor. Nano is used below. Note that when "user" is shown, you need to enter your user name. * Type nano /home/user/.vnc/xstartup and press the enter key. Nano will open the file. Find the vncfollowing line: twm & Change that line to read: exec gnome-session & This change will open the VNC display with a Gnome desktop, even if the server rpm package:is starting in Init 3 by default. Press ctrl-X to exit Nano. You will see the prompt at the bottom "Save modified buffer (ANSWERING "No" WILL DESTROY CHANGES) ? Press the Y key. The prompt will change, showing you the file name. Press the enter key, this will store your change and exit Nano.

When that is installed, type this at * Type su and press the command lineenter key followed by the root password

The first time it runs it will ask for setting up a password* Uncomment both lines by removing the # at the beginning of the lines. Edit the lines so they appear as follows: VNCSERVERS="1:username" VNCSERVERARGS[1]="-geometry 1024x768 -nolisten tcp" Enter your username in place of "username". After "geometry", you can enter any resolution you desire. You can also specify a sizecome back and change this if necessary. Press ctrl-X to exit Nano. You will see the prompt at the bottom "Save modified buffer (ANSWERING "No" WILL DESTROY CHANGES) ? Press the Y key. The prompt will change, which I typically do a hair smaller than showing you the file name. Press the desktop I plan to use it fromenter key, this will store your change and exit Nano. Example for 1280x1024:

* Finally, type chkconfig vncserver -geometry 1250x1000on and press the enter key. This will make the VNC server start when the computer starts.

More detailed instructions * Press ctrl-D to end the root session, and then press ctrl-D again to close the terminal. * That's it - Run your VNC Client and enter hda:1 as the host/IP address. You should now see your HDA Desktop screen.*If you are available interested in more security for your VNC connection, check the link listed below under "General Instructions" * Repeat the configuration for each user you wish to be able to connect via VNC.* Note you can have displays for users 1-9 and each will connect to their VNC session at port 590n (some VNC clients 'know' the 590 part and only have you enter n). Make certain that you have forwarded the correct port(s), or the range 5901 through 5909.* Add -localhost to options if you are connecting through a ssh tunnel or only locally. This adds some security. == Method 2 ==* To start the server in your HDA, you need install tigervnc-server rpm package:* From the '''root''' user: yum -y install xinetd chkconfig vncserver off service vncserver stop* Create /etc/gdm/custom.conf file and add the following: #GDM configuration storage [httpxdmcp] Enable=true [chooser] [security] DisallowTCP=false [debug]* Create /etc/xinetd.d/vnc1024 file and add the following (you can change the screen resolution by changing the geometry setting): service vnc1024 { disable = no socket_type = stream protocol = tcp group = tty wait = no user = nobody server = /usr/www.gbin/Xvnc server_args = -inetd -query localhost -geometry 1024×768 -depth 16 -once -loaded.eufp /usr/share/X11/2005fonts/11misc -securitytypes=none }* Edit /10etc/configureservices and comment out the two lines as listed below: #vnc-server 5900/tcp # VNC Server #vnc-server 5900/udp # VNC Server* Add this line below the two lines you commented out and save the changes: vnc1024 5900/tcp # VNC and GDM* Now restart the xinetd service service xinetd restart* Run your VNC Client and enter your HDA IP address for host/IP address. You should now see your HDA Desktop login screen. If you don't see the login screen, a reboot of the HDA may be required. This can be done via the dashboard or by executing the following as '''root''' user: reboot now == Method 3 (the cpg method) == * Every time the HDA is rebooted, when VNC is needed, ssh to the HDA* The first time without do: vncserver -geometry 1550x1100* After the first time, I type vncs. I have an alias in~/.bashrc: alias vncs='vncserver -fedorageometry 1550x1100 &> /dev/ here].null &';

In order * Why that resolution? That fits my monitors with the VNC window and frame enough to run not display scrollbars and move around nicely. Change at will!* It does involve the full gnome desktop in vncdreaded CLI.* Since my HDA does not get rebooted often, you have to edit this file in the home directory of the user you want to run vnc on:is not a huge problem

= General Instructions =More detailed instructions are available [http://www.g-loaded.eu/2005/11/10/configure-vnc-server-in-fedora/xstartuphere].

<pre># Uncomment the following two lines for normal desktopThis helpful page has helped with [http:unset SESSION_MANAGERexec /etc/X11www.windowsreference.com/xinitinternet-explorer/xinitrc<windows-has-blocked-this-software-because-it-cant-verify-the-publisher/pre>blocking VNC]