Status

FastX

FastX is a service which allows you to run graphical applications on Spartan, through a web browser. FastX submits a job to the batch system which executes a graphical environment (in this case, XFCE). One can then connect and disconnect to the graphical environment as many times as one would like using your web browser while the batch job is still running.

To use it a user should open up a web-browser in their local system, go to Spartan FastX and log in with their Spartan username and password. Note that FastX is only available on the Uni network or via the Uni VPN.

Once connected to the graphical environment, one can start a terminal session, and load modules, run scripts etc to load graphical applications like MATLAB.

To start a session, click on the '+' in the top left hand corner

Follow with a single click on 'XFCE', and then click 'Launch'

Select the desired parameters for the session from the menu. Session Length, resources, or project execution can be specified. Note that larger sessions naturally take longer to be placed, particularly at times of heavy interactive use.

  • Click outside the window to return to the main screen. Please note that it may take several seconds for a session to launch. One is limited to a single desktop session per user.

  • Click on the XFCE link to connect to a session

  • Once connected, applications can be launched or scripts via the Terminal in the graphical session

  • e.g. To launch MATLAB, load the MATLAB module, and then run the matlab command

Open OnDemand

Open OnDemand is a HPC portal that provides web access to HPC resources, such a file management, command-line access, job management, and access to certain web-enabled applications (e.g., RStudio, Jupyter Notebooks). To access OpenOnDemand one needs to create a session from a Spartan login website with the user name and password.

Login to Open OnDemand

The following shows an example opening screen.

Most of the menu items are self-explanatory. The "Files" menu item provide a GUI interface to a user's home directory. The "Jobs" menu has two parts, an "Active Jobs" application and a "Job Composer". The "Clusters" menu item provides an application for command-line access to Spartan in a web-browser. The "Interactive Apps" item provides links, replicated on a left hnad menu item, to a Jupyter Notebook server and an RStudio Server. In addition, there is a image for managing your interactive sessions. a help icon, a user icon, and a log out menu item.

Files

The Open OnDemand File Explorer application provides a graphical representation of your home directory with a tree structure on the left side and file names, human readable file size and modification date on the right main division. Content can be navigated in the browser with the right main division changing accordingly. A top menu division allows for directory navigation ("Go To"), a session to be opened in a browser-based terminal emulator, the creation of new files and directories, the capability to upload files, and options to show hidden files ("dotfiles") and the the file ownership and mode.

Files may be viewed, edited, renamed/moved, downloaded, and deleted. Because the session is running in the web-browser whatever file applications associations one has with the browser will be used on file. This is especially relevant for files in a binary format (.pdf, .docx, etc). For text files, Open OnDemand has its own viewer and editor in the browser. Note that the deletion rules are the same as being on the cluster; deleted is gone!

Multiple files can be selected with shift and cursor navigation (either mouse-click or arrow keys), and there is an menu option for select/unselect all.

Jobs

The Job Composer allows for the creation of some jobs with simple options, along with submitting such jobs, stopping them, and deleting them. The latter three are indicated by the play, stop, and trashcan icons. A new job can be composed from a default template or a specified path. Jobs will be in a OnDemand specified directory by default e.g., /home/lev/ondemand/data/sys/myjobs/projects/default/1

Jobs can be edited with the Open OnDemand editor, and this will almost certainly be necessary to add modules etc. Consider using the Job Composer or make use of one of the many application-specific templates in /usr/local/common

Clusters

The cluster menu option only has one item, SSH access to Spartan. This will provide a terminal emulator within the browser session. It will also make use of any .ssh config or passwordless SSH that has been previously installed.

Interactive Applications

The two interactive apps on Spartan's Open OnDemand are Jupyter Notebook and RStudio Server. These work by starting up an interactive job on Spartan and forwarding the display to the web browser session. Thus, when on starts on of these interactive apps parameters need to be entered to start the session.

For example, to use GPUs and Jupyter with OpenOnDemand, add "fosscuda/2019b jupyter/1.0.0-python-3.7.4" in the Modules section, "gpgpu" in the Partition section, and "gpgpuresplat" (or other appropriate group with GPU permissions) in the QoS section, and change the "Number of GPUs" to be 1

Some known issues

Many operations will with Open OnDemand will be somewhat slower than direct access to Spartan as there is some overhead involved. However, there is some additional issues to be aware of.

  • Filenames or directories with XML or HTML special characters (<. >, &) may cause issues with the display, resulting in an unusuable File Explorer application.

  • Uploading very large files (that exceed the capacity of the temp directory) may fail or send a partial file without reporting an error.

In all these cases it is recommended using a system that interacts with the file system directly (e.g., scp, rsync, FileZilla, WinSCP, etc)

  • Opening larger files (multiple megabyte) in the file explorer can cause the right click to fail in Firefox.

  • Attempting to open the tree's root menu in the File Explorer with a right-click in a new tab causes a navigation error.