************************************************************************ Connecting with VLAB ************************************************************************ **VLAB** stands for *virtual lab*. It is a simple way to access the CSE lab environment from your own computer, anywhere in the world. .. comment: Setting up the UNSW VPN ----------------------- Unless you are on the UNSW campus, you need to access **VLAB** via the UNSW VPN. This will require installing some software on your computer. .. _vpn.unsw.edu.au: https://vpn.unsw.edu.au To install the VPN, first visit `vpn.unsw.edu.au`_ You will need to log in with your UNSW zID and zPass in order to download and install the **Cisco AnyConnect** VPN software, which is available for Windows, macOS, and Linux. Once the software is installed, you will need to find and run the **Cisco AnyConnect** application on your computer. Enter ``vpn.unsw.edu.au`` in the application window that appears. .. image:: vlab/AnyConnect.png :width: 400px :align: center You will then need to log into the **Cisco AnyConnect** application using your UNSW zID and zPass. .. image:: vlab/LogInAny.png :width: 400px :align: center You should then be connected to the UNSW VPN. To disconnect from the VPN when you have finished using VLAB, click the AnyConnect icon in your task-bar or menu-bar, and select disconnect. **Do not** disconnect from the VPN whilst you are still logged in to VLAB. .. comment: More instructions about setting up the VPN connection on your computer can be found here.

Installing a VNC viewer ----------------------- .. _the VLAB page on Taggi: https://taggi.cse.unsw.edu.au/FAQ/Really_quick_guide_to_VLAB/ Detailed information about connecting to VLAB can be found on `the VLAB page on Taggi`_. Download and run the appropriate version of TigerVNC's **vncviewer** from the following links: .. _TigerVNC for Windows (32-bit): https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/tigervnc-1.11.0.exe/download .. _TigerVNC for Windows (64-bit): https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/tigervnc64-1.11.0.exe/download .. _TigerVNC for macOS: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/TigerVNC-1.11.0.dmg/download .. _TigerVNC for Debian: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/ubuntu-18.04LTS/arm64/tigervncserver_1.11.0-1ubuntu1_arm64.deb/download .. _TigerVNC for Java: https://sourceforge.net/projects/tigervnc/files/stable/1.11.0/VncViewer-1.11.0.jar/download - `TigerVNC for Windows (32-bit)`_ - `TigerVNC for Windows (64-bit)`_ - `TigerVNC for macOS`_ - `TigerVNC for Debian`_ - `TigerVNC for Java`_ Move the **VNC Viewer** application to somewhere you'll be able to find it later. On macOS, for example, you may want to move this to your Applications folder; on Windows, you may want to move this to, or make a shortcut to it on, your Desktop. When you run the **VNC Viewer** application, you can tell it to connect to the VLAB server by entering something like ``vlab.cse.unsw.edu.au:5920``: .. image:: vlab/vncviewer.png :width: 450px :align: center TigerVNC Viewer can resize your VLAB session if you resize the viewer window. If you're not using TigerVNC Viewer, you can enter any of the following addresses, which will connect at a different screen resolution. Use a smaller screen resolution if you are using a slower internet connection, though you will need to set up the UNSW VPN. .. list-table:: :header-rows: 1 :align: center * - Resolution - VLAB port * - 640x480 - vlab.cse.unsw.edu.au:**5911** * - 800x600 - vlab.cse.unsw.edu.au:**5912** * - 1024x768 - vlab.cse.unsw.edu.au:**5913** * - 1280x800 - vlab.cse.unsw.edu.au:**5914** * - 1680x1050 - vlab.cse.unsw.edu.au:**5915** * - 1920x1080 - vlab.cse.unsw.edu.au:**5916** * - resizable - vlab.cse.unsw.edu.au:**5919** * - resizable, no VPN - vlab.cse.unsw.edu.au:**5920** When you connect, you will see a login screen. Simply log in with your zID and zPass. .. image:: vlab/vlab-login.png :width: 100% :align: center Read and accept the WARNING about conduct using CSE machines .. image:: vlab/vlab-motd.png :width: 100% :align: center Click **OK** to dismiss the information box showing you your resources. .. image:: vlab/vlab-resources.png :width: 100% :align: center Configuring VLAB ---------------- If you've never used VLAB before, you'll get this message telling you no window manager has been set up. You can safely click OK here. .. image:: vlab/vlab-firststart.png :width: 100% :align: center If you've not logged in before, you will be prompted to set up the panel. Select "use default config". .. image:: vlab/xfce-firststart.png :width: 100% :align: center And now you're at a desktop, like those you see in the labs. .. image:: vlab/xfce-default.png :width: 100% :align: center If you haven't already done so, you should open a terminal (using the terminal button in the bottom panel) and run:: $ 1511 setup You can now close that terminal. Otherwise, you can open a terminal by using the terminal button in the bottom panel or right-clicking the desktop and choosing "open terminal here": .. image:: vlab/xfce-xterm.png :width: 100% :align: center Use ``cd`` and ``ls`` to find the files you have been working on in your labs. Try running ``gedit`` or ``dcc``! Logging Out ----------- When you're done, choose either the door icon in the top panel, or select *Log Out* at the bottom of the Applications menu: .. image:: vlab/xfce-logout-squeak.png :width: 100% :align: center Don't forget to choose "log out" at the prompt! .. image:: vlab/xfce-logout-prompt.png :width: 100% :align: center More Information ---------------- The pages on Taggi about VLAB are very comprehensive. The `really quick guide to VLAB`_ is very useful, and there's more in-depth information on the `technical details`_ page. .. _really quick guide to VLAB: https://taggi.cse.unsw.edu.au/FAQ/Really_quick_guide_to_VLAB/ .. _technical details: https://taggi.cse.unsw.edu.au/FAQ/VLAB_-_The_technical_details/