August 16, 2021
Please first READ the FAQ ERISOne Virtual Desktop for the usage policy and to identify which remote desktop server to connect to before continuing with the installation process.
Install the NoMachine Enterprise Client application for your operating system (Mac, Windows, Linux) from the NoMachine download page or, if you have a MAC, you can find it on the PEAS self service. NoMachine is also available for the iPad in the Apple iOS App store.
We recommend you do not install the full NoMachine application directly from the NoMachine website because it includes a desktop sharing component in addition to the client needed to connect to ERISOne. If you are already using the NoMachine application for desktop sharing the client included in that package can be used to connect to ERISOne.
Setting Up Connection Details (one time only)
- Start the NoMachine application
- Click on the "New" button to add a connection
- Leave "Protocol" set to "NX" and press "Continue"
- Enter the selected server name in the "Host" field and press "Continue". If you still do not know which host you can connect please check first ERISOne Virtual Desktop.
- Select "Password" on the Authentication panel and press "Continue"
- Select "Don't use a proxy" on the Proxy panel and press "Continue"
- To complete the connection setup, press "Done" on the Save As panel, changing the connection name if desired
- The settings above are suitable for connection from the Mass General Brigham computer network and over VPN
- If connecting via the "ssh.research.partners.org" gateway, you may instead use the SSH protocol on Port 22, with advanced option "Use the System login".
- Both NX and SSH protocols are supported, we recommend leaving this option set to "NX". The NX protocol gives better performance when working with video and 3D graphical applications
- Press "Continue"
Connecting to the Virtual Desktop
If you have just completed "Setting up Connection Details" (above) the NoMachine window will already be open open, otherwise start the NoMachine application and click on the icon for the saved connection to the ERIS HPC virtual desktop server
- Select the connection created earlier from the connection list, and press "Connect"
- On the very first connection, you will be prompted to verify the certificate fingerprint - press "Yes"
- Enter your Mass General Brigham username and password on the login panel
- Tip: If "All Desktops" is indicated in the orange bar, click on this and change to "My Desktops" to filter out other users desktops from the view
- To resume an existing session:
- click on the entry for that session
- press "Connect"
- To start a new session:
- Press the "New Desktop" button
- select "Create a new virtual desktop"
- Tick the "Save this setting in the connection file" option to bypass this step in future
- press "Continue"
- informational dialogs will appear - press Ok to continue
After completing these steps, a Linux desktop should appear
When you are done working in the remote desktop, you can either log out or disconnect
- if you plan to return later to continue work in the session, activate the menu, click the "Connection" button and press "Disconnect"
- if you are done with this session or don't plan to resume work in the next week, select log out from the "System" menu in the top, left-hand corner of the desktop. This closes the desktop and frees a slot for other users.
Activate the menu inside a remote desktop session by
- clicking in the top right-hand corner (a "page-peel" activates when the mouse cursor hovers in the top right corner)
- pressing the menu hot-key, which is
- "control+option+0" [zero, not capital o] on a Mac
- "Ctrl+Alt+0" on a PC
Screen Size / Display Resolution
- To match the screen size of the virtual desktop to that of your computer
- On Mac OS X: press "control+option+0", then press the "Display" button followed by "Remote Resize Screen". If this does not work, try pressing the "Fullscreen" button twice
Odd Mouse behavior when connecting from MacOS X
Occasionally the Window Manager in the Linux remote desktop can enter a state where mouse clicks are not processed as expected. For example, a click on the application "File" menu may result in the application window moving, instead of opening the file menu. A work-around if this occurs is to use "Command+TAB" to switch back to the Mac OS computer, open and then exit the "Launchpad" view, then return to the remote desktop using "Command+TAB". At this point mouse-clicks will be processed as normal in the remote window.