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 | Action |
---|---|---|
Mute | Ctrl-Pause-CursorDown | Mute and unmute audio. |
Softer | Ctrl-Pause-CursorLeft | Decreases the audio volume. |
Louder | Ctrl-Pause-CursorRight | Increases the audio volume. |
Mute-Softer-Louder or Stop-N | Ctrl-Pause-N | Displays the Sun Ray Client's MAC and IP addresses and server IP address. |
Ctrl-Power or Stop-A | Ctrl-Pause-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. |
Stop-C | Ctrl-Pause-C | Clears any local configuration data on the Sun Ray Client. |
Stop-O | Ctrl-Pause-O | 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. |
Stop-V | Ctrl-Pause-V | Displays the Sun Ray Client's model, MAC address, and firmware version. |
Ctrl-Alt-Bksp-Bksp | Ctrl-Alt-Bksp-Bksp | Terminates a session. This hot key cannot be reconfigured to another value, but it can be disabled. For details, see the utxconfig man page. |
Ctrl-Alt-Del-Del | Ctrl-Alt-Del-Del | 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.
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
File | Scope | Description |
---|---|---|
| System | This file contains the default properties. Any properties specified override any defaults built into the application itself. |
| User | This file contains the user's preferred values, which override any application or system-wide defaults. |
| System | 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
,
where utility_name
.hotkey=value
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 | Action |
---|---|---|
|
| 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.) |
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.
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.
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
Type the new hot key property after the first statement.
For example:
utdetach.hotkey=Alt F9
Save the utslaunch_defaults.properties
file.
Log out and log back in to enable the new hot key.
A user's hot key settings override any system-wide default settings, unless they are mandatory.
In the user's home directory, create the
.utslaunch.properties
file.
Make sure that the user owns and can read this file.
Add a line to the .utslaunch.properties
file with the value for the hot key.
For example:
utsettings.hotkey=Shift F8
Save the .utslaunch.properties
file.
Log out and log back in to enable the new hot key.