Secure Global Desktop Administration Guide > Arrays, servers and load balancing > X Protocol Engine properties (server-specific)

X Protocol Engine properties (server-specific)

Attributes on the X Protocol Engine Properties For... panel of Array Manager let you tune graphical emulator processes for a particular array member. The attributes apply independently to each Secure Global Desktop server.

From the command line, use tarantella config to view and edit these settings.

Changes to these attributes take effect for new Protocol Engines only. Existing Protocol Engines are not affected.

Array ManagerCommand lineDescription
Command-line Arguments--xpe-args args
  • Any arguments to the Protocol Engine. For example, the name of a log file.
  • You shouldn't need to change this unless asked by Technical Support.
Monitor Resolution--xpe-monitorresolution dpi
  • The default monitor resolution (in dpi) to assume.
  • You can override this value using an application's Monitor Resolution attribute.
Font Path--xpe-fontpath fontpath
  • Directories on the Secure Global Desktop host containing the fonts used by the X Protocol Engine.
  • Font paths are listed in search order.
  • Use %%INSTALLDIR%% to mean the Secure Global Desktop installation directory.
  • You can include font servers, for example tcp/boston:7000.
  • On the command line, separate each directory in the font path with a comma ",".
RGB Database--xpe-rgbdatabase file
  • Full pathname on the Secure Global Desktop host of the RGB database used by the X Protocol Engine to resolve color names to RGB values.
  • Use %%INSTALLDIR%% to mean the Secure Global Desktop installation directory.
Keyboard Map--xpe-keymap lang | client-locale | file
  • The default keyboard map to use for graphical applications.
  • To use a keyboard map based on the locale of:
    • the Secure Global Desktop server, select Use lang variable.
    • the client device, select Use client's input locale.
    The actual keymap used is determined using the /opt/tarantella/etc/data/keymaps/xlocales.txt file.

    Note You can use the * and ? wildcards in the xlocales.txt file to support a wide range of input locales. See the xlocales.txt file for details.

  • Alternatively you can type a filename to always use a particular keyboard map.
  • You can override this for each user with the person object's Keyboard Map attribute.
Client Window Management--xpe-cwm-maxwidth pixels

--xpe-cwm-maxheight pixels
  • Two attributes for tuning this particular value of the Display Using attribute.
  • The maximum expected horizontal and vertical display resolution for client devices connecting to this server.
  • Only applies for applications with Display Using set to Client Window Management, to avoid clipping problems.
Session Start Timeout--xpe-sessionstarttimeout seconds
  • How long the X Protocol Engine waits for X applications to connect.
Process Tuning: Maximum sessions per engine--xpe-maxsessions num
  • The maximum number of emulator sessions each X Protocol Engine handles.
  • More X Protocol Engines are started to meet demand.
Process Tuning: Maximum users per engine--xpe-maxusers num
  • The maximum number of users each X Protocol Engine handles.
  • More X Protocol Engines are started to meet demand.
Process Tuning: Exit after--xpe-exitafter seconds
  • The length of time an X Protocol Engine process will continue running without any active connections.
Related topics