Setting up GUI Desktop on a VM

This article is a draft

This is not a complete article: This is a draft, a work in progress that is intended to be published into an article, which may or may not be ready for inclusion in the main wiki. It should not necessarily be considered factual or authoritative.

These instructions are for the Ubuntu operating system:

1. install MATE

   [name@server ~]$ sudo apt update
   [name@server ~]$ sudo apt upgrade -y
   [name@server ~]$ sudo apt install ubuntu-mate-desktop
   

   During the installation of the ubuntu-mate-desktop package it will ask you to choose the default display manager, a good option is lightdm. Installing the ubuntu-mate-desktop package can take a fair amount of itme (maybe something like 15-30 mins?).

2. install tightvncserver
   

   [name@server ~]$ sudo apt install tightvncserver
   

   For details about using VNC servers and clients see our docs on VNC.

3. configuring tightvncserver
   

   [name@server ~]$ vncserver
   -> enter a password
   -> enter "n" for view-only password
   

   vncpasswd command can be used to change password later
4. Open port 5901 and test connection (see OpenStack#Security_Groups security groups for more information about opening ports to your VMs with OpenStack). However, this is not secure as the data sent to and from your VM will not be encrypted.
5. Connect using an SSH tunnel See SSH_tunnelling. There is an example of creating an SSH tunnel to a VNC server running on a compute node of one of our clusters here: VNC#Compute_Nodes
6. Close port 5901. Once you have you are connecting to your VNC server using an SSH tunnel you no longer require port 5901 open so it is recommended that you remove this rule from your security groups. (see OpenStack#Security_Groups security groups for more information).
7. To stop the vncserver
   

   [name@server ~]$ vncserver -kill :1