Note: This is a draft page only. Please do not refer anything in this guide. Thank you!

Overview

This page presents how to display a desktop served over a SSH connection.

SSH supports tunneling of X11 (X-Windows). This is also very useful if you want to open graphical displays from the remote machine on your local computer.To achieve this, an X11 server must be running on your local machine. The X11 connections are then tunneled and automatically encrypted by your SSH client.

---

Setup SoC

Prepare

In this example we are using the Atlas-SoC board with following SD-Card image (Angstrom) :

https://releases.rocketboards.org/2015.10/atlas/atlas_sdcard_v1.1.img.tgz

This image includes the XFCE desktop served over VNC.

1. Connect to SoC board using serial connection

Login as root !

2. Update packet list

(Ethernet connection required)

 root@atlas_sockit:~# opkg update 

3. Check if x authority utilities are available

 root@atlas_sockit:~# opkg list | grep "xauth"
 pam-plugin-xauth - 1.1.6-r5.18 - PAM plugin for -xauth PAM plugin for -xauth
 xauth - 1:1.0.9-r0.7 - X authority utilities X application to edit and display the
 xauth-dbg - 1:1.0.9-r0.7 - X authority utilities - Debugging files X application to edit and
 xauth-dev - 1:1.0.9-r0.7 - X authority utilities - Development files X application to edit and
 xauth-doc - 1:1.0.9-r0.7 - X authority utilities - Documentation files X application to edit and

4. Install x authority utilities

 root@atlas_sockit:~# opkg install xauth 

5. Add new user

- we don’t want to use root account for ssh connection

 root@atlas_sockit:~# adduser username
 Enter new UNIX password:  *****
 Retype new UNIX password: *****
 passwd: password updated successfully
 

6. Configuring the SSH Server

Edit the /etc/ssh/sshd_config file, and uncomment the following line:

 X11Forwarding Yes 

7. Check network configuration

(inet addr)

 
root@atlas_sockit:~# ifconfig
eth0      Link encap:Ethernet  HWaddr 00:07:ed:3a:59:10
          inet addr: 192.168.0.104  Bcast:192.168.0.255  Mask:255.255.255.0
          inet6 addr: fe80::207:edff:fe3a:5910/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST DYNAMIC  MTU:1500  Metric:1
          RX packets:1130 errors:0 dropped:0 overruns:0 frame:0
          TX packets:205 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:113902 (111.2 KiB)  TX bytes:26327 (25.7 KiB)
          Interrupt:27 Base address:0xc000
..
..

---

Display desktop on Windows host

Prepare host

In this example we are using PuTTY (free SSH client) and Xming (Windows X Window Server) .

Get PuTTY : http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

Get Xming : https://sourceforge.net/projects/xming/ (e.g. version 6.9.0.31)

1. Launch Xming

2. Config Putty

3. Open SSH Connection

3. Login as username

A .Xauthority file should be created automatically.

4. Start the X session

 atlas_sockit:~# x-session-manager & 

Enjoy !

---

Display desktop on Linux host

Prepare host

If the ssh client is not installed on you host computer, you can install it by running the following command on CentOS:

 $ sudo yum install openssh-clients 

or the following command on Ubuntu:

 $ sudo apt-get install openssh-client 

1. Open SSH Connection

 $ ssh -X username@192.168.0.104 

2. Start the X session

 atlas_sockit:~# x-session-manager & 

Enjoy !

---

Install XFCE desktop environment (if not exist)

You can install the environment package with following commands (Angstrom) :

 root@atlas_sockit:~# opkg update
 root@atlas_sockit:~# opkg install packagegroup-xfce-base

-- KlausBrunnbauer - 03 May 2016