10.10. Configuring the Utility Hot Keys

Hot keys can be configured to launch the utsettings or utdetach Sun Ray utilities. The scopes for these hot keys are as follows:

To support these levels of customization, the Sun Ray Client at session startup examines the following properties files in the order shown in Table 10.3, “Sun Ray Settings Properties Files”.

Table 10.3. Sun Ray Settings Properties Files






This file contains the default properties. Any properties specified override any defaults built into the application itself.



This file contains the user's preferred values, which override any application or system-wide defaults.



This file contains system-wide mandatory settings that cannot be overridden by the user. These properties override any application, system-wide, or user defaults.

If your policy is for all users to use the same standard hot key, modify the system-wide mandatory defaults file to specify this standard key. This setting prevents users from specifying their own hot key preferences.

The format of the hot key entry in these properties files is utility_name.hotkey=value, where utility_name_is the where utility_name is the name of the utility (currently either utsettings or utdetach) and value is a valid X keysym name preceded by one or more of the supported modifiers (Ctrl, Shift, Alt, Meta) in any order. Default values are shown in Table 10.4, “Defaults for Configurable Hot Key Values”.

Table 10.4. Defaults for Configurable Hot Key Values

Configuration Property Name

Default Hot Key




Invokes the Sun Ray Settings GUI.



Detaches the session from this Sun Ray Client. (Often used to to detach a non-smartcard mobile session.)

10.10.1. How to Change Utility Hot Key Settings for All Users

If you don't want your users to use the default hot keys to launch the utilities, you can set up the system-wide defaults file to specify different hot keys. Users can still specify their preferences in the user defaults file.

  1. As superuser, open the /etc/opt/SUNWut/utslaunch_defaults.properties file in a text editor.


    If you want to make the change mandatory for all users even if they have user defaults set, change the value in the /etc/opt/SUNWut/utslaunch_mandatory.properties file.

  2. Locate the original hot key entry for the utility you want to change and place a # in front of it to comment it out.

    For example:

    # utdetach.hotkey=Shift Pause
  3. Type the new hot key property after the first statement.

    For example,

    utdetach.hotkey=Alt F9
  4. Save the utslaunch_defaults.properties file.

    The new hot key takes effect for each user when that user next logs in. Users who were logged in before you redefined the hot key continue to use the old value.

10.10.2. How to Change the Utility Hot Key Settings for a Single User

A user's hot key settings override any system-wide default settings, unless they are mandatory.

  1. In the user's home directory, create the .utslaunch.properties file.


    Make sure that the user owns and can read this file.

  2. Add a line to the .utslaunch.properties file with the value for the hot key.

    For example:

    utsettings.hotkey=Shift F8
  3. Save the .utslaunch.properties file.

  4. Log out and log back in to enable the new hot key.