VNC Usage

This is useful for setting up/debugging Virtual Machines when they don't have ssh.

Installation

You'll first want to install a VNC client on your computer—we recommend TigerVNC. To install TigerVNC on Ubuntu, run the following command:

sudo apt install tigervnc

If you are running Arch Linux, you can install it through Pacman by running the following command:

sudo pacman -S tigervnc

Usage

Then, ssh into the machine running the virtual machine and run the following command as root:

virsh vncdisplay <vm_name>

You will get an output similar to 127.0.0.1:1 add 5900 to the last number to get the port the VNC server is listening on. In this case, the port would be 5901.

Then, use ssh tunneling to forward that port to your local computer. If you are not on the CSL network, you will need to use Openvpn or tunnel twice through one of the RASes. For example, if the virtual machine was on Antipodes:

[you@yourcomputer:~]$ ssh -L 5901:localhost:5901 ras1.tjhsst.edu
[2019yyou@ras1:~]$ ssh -L 5901:localhost:5901 antipodes.csl.tjhsst.edu

If you are using sshuttle, you can skip the tunneling through RAS since sshuttle does that for you.

Finally, open up your VNC client and connect to 127.0.0.1:<PORT> (in this example 5901). That's it!

Look at your VNC's manual to learn how to use it better. Mostly, though, keyboard and mouse input should pass right through as long as the VNC window is focused.

If you press Ctrl+Alt+Delete while connected via tty, you will reboot the machine, so exercise caution.

Last updated