Difference between revisions of "GUI Programs"

From UFRC
Jump to navigation Jump to search
m
 
(167 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
[[Category:Software]]
+
[[Category:Software]][[Category:GUI]]
 +
'''The module gui/2 is no longer available. Use this page to know how to use GUI applications on Hipergator.
 +
'''
 +
__NOTOC__
  
−
Xpra Client installation and connection instructions.
+
Here you will find the information necessary to configure and run graphical user interface (GUI) applications on HiPerGator. The process is not complicated, but running a GUI on a remote server and displaying the windows on your local client computer with a sufficiently responsive interface is not as easy as simply running the application locally. We'd like to acknowledge an Open Source [https://xpra.org Xpra Project] for creating software we built our GUI sessions on top of.
  
−
=Xpra Documentation=
+
==X11 Forwarding==
 +
For the simplest case of running a lightweight GUI application for a very short time you can log into HiPerGator with
 +
ssh -Y MYUSER@hpg.rc.ufl.edu
 +
load the environment module your application is in and run it. Do not analyze data this way, but running a text editor, a web browser to log in and get an api token from a remote service or some other very short and lightweight operations are fine.
  
−
*Xpra Homepage: https://xpra.org/
+
==Open OnDemand==
−
*Xpra Basic Usage: https://xpra.org/trac/wiki/Usage
+
Normally the X11 DISPLAY variable is set once the X11 server is started.  This can be done manually, as described above, but an easier method is to use [https://help.rc.ufl.edu/doc/Open_OnDemand#Display_Environment_on_the_Console Open OnDemand] since that will start an X11 server and allocate the frame buffer automatically.
−
*Xpra Advanced Usage: http://xpra.org/manual.html
 
  
−
=Step 1: Client Installation=
+
[https://openondemand.org/ Open OnDemand] provides a web-only interface to starting and attaching to GUI programs with seamless connections through web browsers. This service is available at the following URL:
  
−
Xpra client installation depends on what operating system is running on your local machine.
+
https://ondemand.rc.ufl.edu
  
−
==Linux==
+
{{Note|Many applications have their own interfaces, but other can also be launched by launching a HiPerGator Desktop and then opening the application with the desktop interface.|info}}
−
The recommended option is to use the distribution specific packages if possible:
 
  
−
===Ubuntu/Debian===
+
===[https://mediasite.video.ufl.edu/Mediasite/Play/4654bfa838624de894085bf54678848f1d Using Open on Demand on HiPerGator]===
−
sudo apt-get install xpra
+
[[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/4654bfa838624de894085bf54678848f1d]] [5 min, 11 sec]
−
 
+
This video covers the use of Open on Demand https://openondemand.org/ on HiPerGator via https://ood.rc.ufl.edu/.
−
===CentOS/RHEL===
+
* Connect to https://ood.rc.ufl.edu/
−
 
+
* Launch a terminal
−
<pre>
+
* Launch many graphical applications like Rstudio, Matlab and Freeview
−
sudo su -
+
* Manage job submission
−
rpm --import https://winswitch.org/gpg.asc
+
* Upload, download and edit files via your browser
−
cd /etc/yum.repos.d/
 
−
curl -O https://winswitch.org/downloads/CentOS/winswitch.repo
 
−
yum install xpra
 
−
</pre>
 
−
 
 
−
==Windows==
 
−
===XP and Newer===
 
−
Download and install MS Windows files: from [https://xpra.org/ https://xpra.org/], Installer file can be found at [https://xpra.org/dists/windows/Xpra_Setup.exe https://xpra.org/dists/windows/Xpra_Setup.exe].
 
−
 
 
−
= Step 2: Start software under Xpra on UFRC side=
 
−
Start application under xpra on one of the HPC interactive job nodes (gui1 for example) where $USER represents your username, $PORT is the desired X11 port, and $EXE is the executable you want to start, with full path if needed.
 
−
 
 
−
xpra start :{$PORT} --start-child={$EXE} --exit-with-children
 
−
 
 
−
;Example:
 
−
xpra start :123 --start-child=gedit --exit-with-children
 
−
 
 
−
=Step 3: Connect to Xpra Session from the client side=
 
−
==Linux==
 
−
Xpra is typically automatically added to your path during installation, so you can connect to your running xpra instance using the following syntax where $USERNAME is your UF Research Computing username, $SERVERNAME is the server where your application is running inside xpra, and $PORT is the X11 port you assigned when you started your application.
 
−
 
 
−
xpra attach ssh:$USERNAME@$SERVERNAME:$PORT
 
−
 
 
−
;Example:
 
−
xpra attach ssh:testuser@gui1.rc.ufl.edu:123
 
−
 
 
−
==Windows==
 
−
First, navigate to the install location of xpra (normally C:\Program Files (x86)\Xpra\). 
 
−
;In MobaXterm:
 
−
cd /drives/c/Progam\ Files\ \(x86\)/Xpra/
 
−
 
 
−
Second, connect to your running xpra instance using the following syntax where $USERNAME is your UF Research Computing username, $SERVERNAME is the server where your application is running inside xpra, and $PORT is the X11 port you assigned when you started your application.
 
−
 
 
−
./xpra attach ssh:$USERNAME@$SERVERNAME:$PORT
 
−
 
 
−
;Example:
 
−
 
 
−
./xpra attach ssh:testuser@gui1.rc.ufl.edu:123
 
−
 
 
−
;NOTE: If you close the window using the close button, this will exit your application just like a native application. If you want to simply detach the session and come back later, please follow the ''detaching xpra session'' instructions below
 
−
 
 
−
=Step 4: Detaching Xpra Session=
 
−
These instructions allow you to detach a running xpra client without closing the application.
 
−
 
 
−
==Linux==
 
−
In the original terminal where you activated the client, simply press Control-C to detach the session.
 
−
 
 
−
<pre>
 
−
2016-04-06 15:18:17,173 Attached to ssh:testuser@gui1.rc.ufl.edu:123 (press Control-C to detach)
 
−
^C
 
−
got signal SIGINT, exiting
 
−
2016-04-06 15:18:42,513 Connection lost
 
−
</pre>
 
−
 
 
−
You can re-attach to the running application using the ''xpra attach' command as described in the instructions above.
 
−
 
 
−
==Windows==
 
−
* Start a new console and navigate to the xpra directory as shown above.
 
−
* Run the following command where $USERNAME is your UF Research Computing username, $SERVERNAME is the server where your application is running inside xpra, and $PORT is the X11 port you assigned when you started your application.
 
−
 
 
−
./xpra detach ssh:$USERNAME@$SERVERNAME:$PORT
 
−
 
 
−
;Example:
 
−
<pre>
 
−
cd "C:\Program Files (x86)\Xpra"
 
−
./xpra detach ssh:testuser@gui1.rc.ufl.edu:123
 
−
</pre>
 
−
 
 
−
;Note: If you are using mobaXterm, you can press Control-C in the mobaXterm window to detach, just like using the Linux client.
 

Latest revision as of 14:42, 30 January 2023

The module gui/2 is no longer available. Use this page to know how to use GUI applications on Hipergator.


Here you will find the information necessary to configure and run graphical user interface (GUI) applications on HiPerGator. The process is not complicated, but running a GUI on a remote server and displaying the windows on your local client computer with a sufficiently responsive interface is not as easy as simply running the application locally. We'd like to acknowledge an Open Source Xpra Project for creating software we built our GUI sessions on top of.

X11 Forwarding

For the simplest case of running a lightweight GUI application for a very short time you can log into HiPerGator with 

ssh -Y MYUSER@hpg.rc.ufl.edu

load the environment module your application is in and run it. Do not analyze data this way, but running a text editor, a web browser to log in and get an api token from a remote service or some other very short and lightweight operations are fine.

Open OnDemand

Normally the X11 DISPLAY variable is set once the X11 server is started. This can be done manually, as described above, but an easier method is to use Open OnDemand since that will start an X11 server and allocate the frame buffer automatically.

Open OnDemand provides a web-only interface to starting and attaching to GUI programs with seamless connections through web browsers. This service is available at the following URL:

https://ondemand.rc.ufl.edu

Many applications have their own interfaces, but other can also be launched by launching a HiPerGator Desktop and then opening the application with the desktop interface.

Using Open on Demand on HiPerGator

Play icon.png [5 min, 11 sec] This video covers the use of Open on Demand https://openondemand.org/ on HiPerGator via https://ood.rc.ufl.edu/.

  • Connect to https://ood.rc.ufl.edu/
  • Launch a terminal
  • Launch many graphical applications like Rstudio, Matlab and Freeview
  • Manage job submission
  • Upload, download and edit files via your browser
Retrieved from "https://help.rc.ufl.edu/mediawiki/index.php?title=GUI_Programs&oldid=27380"