{"id":22213,"date":"2022-03-01T14:12:03","date_gmt":"2022-03-01T19:12:03","guid":{"rendered":"https:\/\/www.uvm.edu\/it\/dev\/kb\/?post_type=ht_kb&p=22213"},"modified":"2025-01-10T11:49:29","modified_gmt":"2025-01-10T16:49:29","slug":"research-vms-remote-access","status":"publish","type":"ht_kb","link":"https:\/\/www.uvm.edu\/it\/dev\/kb\/article\/research-vms-remote-access\/","title":{"rendered":"Research VMs – Remote Access"},"content":{"rendered":"

How-to guides for connecting to research virtual machines (VMs) hosted by Enterprise Technology Services.<\/p>\n

ETS hosts VMs for researchers to use as an alternative to the Vermont Advanced Computing Center (VACC). These VMs run on a server cluster that the Systems Architecture & Administration (SAA) team supports and are available to any researcher on campus.<\/p>\n

The guide below will walk you through the steps to connect to your VM with either command-line access, partial GUI access, or full GUI access.<\/p>\n \t\t

\r\n \t\t\tMulti-factor Authentication<\/span> \t\t\t \t\t\t\t

\r\n \t\t\t\t\tAll remote access to VMs will require multi-factor authentication be set up for your UVM NetID. If you haven’t set up MFA for your UVM NetID, use this article to do so before continuing: https:\/\/www.uvm.edu\/it\/kb\/article\/duo-multi-factor-authentication\/<\/a> \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n

Linux VMs <\/i><\/h2>\n

All connections to Linux research VMs need to be made through Zoo, a UVM Linux cluster, or when connected to the VPN.<\/p>\n \t\t

\r\n \t\t\tOn UVM VPN<\/span> \t\t\t \t\t\t\t

\r\n \t\t\t\t\tConnection guides labeled ‘on UVM VPN’ require an active connection to the UVM VPN. More information about the UVM VPN can be found here: https:\/\/www.uvm.edu\/it\/kb\/article\/sslvpn2\/<\/a> \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n \t\t

\r\n \t\t\tThrough Zoo<\/span> \t\t\t \t\t\t\t

\r\n \t\t\t\t\tConnection guides labeled ‘through Zoo’ require an SSH connection to Zoo that will be explained in the instructions. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n

Command Line Access<\/h3>\n

Command line access provides a terminal\/shell to your research VM for the execution of text-only commands. This is ideal for starting long-running processes or simple document\/script editing.<\/p>\n \t\t

\r\n \t\t\t

Windows using PowerShell on UVM VPN<\/h3><\/div>\r\n \t\t\t
\r\n \t\t\t\t
\r\n \t\t\t\t\t<\/p>\n
    \n
  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”
    \n\"Windows<\/a><\/li>\n
  2. In PowerShell, type the command: ssh netid@my-host-here.uvm.edu<\/code>(replacing ‘netid’ with your NetID and ‘my-host-here’ with your research VM name), you will be prompted for your NetID password.
    \n    \"\"<\/a><\/li>\n
  3. You now have command line access to your research VM,\u00a0to verify this type hostname<\/code> and you will see your VM name. To disconnect, type exit<\/code> or just close the PowerShell window.<\/li>\n<\/ol>\n

    \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n \t\t

    \r\n \t\t\t

    Mac using Terminal through Zoo<\/h3><\/div>\r\n \t\t\t
    \r\n \t\t\t\t
    \r\n \t\t\t\t\t<\/p>\n
      \n
    1. You can connect to Zoo from Terminal on a Mac. To open Terminal, open the Spotlight search and type ‘Terminal’.
      \n      \"Mac<\/a><\/li>\n
    2. In Terminal, type the command: ssh netid@zoo.uvm.edu<\/code>(replacing ‘netid’ with your NetID), you will be prompted for your NetID password.
      \n      \"Mac<\/a><\/p>\n
      \n \t\t\tConnecting to Zoo from off-campus<\/span> \t\t\t \t\t\t\t<\/p>\n

      \n \t\t\t\t\tVPN 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\/<\/a> \t\t\t\t<\/p>\n<\/p><\/div>\n

      \n \t\t<\/li>\n

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

      \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n

      Partial GUI Access (X11 Forwarding)<\/h3>\n

      Partial GUI access allows for fully rendered windows to appear on your computer from your research VM. This means you can run applications that require a graphical element and you will see them right on your computer. This uses a technology called X11 forwarding.<\/p>\n \t\t

      \r\n \t\t\tOff Campus X11 Performance<\/span> \t\t\t \t\t\t\t

      \r\n \t\t\t\t\tX11 forwarding performance is intermittent from off campus, whether connected to the VPN or not. It’s recommended to only use this type of access when on campus. If you need GUI access and are off campus consistently, you should use the Full GUI access instructions below. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n \t\t

      \r\n \t\t\t

      Windows using PuTTY and VcXsrv<\/h3><\/div>\r\n \t\t\t
      \r\n \t\t\t\t
      \r\n \t\t\t\t\t<\/p>\n

      You will need an X Server for Windows to use X11 forwarding, VcXsrv is recommended and can be downloaded from https:\/\/software.uvm.edu<\/a>. (see this KB article if you have not yet used AppsAnywhere:\u00a0https:\/\/www.uvm.edu\/it\/kb\/article\/appsanywhere\/)<\/a><\/p>\n

      You will also need an SSH application on Windows, PuTTY is recommended and can be downloaded from https:\/\/software.uvm.edu<\/a>.<\/p>\n

        \n
      1. Install VcXsrv with the default selections and open XLaunch (installed with VcXsrv). This will open the XLaunch configuration window. On the first window, select ‘Multiple windows’ and make sure ‘Display window’ is set to ‘-1’ which should be the default, then click Next.
        \n        \"VcXsrv<\/a><\/li>\n
      2. Select ‘Start no client’ and click Next.
        \n        \"VcXsrv<\/a><\/li>\n
      3. Check the boxes shown here, which should be the defaults, to enable clipboard integration as well as native opengl, then click Next.
        \n        \"VcXsrv<\/a><\/li>\n
      4. Click ‘Save Configuration’ to save this connection profile. This file can then be used in the future to start VcXsrv without needing to go through the configuration above. Then click Finish to launch the VxXsrv X-server.
        \n        \"VcXsrv<\/a><\/li>\n
      5. Verify the X-server is running by locating the icon in the system tray (bottom right icons), you may need to click the up arrow to expand the icons.
        \n        \"Windows<\/a><\/li>\n
      6. Install and launch PuTTY.<\/li>\n
      7. Enter the connection information for Zoo and then click Save to create a connection profile:
        \nHostname:\u00a0zoo.uvm.edu<\/em>
        \nSaved Session Name:\u00a0UVM Zoo X11<\/em><\/em>
        \n        \"PuTTY<\/a><\/li>\n
      8. In the left hand categories, expand SSH and then select X11. Enter the X11 forwarding information:
        \nCheck box for ‘Enable X11 forwarding’
        \nX display location:\u00a0localhost:0.0
        \n        \"PuTTY<\/a>
        \n<\/em><\/li>\n
      9. Go back to the Session category and click Save again. Then click Open to open the connection.<\/li>\n
      10. You will see a login prompt, enter your NetID and then your password to log in.
        \n        \"PuTTY<\/a><\/p>\n
        \n \t\t\tConnecting to Zoo from off-campus<\/span> \t\t\t \t\t\t\t<\/p>\n

        \n \t\t\t\t\tVPN 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\/<\/a> \t\t\t\t<\/p>\n<\/p><\/div>\n

        \n \t\t<\/li>\n

      11. Once logged in to Zoo you can now SSH into your research VM. This is done by entering the command ssh -X hostname<\/code>(replacing hostname with your research VM name). After entering this command you will be prompted for your NetID password once more, enter it.
        \n        \"Zoo<\/a><\/li>\n
      12. You will now have a connection to your research VM with X11 forwarding enabled. To verify it’s working, you can either enter the command xauth list<\/code> or launch your application.\u00a0To disconnect, type exit<\/code> or just close the PuTTY window.<\/li>\n<\/ol>\n

        \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n \t\t

        \r\n \t\t\t

        Mac using Terminal and XQuartz<\/h3><\/div>\r\n \t\t\t
        \r\n \t\t\t\t
        \r\n \t\t\t\t\t<\/p>\n

        You will need an X Server for Mac to use X11 forwarding, XQuartz is recommended and can be downloaded from https:\/\/software.uvm.edu<\/a>. (see this KB article if you have not yet used AppsAnywhere:\u00a0https:\/\/www.uvm.edu\/it\/kb\/article\/appsanywhere\/)<\/a><\/p>\n

          \n
        1. Install XQuartz with the default selections. To open it, use the Spotlight search and search for ‘XQuartz’.
          \n          \"Mac<\/a><\/li>\n
        2. This will open a new Xterm window which you can use to connect to Zoo. Type ssh -X zoo.uvm.edu<\/code> to launch the connection, you will be prompted for your NetID and password.
          \n          \"Mac<\/a><\/p>\n
          \n \t\t\tConnecting to Zoo from off-campus<\/span> \t\t\t \t\t\t\t<\/p>\n

          \n \t\t\t\t\tVPN 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\/<\/a> \t\t\t\t<\/p>\n<\/p><\/div>\n

          \n \t\t<\/li>\n

        3. Once logged in to Zoo you can now SSH into your research VM. This is done by entering the command ssh -X hostname<\/code>(replacing hostname with your research VM name). After entering this command you will be prompted for your NetID password once more, enter it.
          \n          \"Mac<\/a><\/li>\n
        4. You will now have a connection to your research VM with X11 forwarding enabled. To verify it’s working, you can either enter the command xauth list<\/code> or launch your application.\u00a0To disconnect, type exit<\/code> or just close the Terminal window.<\/li>\n<\/ol>\n

          \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n

          Full GUI Access (Full Remote Desktop)<\/h3>\n

          Full GUI access is accomplished by using the Remote Desktop Protocol (RDP) and creating an SSH tunnel through Zoo for security. This option grants access to a full remote desktop environment for running multiple graphical applications.<\/p>\n \t\t

          \r\n \t\t\tRemote Desktop Access<\/span> \t\t\t \t\t\t\t

          \r\n \t\t\t\t\tRDP is not enabled by default on research VMs. If you need a full desktop available on your VM, please send an email to saa@uvm.edu<\/a> to request it be enabled. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n \t\t

          \r\n \t\t\t

          Windows using Remote Desktop Connection on UVM VPN<\/h3><\/div>\r\n \t\t\t
          \r\n \t\t\t\t
          \r\n \t\t\t\t\t<\/p>\n
            \n
          1. Open the Remote Desktop Connection application from the Start Menu by searching for ‘Remote Desktop Connection’.
            \n            \"Windows<\/a><\/li>\n
          2. Enter your hostname in the computer field (replace my-host-here.uvm.edu with your research VM hostname) and click Connect.
            \n            \"Windows<\/a><\/li>\n
          3. If you see a certificate warning, click Yes.
            \n            \"XRDP<\/a><\/li>\n
          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.
            \n            \"XRDP<\/a><\/li>\n
          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 PuTTY window and type exit<\/code>.<\/li>\n<\/ol>\n

            \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n \t\t

            \r\n \t\t\t

            Mac using Terminal and Microsoft Remote Desktop<\/h3><\/div>\r\n \t\t\t
            \r\n \t\t\t\t
            \r\n \t\t\t\t\t<\/p>\n

            To connect to your research VM, you will need an RDP application, Microsoft Remote Desktop is recommended and is available from\u00a0https:\/\/software.uvm.edu<\/a>. (see this KB article if you have not yet used AppsAnywhere:\u00a0https:\/\/www.uvm.edu\/it\/kb\/article\/appsanywhere\/)<\/a><\/p>\n

              \n
            1. To create an SSH Tunnel, you will need to connect to Zoo with a certain command, to do this open Terminal (Spotlight search -> Terminal)
              \n              \"Mac<\/a><\/li>\n
            2. In the Terminal type the following command ssh -L 33389:hostname.uvm.edu:3389 netid@zoo.uvm.edu<\/code>(replacing hostname with your VM hostname), you will be prompted for your NetID password.
              \n              \"Mac<\/a><\/p>\n
              \n \t\t\tConnecting to Zoo from off-campus<\/span> \t\t\t \t\t\t\t<\/p>\n

              \n \t\t\t\t\tVPN 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\/<\/a> \t\t\t\t<\/p>\n<\/p><\/div>\n

              \n \t\t<\/li>\n

            3. Once logged in to Zoo the SSH tunnel is created and will remain open as long as the Terminal window is open.
              \n              \"Mac<\/a><\/li>\n
            4. Once Microsoft Remote Desktop is installed, launch it by searching for it with Spotlight search.
              \n              \"Mac<\/a><\/li>\n
            5. In Microsoft Remote Desktop, click the Add button to add a new connection profile.
              \n              \"Microsoft<\/a><\/li>\n
            6. In the connection wizard, enter the connection information as shown and click Add:
              \nPC Name:\u00a0127.0.0.1:33389
              \n<\/em>User Account:\u00a0Ask when required<\/em>
              \nFriendly name: Descriptive Name for Research VM<\/em>
              \n              \"Microsoft<\/a><\/li>\n
            7. Double click the connection you just created in your connections list.
              \n              \"Microsoft<\/a><\/li>\n
            8. Enter your NetID and password when prompted.
              \n              \"Mac<\/a><\/li>\n
            9. If you see a certificate warning, click Continue.
              \n              \"Mac<\/a><\/li>\n
            10. 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<\/code>.<\/li>\n<\/ol>\n

              \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n

              Windows VMs <\/i><\/h2>\n \t\t
              \r\n \t\t\t

              Windows using Remote Desktop Connection<\/h3><\/div>\r\n \t\t\t
              \r\n \t\t\t\t
              \r\n \t\t\t\t\t<\/p>\n

              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.<\/p>\n

                \n
              1. Open the Remote Desktop Connection application from the Start Menu by searching for ‘Remote Desktop Connection’.
                \n\"Windows<\/a><\/li>\n
              2. Expand the configuration screen by clicking ‘Show options’ and enter your hostname and username information.Computer:\u00a0<\/strong>hostname<\/em>.campus.ad.uvm.edu
                \nUser Name:<\/strong> CAMPUS\\netid<\/em>
                \nReplace ‘hostname’ with your VM hostname and ‘netid’ with your UVM NetID.
                \n                \"Remote<\/a><\/li>\n
              3. Click the ‘Advanced’ tab to show more configuration options and then click the ‘Settings’ button under the ‘Connect from anywhere’ heading.
                \n                \"Remote<\/a><\/li>\n
              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’.
                \n                \"Remote<\/a><\/li>\n
              5. Go back to the ‘General’ tab and click Connect.
                \n                \"Remote<\/a><\/li>\n
              6. You will see a warning asking if you trust the connection, click Connect.
                \n                \"Remote<\/a><\/li>\n
              7. You will be prompted for your credentials, your username will be filled in, enter your NetID password and click OK.
                \n                \"Remote<\/a><\/li>\n
              8. Finally, you will be prompted for your multi-factor authentication method. Click your method of choice to complete the log in.
                \n                \"Widows<\/a><\/li>\n<\/ol>\n

                \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n \t\t

                \r\n \t\t\t

                Mac using Microsoft Remote Desktop<\/h3><\/div>\r\n \t\t\t
                \r\n \t\t\t\t
                \r\n \t\t\t\t\t<\/p>\n

                To connect to your research VM, you will need an RDP application, Microsoft Remote Desktop is recommended and is available from\u00a0https:\/\/software.uvm.edu<\/a>. (see this KB article if you have not yet used AppsAnywhere:\u00a0https:\/\/www.uvm.edu\/it\/kb\/article\/appsanywhere\/)<\/a><\/p>\n

                Connection security is managed through the use of RD Gateway which allows remote access from both on and off campus.<\/p>\n

                  \n
                1. With Microsoft Remote Desktop installed, launch it by searching for it with Spotlight search.
                  \n                  \"Mac<\/a><\/li>\n
                2. In Microsoft Remote Desktop, click the Add button to add a new connection profile.
                  \n                  \"Microsoft<\/a><\/li>\n
                3. In the connection wizard, enter the connection information as shown and click Add:
                  \nPC Name:\u00a0hostname.campus.ad.uvm.edu\u00a0<\/em>(replace ‘hostname’ with the name of your VM)
                  \n<\/em>User Account:\u00a0Ask when required<\/em>
                  \nFriendly name: Descriptive Name for Research VM
                  \n<\/em>Gateway: Click dropdown and then click ‘Add Gateway’ <\/em>(Details in step 4)
                  \n                  \"Microsoft<\/a>
                  \n<\/em><\/li>\n
                4. In the ‘Add a Gateway’ window, enter ‘rdgateway.uvm.edu’ as the gateway address and click Add.
                  \n                  \"Microsoft<\/a><\/li>\n
                5. Once the gateway is added, click Save to save your remote desktop connection information.
                  \n                  \"Microsoft<\/a><\/li>\n
                6. Double click the connection you just created in your connections list.
                  \n                  \"Microsoft<\/a><\/li>\n
                7. Enter your NetID and password when prompted. (Use the “campus\\netid<\/em>” format for your username)
                  \n                  \"Microsoft<\/a><\/li>\n
                8. If you see a certificate warning, click Continue.
                  \n                  \"Microsoft<\/a><\/li>\n
                9. Finally, you will be prompted for your multi-factor authentication method. Click your method of choice to complete the log in.
                  \n                  \"Widows<\/a><\/li>\n<\/ol>\n

                  \n \t\t\t\t<\/div>\r\n \t\t\t<\/div>\r\n \t\t<\/div>\r\n \t\t\n","protected":false},"excerpt":{"rendered":"

                  How-to guides for connecting to research virtual machines (VMs) hosted by Enterprise Technology Services. ETS hosts VMs for researchers to use as an alternative to the Vermont Advanced Computing Center (VACC). These VMs run on a server cluster that the Systems Architecture & Administration (SAA) team supports and are available…<\/p>\n","protected":false},"author":117,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","footnotes":""},"ht-kb-category":[517],"ht-kb-tag":[],"class_list":["post-22213","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-research-computing"],"_links":{"self":[{"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb\/22213","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/users\/117"}],"replies":[{"embeddable":true,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/comments?post=22213"}],"version-history":[{"count":60,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb\/22213\/revisions"}],"predecessor-version":[{"id":30665,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb\/22213\/revisions\/30665"}],"wp:attachment":[{"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/media?parent=22213"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=22213"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.uvm.edu\/it\/dev\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=22213"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}