In many cases you can make your first connection using the installed sample definitions and then use the sample as a model for connecting to other clients. For details, see Launch an X Client Application Using the Sample Definitions. Use the procedure below to configure a new client without using the sample definitions.
Configure the connection
Click the plus button next toto create a new client definition.
For, enter a descriptive name for this client definition.
For, specify the name or IP address of the computer that hosts your X client application.
Select yourfrom the drop-down list. The host type you select affects:
The syntax and selection of sample commands shown in thedrop-down list.
The default xauth command, which is used for user-based authorization. (Clickto view or edit this command.)
(For Telnet and Rlogin) The default login sequence. (Clickto view or edit the login sequence.)
(Optional) Enter a value for. If you leave this blank, you'll be prompted for your user name when you connect.
NOTE:If you're configuring Telnet, Rexec, or Rlogin, you also have the option of entering a password. Passwords are stored as clear text in the Reflection X Advantage database and in exported definition files. Leaving this blank is a more secure option; you'll be prompted for your password when you connect.
For, leave the default, , selected. Using this option provides access to sample commands, which are not available when is selected. For most situations, it's easiest to create a new client definition for each client you want to launch.
Click the xterm). If this works, you can modify the command to start your own client application. Additional Information about configuring commands follows this procedure.down-arrow to display a list of sample commands for the host type you selected. For your initial tests, it's a good idea to try one of the listed commands (such as
From thelist, select a default session definition to start when you start this client.
If you are connecting to a GNOME 3 desktop, specify a session definition that meets the requirements for a GNOME 3 desktop as shown in GNOME 3 Desktop Session Definition Requirements. If the X terminal desktop (GNOME 3) sample session definition is listed in the X Manager window under , you can specify this session definition. If it is not listed, you can add it by importing the linux_gnome3_templates.rxd template file. (See Import Installed Templates.)
Alternatively, you can create and use a new session definition. New session definitions are configured to meet requirements for GNOME 3 desktops. (See Sample Definitions.)
If your client command launches a desktop environment such as KDE, CDE or GNOME, select a session definition configured to. The sample session called "X terminal desktop" uses this configuration. For these clients, also enable
If you want your client application to run on your desktop, select a session definition configured to. The sample session called "My desktop" uses this configuration.
(Optional) Clickto configure additional settings for your connection. The options available depend on the connection method.
Use the sample commands in the Command list as a starting point for creating your own commands. These commands demonstrate the use of macros (%IP#% is one example). Macros are replaced by appropriate values when the command is sent to the client host. Macros can be used to specify the IP address for the display, the display number, the host name for the display, and additional information. For a complete list of supported macros and their descriptions, see X Client Commands - Macro Reference.
The following examples demonstrate frequently used features of command-line syntax:
The following command demonstrates using the %IP#% macro to specify the IP address and display number to be used for the client display.
xterm -display %IP#%
The next example adds a screen number.
xterm -display %IP#2%
This example adds an ampersand to the command and encloses it in parentheses. This is the syntax you'll see in the Reflection X Advantage sample commands. When the command is sent to the host, it runs in a subshell in the background. This format may be required with some Telnet connections to keep the application running.
(/usr/bin/xterm -display %IP#% &)
This last example shows how to start X clients in a modern Linux operating system environment where a unique session D-Bus is required. (Modern X Client Definition Requirements.)
(dbus-run-session -- gnome-terminal --display=%IP#% --wait &)
NOTE:For most connections, you can omit the parentheses and ampersand. If you do use this syntax in Secure Shell sessions, the ampersand is removed from your command before it is sent to the host. (The trailing ampersand isn't supported in combination with X11 forwarding).