|Installing NX Client
Note: Write access is necessary to be able to continue with the installation, update or removal of the client software.
Select where to install NX Client and confirm by clicking on the Next button.
The Setup Wizard will allow you to create the program shortcut in the Start Menu by default or in any folder of your choice.
To proceed, click on the Next button as usual.
A further dialog will enable you to create an additional shortcut to the application on your desktop.
Confirm according to your personal preference.
The final dialog will ask you to confirm the installation of NX Client on your machine.
Installing the NX Client on Mac OS X
- Using Finder, navigate to the folder where you downloaded the NX client from NoMachine's site.
- Double-click the nxclient-*.*.pkg file. That should open up the installer.
- At the welcome screen, click Continue:
- Select the volume where you want NX Client to be installed, and click Continue:
- Click Upgrade:
- Enter your password, and click OK:
- To complete the installation, click Close:
- After a successful installation, you should see NX utilities in the "Applications" folder of Finder, as shown here:
|The NX Connection Wizard GUI|
|The NX Connection Wizard is a GUI to guide you through the basic steps to set-up a session. It allows you to create and configure your first session file by using the default settings, which should be enough in most cases.
Enhanced session configuration is possible via the NX Client GUI. You can run either the Connection Wizard and the NX Client GUI at any time, by accessing them via the NX Client entries in the Programs Menu.
|Configure Your Session Via the NX Connection Wizard|
|The first step is to give a name to the session and specify, in the Host field, either the hostname or IP address of the machine where your NX Server is running, and the port where the SSH daemon is listening on the server host, by default 22.
This wizard also allows you to specify the link type for your connection. More information which will help you to choose the best link type to fit your needs will be available in section 3.1 related to the NX Client GUI, General tab.0
|Choose Which Type of Session You Would Like to Run|
In the Desktop wizard you may choose which kind of session you would like to run. Let's say that you want to start a Gnome desktop with size 1024x768.
|Create a Session Shortcut and Run the NX Client GUI|
|The final stage of the NX Connection Wizard allows you to create a session shorcut on the desktop, associated to the session file you are creating.
By selecting the Show the Advanced Configuration dialog checkbox during this stage the NX Client GUI will run once you exit from the NX Connection Wizard, allowing you to further configure the NX Client.
|The NX Client GUI|
|The NX Client GUI, coming with a default configuration suitable for most cases, allows you to configure specific settings that may better fit your environment.
The paragraphs to follow will explain one by one all the GUI tab and related settings.
Server – Host
Server - Port
Server - Remember my password
Server - Key
Unix – run either a X11 desktop as KDE, GNOME, CDE and XDM or a single application by choosing the Custom option.
Windows – run a RDP session on a Windows Terminal Server.
VNC – run a VNC session on a VNC server.
Shadow – attach to an already running X11 session or to the native display (session shadowing and desktop sharing).
Some session types may require additional settings. For example the 'Windows settings' panel is for specifying hostname for the RDP server, while the 'VNC settings' panel is for specifying hostname and port for the VNC server. You may refer to the following article to get more information on support for RDP and VNC sessions with NX 3.0.0 or higher:
In the "Custom Settings" panel you may instead specify the remote application to be run in seamless mode. When the "Floating window" option is selected, nxagent operates in rootless mode, i.e. it impersonates the application's display and can rewrite the X traffic down to the real X server to hide the details of the network and be extremely bandwidth efficient. When the "Disable X agent encoding" option is selected, the NX proxy tunnels the raw X protocol traffic. NX can't do much in this case, other than compress the X traffic better than any known generic compressor. The application, in fact, is connected to the real display and so it will still suffer from all the limitations of the X system. Running the single application as "New virtual desktop" still reaps the benefits of the nxagent capabilities, but, in this case the agent is not running in rootless mode, i.e. the the application window may not match the local desktop size and may be displayed inside a black parent window.
Desktop - Link type
Set the type of network connection that is going to be used to connect to the remote proxy. Some session parameters, such as the compression level, depend on this setting. For example, the link MODEM uses high compression levels for both protocol and images, while the link LAN disables the protocol compression and uses a low compression level for the image encoding, to make the best use of the available bandwidth.
The image encoding can be customized regardless of the link type. The different encoding types are explained in the Display - Use custom settings - Unix display settings section in this document.
Lazy encoding policies, i.e. the ability to defer image updates, are activated by default for all link types other than for LAN. However, you have the possibility to disable deferred screen updates in the NX Client GUI -> Advanced tab.
Display - Use custom settings - Unix display settings
Unix - Display settings – Images
You can force the selected image encoding to be used, overriding the default encoding set according to the link type.
Unix - Display settings – Performance
Display - Use custom settings - Windows display settings
Display - Use custom settings - VNC display settings
|The Advanced Tab|
|The Environment Tab|
User NX directory
Remove old session files
System NX directory
Select NX fonts
Load NX Connection Wizard
The first thing you'll want to do is start up the NX Client Connection Wizard. It should be in your applications if you're on a mac or in the start menu, in the NX Client folder if you're using Windows. It should start up looking like this:
Select a Profile Name and Machine to Connect to
Your profile name is in the box titled "Session". NX Client we'll save your info under this profile name. For this example we'll use "John's Session".
The host will be machine.crbs.ucsd.edu, where "machine" is the name of any of the CRBS workstations such as "war" and "famine". For this example we will use connect to phoenix, so the host will be "phoenix.crbs.ucsd.edu". Click "Next".
Select Desktop and Desktop Size
The next thing you'll need to do is set your desktop and it's size:
Next to the box that says "Unix", there will be a box that says "KDE". Click that and change it to "GNOME". Below that it says "select size of your desktop resolution". Unless your computer is greater than 8 years old, or you know you are running a low resolution, select "1024x768" to get a large desktop window for your connection. If you know you are running a low resolution, or would simply like a smaller desktop window, select a smaller resolution as appropriate. Click "Next".
Complete the Wizard
This is the next screen you'll see telling you that you've successfully created your profile:
Do not check in the "Show the Advanced Configuration dialog" box unless you know you will need to change specific settings. See the "settings" tab on this wiki for more details. Click "Finish".
Enter Your Username and Password
The next screen you'll see is this:
Enter your username next to "Login" and your password next to "Password". User your standard CRBS username and password. Click "Login". You should see a dialog box showing yourself being connected, it will look something like this:
You Are Connected!
You should see yourself connected with a window that looks like this:
Click "System" in the top left and then "Log Out username" at any time to disconnect. Enjoy!