{{MessageBox|backgroundcolor =#FBB|image = Using 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 1221/23) guidance.__TOC__ =VNC remote =

== What you need ==

== Client: Installation ==

* 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 =

== ServerThere are various ways to get the server going in your HDA. All of them require the server software.# Amahi [http: Installation - Method 1 == //www.amahi.org/apps/VNC VNC] application.# Manually as described below (notes may require some revision).

=== Manual Install ===* To start 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'''. * Type vncpasswd and press enter. The system will prompt you for a password. Type a password and press the enter key. The system will prompt you to verify the password. Type the password a second time and press the enter key. * Type vncserver and press the enter key. The system will create the configuration files. You should see output similar to this: xauth: creating new authority file /home/user/.xauthority New 'host.localdomain:1 (user)' desktop is host.localdomain:1 Creating default startup script /home/user/.vnc/xstartup Starting applications specified in /home/user/.xauthority Log file is /home/user/.vnc/host.localdomain:1.log * You can edit the configuration files using your HDAchoice of editor. Nano is used below. Note that when "user" is shown, you need install tigervncto enter your user name. * Type nano /home/user/.vnc/xstartup and press the enter key. Nano will open the file. Find the following 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.

* From the The following commands are entered as '''rootRoot''' user: yum -y install tigervnc-server xinetd chkconfig vncserver off service vncserver stop.

* Create /etc/gdm/custom.conf file Type su and add press the following: #GDM configuration storage [xdmcp] Enable=true [chooser] [security] DisallowTCP=false [debug]enter key followed by the root password

You can edit the configuration files using your choice of editor. Nano is used below.Note that when "username" is shown, you need to enter your user name. * Create Type nano /etc/xinetd.dsysconfig/vnc1024 file vncservers and add press the following (you can change enter key. Nano will open the screen resolution by changing file. Find the geometry setting)following lines: service vnc1024 { disable '#' VNCSERVERS= no"1:username" socket_type = stream protocol = tcp group = tty wait = no user = nobody server = /usr/bin/Xvnc server_args '#' VNCSERVERARGS[1]= -inetd -query localhost "-geometry 1024×768 800x600 -depth 16 nolisten tcp -once -fp /usr/share /X11/fonts/misc -securitytypes=none }localhost"

* Uncomment both lines by removing the # at the beginning of the lines. Edit /etc/services and comment out the two lines so they appear as listed belowfollows: VNCSERVERS="1:username" #vnc VNCSERVERARGS[1]="-geometry 1024x768 -server 5900/nolisten tcp # VNC Server" Enter your username in place of "username". After "geometry", you can enter any resolution you desire. You can come back and change this if necessary. #vnc Press ctrl-server 5900/udp # VNC ServerX 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.

* Add this line below Press ctrl-D to end the two lines you commented out root session, and save then press ctrl-D again to close the changes: vnc1024 5900/tcp # VNC and GDMterminal.

* Now restart That's it - Run your VNC Client and enter hda:1 as the xinetd servicehost/IP address. You should now see your HDA Desktop screen. service xinetd restart*If you are interested in more security for your VNC connection, check the link listed below under "General Instructions"

* Run your Repeat the configuration for each user you wish to be able to connect via VNC Client .* 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 your HDA IP address. You should now see your HDA Desktop login screenn). If Make certain that you don't see have forwarded the login screencorrect port(s), or the range 5901 through 5909.* Add -localhost to options if you are connecting through a reboot of the HDA may be requiredssh tunnel or only locally. This can be done via the dashboard or by executing the following as '''root''' user: reboot nowadds some security.

== Server: Installation - Method 2 ==

yum -y install tigervnc-serverxinetd chkconfig vncserver onoff service vncserver startstop* Edit Create /etc/sysconfiggdm/vncservers custom.conf file and change add the following lines: # VNCSERVERSGDM configuration storage [xdmcp] Enable="2:username"true [chooser] # VNCSERVERARGS [2security] DisallowTCP="-false [debug]* Create /etc/xinetd.d/vnc1024 file and add the following (you can change the screen resolution by changing the geometry 800x600 -nolisten setting): service vnc1024 { disable = no socket_type = stream protocol = tcp -localhost"to reflect (username is your linux group = tty wait = no user) below:= nobody VNCSERVERS server ="2:amahi"/usr/bin/Xvnc VNCSERVERARGS[2] server_args ="-inetd -query localhost -geometry 1024x768 1024×768 -depth 16 -nolisten tcp once -fp /usr/share/X11/fonts/misc -localhost"securitytypes=none }* Edit /homeetc/usernameservices and comment out the two lines as listed below: #vnc-server 5900/.tcp # VNC Server #vnc-server 5900/xstartup file to look as followsudp # VNC Server* Add this line below the two lines you commented out and save the changes: vnc1024 5900/tcp # twm &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. startx &You should now see your HDA Desktop login screen. If you don't see the login screen, a reboot of the HDA may change startx & be required. This can be done via the dashboard or by executing the following as '''root''' user: reboot now == Method 3 (Gnome interfacethe cpg method) == * Every time the HDA is rebooted, when VNC is needed, ssh to startkde & (KDE interface). the HDA* Stop and start vncserverThe first time without do: service vncserver stop service vncserver start-geometry 1550x1100* Use any client to access After the serverfirst time, I type vncs. I have an alias in ~/. Enter hdabashrc: alias vncs='vncserver -geometry 1550x1100 &> /dev/null &'; Notes:1 as the host.

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

== Troubleshooting for Vista ==