Setting Up a Desktops Session

Running Desktops

This page is dedicated to instructing you on how to use Rescale Desktops. In order to access the Desktops feature, log in to your Rescale account (Rescale Platform). If you don't have a Rescale account, you can create an account at no charge here: Rescale Signup.

Please contact us if you're having trouble.

To proceed with setting up a Desktops session, click on the Desktops tab and select + Create New Desktop.

New Desktop

You can give your session a unique title to locate it easily later. Next, you'll select the type of software you want to run on the desktop. For this tutorial, we're using ParaView GUI. You'll note that once you select the software, the Hardware section below will automatically update to offer only hardware compatible with the work you want to do.

At this point, you can add any already-existing jobs you'd like to the desktop.

Finally, select the hardware you want to use and set an appropriate walltime limit.

Once you've made your selection, you can click Launch and it will start the session. This will typically take a few minutes.

Here's what the desktop setup page will look like:

Custom Desktop

Connecting to your desktop

Once the server has started, you can connect either in-browser or via a client on your local machine.

Connect in-browser.

Connecting in-browser is frequently the lowest-effort connection, but it provides a lower-resolution desktop session. To connect in-browser, click the Connect button once it appears, as shown below. It should appear once the OS is installed and updated and the Rescale runtime is configured.

After you click the Connect button, you can use the remote desktop right in your browser.


Connect with a client

Connecting with a client on your own computer can offer much better graphics than an in-browser connection, but it requires a little more setup. The process is very different for Windows and Linux desktops, but in both cases, these are the required ports for visualization:

RDP: Port 3389
VNC: Port 5900/5901
DCV: Port 8443

If your company does not allow traffic through one of these ports, that method of desktop visualization will not work!

Steps for connecting to your windows desktop via a client on your computer:

  1. Download a client. Recommended options:
    • NICE DCV is recommended in most cases, as it supports GPU acceleration. You can download it here.
    • A Microsoft Remote Desktop application (RDP). For instance, Microsoft Remote Desktop for Mac (download) or Remmina for Linux (download).
  2. Click the dropdown next to the Connect button, and select the connection method you plan to use (DCV or RDP). Expand its instructions.

Connect With Client

Connect Desktop

  1. Click on Generate New Password.
  2. Click Download File for your chosen client.
  3. Double click the file to open. You will be prompted to enter the password generated in step 3. Note that it is case-sensitive. The same password is used on the Windows user sign-in page.

Windows Login

You should now be viewing your remote desktop. The shortcut to the attached Software can be found on your desktop.

Windows Desktop

For Linux Desktops you have several options depending on the specifics of your job. The most common two are viewing using NICE DCV or connecting via an ssh tunnel.

In either case, you'll click the dropdown next to the Connect button and then hit "connect with client":

Connect With Client

Linux Desktop

Connecting with NICE DCV (recommended)

  1. Download NICE DCV (here).
  2. Click on Generate New Password.
  3. Click Download File for your chosen client.
  4. Double click the file to open. You will be prompted to enter the password generated in step 3. Note that it is case-sensitive. The same password may be used on the user sign-in page.

Connecting via ssh tunnel and VNC

  1. Download a VNC client of your choice. Real VNC is a nice (and free) example (download).
  2. Set up an SSH tunnel.
    1. Ensure you have your SSH key set in your user profile. Follow the instructions here.
    2. Download the appropriate shell script – use the Linux option for anything Unix-like (including Mac), and the Windows option for Windows.
    3. Run the shell script and keep it running in the background.
  3. Download the connection file.
  4. Double click the downloaded file to connect to your tunnel.
  5. Generate a password and enter it to access your desktop.

You should now be viewing your remote desktop. please use the terminal to navigate to and launch the executable under the /program/ directory.