13.2. Sun Ray Client Hot Keys

13.2.1. How to Configure the Utility Hot Keys

For a Sun Ray Client, there are a number of predefined hot keys that can trigger an activity or event on a client, which are shown in Table 13.2, “Sun Ray Client Hot Keys”. The key sequences can be either an Oracle-specific key combination (using keys that might exist only on Oracle keyboards) or by an alternative key combination that does not require Oracle-specific keys.

The activities controlled by these hot keys are specific to a Sun Ray Client. Desktop software running in the Sun Ray session might provide a separate keyboard shortcut facility that provides additional hot keys for desktop activities, perhaps including the ability to launch certain programs.

By default,the alternative prefix key combinations are Ctrl-Pause and Ctrl-Shift-Alt-Meta. The Ctrl-Pause key sequence is used throughout this documentation. The Ctrl-Shift-Alt-Meta key combination can be changed through the Advanced menu of the Configuration GUI (Enter Alternative STOP modifiers) or the stopkeys keyword in the .parms file. It can be set to any combination of the four keys, but at least two must be used.


The Meta key has different names on different keyboards: on a PC keyboard, it is the "Windows" key, and on a Mac keyboard, it is the "Command" key.

Table 13.2. Sun Ray Client Hot Keys

Oracle-specific Hot Key

Non-Oracle Hot Key




Mute and unmute audio.



Decreases the audio volume.



Increases the audio volume.

Mute-Softer-Louder or Stop-N


Displays the Sun Ray Client's MAC and IP addresses and server IP address.

Ctrl-Power or Stop-A


Power cycles the Sun Ray Client. On an Oracle keyboard, the Power key has a crescent moon glyph and is positioned at the top right corner of the keyboard.



Clears any local configuration data on the Sun Ray Client.



Enables or disables the On-Screen Display (OSD) troubleshooting icons when a Sun Ray Client boots.

Stop-S or Stop-M

Ctrl-Pause-S or Ctrl-Pause-M

Opens the Configuration GUI to modify how to initialize the client. The Configuration GUI must be enabled on the client.



Displays the Sun Ray Client's model, MAC address, and firmware version.



Terminates a session. This hot key cannot be reconfigured to another value, but it can be disabled. For details, see the utxconfig man page.



Terminates the process that has taken control of the X server.

There are also hot keys used to launch the utsettings or utdetach Sun Ray utilities. You can configure these hot key sequences through your $HOME/.utslaunch.properties file, or they can be set by the administrator per a site-wide basis. See Section 13.2.1, “How to Configure the Utility Hot Keys” for details.

13.2.1. How to Configure 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:

  • System-wide default setting

  • User default setting

  • System-wide mandatory setting

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

Table 13.3. Sun Ray Settings Property 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 property files is utility_name.hotkey=value, 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 13.4, “Defaults for Configurable Hot Key Values”.

Table 13.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-smart card mobility session.) 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.

  5. Log out and log back in to enable the new hot key. 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.