Remote Desktop Access with FastX

FastX allows users to start remote desktop sessions on CIRC compute nodes within a SLURM allocation that users can access via their web browser or a desktop client.

Web Browser

To get started, go to https://bluehive.circ.rochester.edu and login with your NetID credentials.

After logging in you can click the '+' icon to start a new session.

You should then see two bookmarks.

The bookmark for Desktop Session just requests 1 cpu, and 4 gb of memory for 8 hours, while the bookmark for Mate Session 3D requsts an entire node in the visual partition for 8 hours. You can adjust the job resources for either of these by adding slurm options to the command. For instance, if you wanted a slurm job for 5 days, with 5 nodes, 24 tasks per node, and 63 gb per node in the standard partition, you could modify the command to be

   desktop-session -p standard --time=5-00:00:00  -N 5 --ntasks-per-node=24 --mem=63g

Keep in mind that the more resources you ask for, the longer it may take your job to start. If you do not specify any partition, it will default to the interactive partition and provided your resource request is within the limits for the interactive partition, your job should start immediately. For information on resource limits for various partitions see (Running Jobs)[BlueHive2.5/Running_Jobs.html]

You can then click Start to submit your Remote Desktop session job to the scheduler.

You should then see a popup message stating that your job has been submitted along with information about the job number etc...

After clicking outside of that window, you should eventually see your session appear (once your job starts) in either the list view

You can then select your session to open it in another tab in your browser

Note, if you hover your mouse over the top middle region of the desktop, you will see a drop down menu with buttons for accessing the clipboard, resizing your desktop to match your browser window size, adjusting various preformance settings, setting up sharing, and a button to pin the drop down menu so that it does not autohide.

You can then run applications, launch parallel tasks with mpirun or srun - all within your remote desktop session - and they will leverage the slurm resources you requested when starting your remote desktop session.

You can close your browser without terminating your remote desktop session - and then reconnect from another device etc... However once your slurm job ends after 8 hours (or however long you requested), your remote desktop session will be terminated along with any running tasks.

If you are done with your remote desktop session, you should make sure you logout so that your remote desktop session terminates, ending your slurm job, and freeing up resources for other users and jobs.

Desktop Client

If you'd prefer to use a desktop client, you can download the installer for your platform from the CIRC Downloads Page.

Once you've installed and opened the client, click the '+' icon to start a new session.

You can then specify a name and the URL (https://bluehive.circ.rochester.edu) for the connection, and click Save.

You will then be asked to log in with your NetID and password.

Once you're logged in, you can click Continue.

You can then select the Desktop Session to get started with a default session. (See above for more details on the types of sessions).

Once you click OK, the session will be submitted, and you can click Close on the confirmation screen.

You can then click the 'play' button on the session to open it.

You can then run applications, launch parallel tasks with mpirun or srun - all within your remote desktop session - and they will leverage the slurm resources you requested when starting your remote desktop session.

You can close the desktop client without terminating your remote desktop session - and then reconnect from another device etc... However once your slurm job ends after 8 hours (or however long you requested), your remote desktop session will be terminated along with any running tasks.

If you are done with your remote desktop session, you should make sure you logout so that your remote desktop session terminates, ending your slurm job, and freeing up resources for other users and jobs.