{"id":137982,"date":"2021-12-03T15:44:39","date_gmt":"2021-12-03T20:44:39","guid":{"rendered":"http:\/\/www.bu.edu\/tech\/?page_id=137982"},"modified":"2025-01-13T10:34:32","modified_gmt":"2025-01-13T15:34:32","slug":"virtual-gl","status":"publish","type":"page","link":"https:\/\/www.bu.edu\/tech\/support\/research\/system-usage\/running-jobs\/virtual-gl\/","title":{"rendered":"Running Interactive Graphics Jobs (using VirtualGL)"},"content":{"rendered":"

<\/a><\/p>\n

Overview<\/h2>\n
Due to the ease of use and excellent graphics performance of the SCC OnDemand<\/a> system’s Desktop Session, we recommended its use instead of using VNC as described here.<\/strong><\/div>\n

While the majority of interactive graphical applications that run on the SCC perform well, there are a class of complex interactive visualization applications that require additional software called VirtualGL in order to perform adequately on users’ workstations or desktops. These include OpenGL applications that utilize full 3D hardware acceleration like Freesurfer or PyMOL.<\/p>\n

Research Computing has set aside a limited number of shared nodes that utilize VirtualGL to support these complex visualization applications on the SCC. To successfully run an interactive graphics job that requires VirtualGL, the user has to be on the BU Network.<\/p>\n

It is important to note that the VirtualGL offering is a limited resource and should only be used for applications that require complex OpenGL 3D hardware acceleration. Most applications such as MATLAB, RStudio, QGIS, and others do not require this and will function well using a typical interactive desktop session.<\/p>\n

OnDemand Interactive Graphics Desktop<\/h4>\n

Under the “Interactive Apps<\/a>” menu there is an application options called “VirtualGL Desktop”. Select this application to launch an interactive VirtualGL desktop on a compute node.<\/p>\n

Manual VirtualGL Connection<\/h4>\n
    \n
  1. VNC password setup<\/a><\/li>\n
  2. Start Interactive Graphics Job<\/a><\/li>\n
  3. Configure SSH tunnel<\/a><\/li>\n
  4. Connect with VNC Client – PC<\/a><\/li>\n
  5. Connect with VNC Client – Mac<\/a><\/li>\n
  6. Running Graphics Application<\/a><\/li>\n
  7. Terminating Interactive Graphics Job<\/a><\/li>\n<\/ol>\n

    VNC password setup<\/h4>\n

    The first time you use vncserver<\/i> or start an interactive graphics job<\/i>, you have to establish your VNC password. This VNC password must be different from your Kerberos<\/i> password. To set your VNC password, execute the following command:<\/p>\n

    scc2%<\/span> vncpasswd<\/span><\/code><\/pre>\n
    Start Interactive Graphics Job<\/h4>\n
    To start an Interactive Graphics Job<\/i> execute the following command (on any SCC login node):<\/p>\n
    scc2%<\/span> qvgl<\/span><\/code><\/pre>\n
    This command accepts many batch job options including project name, time limit, email options, etc. It also accepts vncserver flags including the geometry<\/i> flag to set the VNC screen resolution. The general usage of the command is:<\/p>\n
     qvgl<\/span> [-v|--vnc \"vncargs\"] [-b|--batch \"batchargs\"] [-P project] [-l batch resources]<\/span><\/code><\/pre>\n
    For example:<\/p>\n
    scc2%<\/span> qvgl<\/span> -P scv -l h_rt=4:00:00 -v \"-geometry 1200x900\" -b \"-m e\"<\/span><\/code><\/pre>\n
    If the job starts successfully, you should see the output that will provide you with the information about setting up tunneling and running the VNC session:<\/p>\n
    \r\nWaiting for immediate job to be scheduled.\r\n\r\non your local workstation run:\r\n     ssh bgregor@scc1.bu.edu -L XXXX:scc-v06:5901<\/b>\r\n\r\nthen execute vncviewer to connect to localhost port XXXX\r\n     vncviewer localhost:XXXX\r\nto run an OpenGL application on a hardware GPU use vglrun command\r\nfor example:\r\n     vglrun glxinfo\r\nto quit the job please run:\r\n     qdel 2006553\r\n<\/span><\/code><\/pre>\n
    Configure SSH tunnel<\/h3>\n
    The value XXXX is a placeholder – replace this with a number of your choosing that’s >1024. Values in the range 7000-8000 are suggested. In the examples below the value of 7000 is used. Linux<\/b> and Mac<\/b> users can execute the ssh<\/span><\/code> command provided in the qvgl script output. This should be entered in your local<\/b> machine’s terminal window, e.g.<\/p>\n
    ><\/span> ssh<\/span> bgregor<\/span>@scc1.bu.edu -L 7000<\/span>:scc-v06:5901<\/span><\/code><\/pre>\n
    You will be asked to enter your Kerberos password.<\/p>\n
    Windows<\/b> users can execute the same command in their MobaXterm<\/a> or Cygwin<\/a> local terminal window or follow these steps<\/a> to set up tunneling using putty<\/a>.<\/p>\n
    Connect with VNC Client – PC<\/h3>\n
    If you do not have the VNC viewer<\/b> built into your system, download it from www.realvnc.com<\/a>. When you install it, select only the VNC Viewer (you do not need to install VNC server on your local machine). Start the VNC Viewer and when a dialog window appears, enter:<\/p>\n
    VNC server:<\/span> localhost:XXXX<\/span><\/code><\/pre>\n
    where XXXX<\/span><\/code> is the number you selected while configuring SSH tunneling (7000 in the example above). You will be prompted to enter your password. Use your VNC (not Kerberos) password.<\/p>\n
    Connect with VNC Client – MAC<\/h3>\n
    Recent versions of Mac OSX have a VNC client built into the operating system. To connect on a Mac, click on the desktop then press the key combo \u2318-K. In the Connect to Server window that opens, enter the following into the Server Address box, using the port number selected earlier in place of the XXXX<\/span><\/code>:<\/p>\n
    vnc:\/\/localhost:XXXX<\/span><\/code><\/pre>\n
    You will be prompted to enter your password. Use your VNC (not Kerberos) password.<\/p>\n
    Running Graphics Application<\/h3>\n
    Open a terminal Window (In the menu Applications -> System Tools -> Terminal; Or press right mouse button and select “Open in terminal”).<\/p>\n
    Start graphics application using VirtualGL engine vglrun<\/span><\/code> (Load modules first, if needed):<\/p>\n
    scc-ha2%<\/span> module load freesurfer\/5.3.0<\/span>\r\nscc-ha2%<\/span> vglrun tksurfer <\/span><\/code><\/pre>\n
    Terminating Interactive Graphics Job<\/h3>\n
    To terminate your Interactive Graphics session close your VNC window, exit the tunneling session and delete your job:<\/p>\n
    scc2%<\/span> qdel<\/span> 2006553<\/span><\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
    Overview Due to the ease of use and excellent graphics performance of the SCC OnDemand system’s Desktop Session, we recommended its use instead of using VNC as described here. While the majority of interactive graphical applications that run on the SCC perform well, there are a class of complex interactive visualization applications that require additional…<\/p>\n","protected":false},"author":1692,"featured_media":0,"parent":137962,"menu_order":11,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137982"}],"collection":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/users\/1692"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/comments?post=137982"}],"version-history":[{"count":7,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137982\/revisions"}],"predecessor-version":[{"id":155383,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137982\/revisions\/155383"}],"up":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/137962"}],"wp:attachment":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/media?parent=137982"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}