- Creating a connection from a remote host
- Choosing the right connection
- Multi Monitor Support
- Disconnect (suspend) and Reconnect sessions
- Closing virtual desktops connections
- Improving image quality
- Connection testing (still in preparation)
- Contact persons
- Further manuals per beamline
- I do not get a connection. Whats wrong ?
- There are many connection icons - which should I choose ?
- I do not see the icons, which allow me to connect to the physical desktops
- I do not see the name of the computer to which I want connect
- I get a "permissioned denied" error message
- My firewall rule doesn't allow access to 4000 port (outbound)
PrerequisitesThe following prerequisites must be fulfilled
- You need a PSI_account (an e-account or DUO account is not sufficient). If you do not have such an account, please request it via your PSI contact person.
- You need to have the NX software installed on your PC/Laptop/Tablet. The NoMachine client software can be downloaded and installed for Windows, Mac, Linux, Android and iOS systems free of charge. At the time of writing the NoMachine versions 5 and 6 software is recommended
Creating a connection from a remote host
- Run NX client and create new NoMachine connection
- Enter host rem-acc.psi.ch
- Enter your PSI_account name and password
- Choose one of the offered physical desktops or create a new virtual desktop
- For the proposed settings choose defaults except for:
- physical desktops: un-click the tick mark: "Change the server resolution to match the client when I connect"
- virtual desktops: choose "Resize remote screen" in the display options settings
Set up a NoMachine connection to rem-acc.psi.ch
Ensure you are using NoMachine client version 5 or later to connect. Start your NX/NoMachine client, select New and then NX protocol
Specify the host name rem-acc.psi.ch and leave the UDP flag ticked
Keep the default option "Password"
Keep the default settings for HTTP proxy: most of the time the no-proxy option is correct. Contact your local system administrator if it does not work for your host:
Here define a meaningful name for the connection. This profile will later be used for all connections to the PSI network
In all future NoMachine sessions the following will be your starting screen.Top
Choose your newly created profile and click the Connect button. At the first connection you will be asked to verify the fingerprint of the ssh certificate of rem-acc.psi.ch. If you get the same string "26 50 D8:..." click "yes" to confirm.
Enter your PSI_account name and password.
Here you can select from a list of available physical desktops and from a list of existing sessions to the allowed hosts, including those from other users. Most of the time you will want to ignore the latter and either connect to a physical desktop (typical use case for the beamlines) or click the link "Create a new desktop" for a new virtual desktop session.
You may want to mute the sound (when connecting to the physical desktop)
For physical desktops you usually want to un-check the option "Change the server resolution". For the virtual desktops the recommended option is "Resize remote screen" (this you change later withTop
ctrl-alt-0and in the display options)
Choosing the right connectionNoMachine offers two types of remote connections, physical and virtual desktops.
- Physical desktops
- Here you connect to a actual machine having a graphic card and connected monitors. You "see" the same displays as the person who sits in front of the physical computer. The session reacts to both mouse and keyboard connected locally and remotely. This behaviour can be configured, e.g. if a "view only" option is required.
- Virtual Desktops (Linux only)
- The virtual desktop functionality allows individual multiple Linux desktops to run independently on the same host. Each user has her/his own personal 'virtual' Linux desktop.
In the NoMachine client, you can choose which desktops to see. Initially you may see a lot of connections, both active and suspended, from all users who have access to the same hosts than you have. To avoid this clutter you can click on the "All desktops" Button and choose "My desktops" instead. Or you type a search expression in the input field "Find a user or a desktop"
Both type of desktops allow for desktop sharing by different users, which is useful for collaboration use cases. For virtual sessions, this requires that the original user acknowledges such a request for desktop sharing. For physical desktops, this will depend on the configuration settings of the host.
Multi Monitor Support
Physical desktops are often connected to multiple monitors. In such a case the NoMachine Software offers which of the monitor(s) should be seen remotely. Type
ctrl-alt-0, choose display, then "Change Monitor" , select the screen(s) and finally confirm by hitting the "done" button 3 times
Disconnect (suspend) and Reconnect sessions
For both type of desktops, you have the possibility to disconnect a session (without closing it or logging out) and then reconnect later. You can reconnect from a different PC, which allows for migration scenarios, where e.g. to start your work in the office and continue your work from home, starting from the exact state where you left the session when disconnecting. Just typeTop
ctrl-alt-0, choose "Connection" and hit the "disconnect" button. If you later start NoMachine, potentially from a different location, this session will appear in the list of "My desktops", from where you can re-connect.
Closing virtual desktops connectionsSimply log out from the graphical session as you would do normally. It's recommended to close idle sessions.
Improving image quality
If you need the best resulting image quality during remote access, e.g. to study very fine structures in black and white tomographic images, then you should choose the following settings (at the expense of the overall reaction time, which may become a bit sluggish, depending on your internet connection) Type
ctrl-alt-0-> display -> change settings and set quality (the upper bar) to 100 %. In addition you can tick the options "Disable multi-pass display encoding". See also NoMachine's Detailed description
Connection testing (still in preparation)If you wish to test the procedures for remote access from your lab prior to your first remote access please contact your local contact who will arrange for access to a test machine. This will allow you to familiarize yourself with the NoMachine software as well as check the overall performance. The performance will depend mainly on the geographical distance from PSI and to a lesser extent on the available total network bandwidth of your internet connection.
- Access to beamline consoles and Ra cluster: the respective local contact of your beamline can help you.
Further manuals per beamline
I do not get a connection. Whats wrong ?Please check all of the following:
- Do you have a valid PSI_account and did you use this for making the connection ? If not, get one (see above).
- Is your local firewall allowing connections to port 4000 (NX protocol) ? If your local or your institutes firewalls blocks such outgoing connections you can try to set up a new connection and choose explicitly the ssh protocol instead of the default NX protocol.
- Did you check with your PSI local contact that you are actually entitled to connect now ? Tthe access can depend on the date/time, e.g. for access to scheduled beamline resources.
- Do you have a recent version of the NoMachine client installed (>= version 4.X, version 5 preferred)