Research VMs – Remote Access

1. If connected to the UVM VPN, you can connect directly to your research VM using PowerShell on Windows. Open PowerShell from the Start Menu by searching for “PowerShell”
   
2. In PowerShell, type the command: ssh netid@my-host-here.uvm.edu(replacing ‘netid’ with your NetID and ‘my-host-here’ with your research VM name), you will be prompted for your NetID password.
   
3. You now have command line access to your research VM, to verify this type hostname and you will see your VM name. To disconnect, type exit or just close the PowerShell window.

1. Open Terminal on your Mac by searching “Terminal” in Spotlight (cmd+space).
   
2. Type “ssh netid@hostname.uvm.edu”.  Replace NetID with your NetID, and “hostname” with the name of the research VM. Hit enter and you will be prompted for your password.
3. You should now be connected to your VM.  To verify this type hostname and you will see your VM name. To disconnect, type exit or just close the Terminal window.

1. You can connect to Zoo from Terminal on a Mac, or with Powershell on a PC. To open Terminal, open the Spotlight search and type ‘Terminal’.  On a PC, type “Powershell” in the search bar.
   
2. In Terminal or Powershell, type the command: ssh netid@zoo.uvm.edu(replacing ‘netid’ with your NetID), you will be prompted for your NetID password.
   
   Connecting to Zoo from off-campus

   VPN access is not required for Zoo access from off campus. If you are off campus, your will be prompted for a multi-factor authentication (MFA) method in addition to your password when connecting to Zoo. If you haven’t set up MFA for your UVM NetID, read this article: https://www.uvm.edu/it/kb/article/duo-multi-factor-authentication/

3. Once logged in to Zoo you can now SSH into your research VM. This is done by entering the command ssh hostname(replacing hostname with your research VM name). After entering this command you will be prompted for your NetID password once more, enter it.
   
4. You now have command line access to your research VM, to verify this type hostname and you will see your VM name. To disconnect, type exit or just close the Terminal window.

1. Open the Remote Desktop Connection application from the Start Menu by searching for ‘Remote Desktop Connection’.
   
2. Enter your hostname in the computer field (replace my-host-here.uvm.edu with your research VM hostname) and click Connect.
   
3. If you see a certificate warning, click Yes.
   
4. You will then be connected to a remote session on your VM and will be prompted with an XRDP login screen. Enter your NetID and password to login.
   
5. You are now connected to your research VM with a full desktop.

To connect to your research VM, you will need an RDP application.  The recommended application for MacOS is “Windows App” which can be downloaded from the App Store.

1. Open Windows App and click the + symbol in the upper right corner.
2. Click the Add PC Button
3. In the Add PC window, enter the hostname of the VM you are connecting to.  The Credentials dropdown should say “Ask when required”.  Click Add.
4. You should now see your VM in your “Saved Devices” Tab.  Double click the pane with your VM name.
5. You will see a popup saying the connection may not be secure.  Click continue.
6. If the connection is successful, you will see the following login window.  Enter your NetID in the username field and your NetID password. 
7. Done!

To connect to a GUI desktop without connecting to the VPN, you must first set up an ssh tunnel through Zoo.  Once the tunnel is set up, you will follow the directions above for connecting from a VPN connection, but instead of hostname.uvm.edu as the computer or PC Name, you will need to put in “127.0.0.1:33389”.

1. To create an SSH Tunnel, you will need to connect to Zoo with a certain command. To do this open Terminal (Mac: Spotlight search -> Terminal) or Powershell (Windows PC).
   
2. In the Terminal or Powershell window, type the following command ssh -L 33389:hostname.uvm.edu:3389 netid@zoo.uvm.edu(replacing hostname with your VM hostname), you will be prompted for your NetID password.
   
   Connecting to Zoo from off-campus

   VPN access is not required for Zoo access from off campus. If you are off campus, your will be prompted for a multi-factor authentication (MFA) method in addition to your password when connecting to Zoo. If you haven’t set up MFA for your UVM NetID, read this article: https://www.uvm.edu/it/kb/article/duo-multi-factor-authentication/

3. Once logged in to Zoo the SSH tunnel is created and will remain open as long as the Terminal window is open.
   
4. Follow the instructions above for connecting to a VM from UVM VPN depending on your operating system.  For the PC Name or Computer name put in “127.0.0.1:33389” as the computer name.  Everything else stays the same.
5. You are now connected to your research VM with a full desktop. To close the SSH tunnel, log out of your remote desktop session and go to your Terminal window and type exit.

Connections to Windows research VMs when using Windows as your client device will be made through the Remote Desktop Connection application. Connection security is managed through the use of RD Gateway which allows remote access from both on and off campus.

1. Open the Remote Desktop Connection application from the Start Menu by searching for ‘Remote Desktop Connection’.
   
2. Expand the configuration screen by clicking ‘Show options’ and enter your hostname and username information.Computer: hostname.campus.ad.uvm.edu
   User Name: CAMPUS\netid
   Replace ‘hostname’ with your VM hostname and ‘netid’ with your UVM NetID.
   
3. Click the ‘Advanced’ tab to show more configuration options and then click the ‘Settings’ button under the ‘Connect from anywhere’ heading.
   
4. Click the radio button next to ‘Use these RD Gateway server settings’ and enter the RD Gateway address: ‘rdgateway.uvm.edu’ Then click the checkbox next to ‘Use my RD Gateway credentials for the remote computer’ and click ‘OK’.
   Note

   This step is not necessary if you are connected to the VPN.

   
   
   

5. Go back to the ‘General’ tab and click Connect.
   
6. You will see a warning asking if you trust the connection, click Connect.
   
7. You will be prompted for your credentials, your username will be filled in, enter your NetID password and click OK.
   
8. Finally, you will be prompted for your multi-factor authentication method. Click your method of choice to complete the log in.
   

To connect to your research VM, you will need an RDP application.  The recommended application for MacOS is “Windows App” which can be downloaded from the App Store.

If you are not connected to the UVM VPN, you will need to configure RD Gateway.  If you are connected to the VPN, you can skip steps 4 and 5.

1. 1. Open Windows App and click the + symbol in the upper right corner.
   2. Click the Add PC Button
   3. In the Add PC window, enter the hostname of the VM you are connecting to.  The Credentials dropdown should say “Ask when required”. 
   4. (If you are connected to the VPN, skip this step).  Click on the Gateway drop-down, and select Add Gateway.
   5. (If you are connected to the VPN, skip this step). Enter rdgateway.uvm.edu in the gateway name, and make sure the Credentials drop-down says “Use PC User Account”. Click Add.
   6. Click “Add” in the Add PC window.
   7. You should now see your VM in your “Saved Devices” Tab.  Double click the pane with your VM name.
   8. A window should pop up asking for your credentials.  Enter “CAMPUS\netid” for the Username and your NetID password.
   9. Finally, you will be prompted for your multi-factor authentication method. Click your method of choice to complete the log in.
      
   10. Done!