C H A P T E R  A

User Settings

This appendix covers topics that users as well as administrators may find useful. There are sections for:

Supported Devices and Libraries

Sun Ray Server Software supports a wide variety of end-user devices, including mass storage and end-user peripherals that can be connected to a Sun Ray DTU’s serial, parallel, or USB ports; however, because of the growing number of USB devices available, it has not been possible to test all of them on Sun Ray DTUs.

Supported Mass Storage Devices

Sun Ray Server Software 4.0 supports the use of flash disks, memory card readers, Zip drives, and hard drives on Sun Ray DTUs. It allows data CDs and DVDs to be read but not written. It does not support floppy drives.

For troubleshooting tips, please see Troubleshooting USB Mass Storage Devices.

Note - Most devices claiming USB 2.0 compliance are backwards compatible and should work with Sun Ray Mass Storage.

Sun Ray DTU Settings

Sun Ray Settings is an interactive GUI that allows the user to view and change the settings for the Sun Ray DTU that the user is currently logged into.

The Sun Ray Settings GUI contacts the Session Manager to determine which DTU is currently being used and connects to that unit to get the current values. The GUI maintains a connection to the Session Manager so that the Session Manager can notify the GUI if the user moves to another DTU by removing the smart card and inserting it into another DTU.

procedure icon  To Change the Sun Ray Settings

1. Press the hot key (by default Shift-Props).

The Sun Ray Settings window is displayed.

FIGURE A-1 Settings Screen

It is preferable to use the utadmin command rather than this visual display.

2. Use the Category pull-down menu to access Audio Output, Audio Input, Display, and Video settings.

3. To change a setting, move the appropriate scroll bar, checkbox, or pull-down menu.

The DTU is updated immediately.

The only exception is the “Resolution/Refresh Rate” setting, which prompts the user with confirmation dialog boxes before and after the change is made on the DTU.

4. Press the hot key to close the window.

Note - Only one instance per session of Sun Ray Settings runs in hot key mode.

Monitor Settings

Sun Ray users can modify their screen resolution settings by invoking utsettings.

Any resolution selection made within a session remains effective whenever the session is displayed on that particular DTU. The selection is not lost if the unit goes into power-save mode or is power-cycled; however, the resolution settings selected through utsettings apply only to the DTU where utsettings is run.

When a user moves to another DTU, the resolution settings do not accompany the user to the new DTU, but the settings remain effective for the user’s session on the original DTU if the returns to it via hotdesking.

If the session is associated with a personal mobile token, then utsettings offers to make the selected timing permanent. If a user accepts that offer, then the timing is retained and reused on that user’s subsequent personal mobile token sessions on the same DTU.

In addition, the administrator can use the utresadm command to:

Any conflict among settings is resolved in favor of the most specific configuration rule. That is, a configuration record for a specific token at a specific DTU takes precedence over a record for any token at that specific DTU, and a configuration record for any token at a specific DTU takes precedence over a record for any token at any DTU.

For further details, see the utsettings and utresadm man pages.

Hot Key Preferences

Hot keys can be configured for various Sun Ray utilities. The scope for these hot keys can be:

To support these levels of customization, the utilities look for the properties files in TABLE A-1, in the following order, at startup:

TABLE A-1 Sun Ray Settings Properties Files






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



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



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

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

The format of the hot key entry in these properties files is:


where <utility_name> is the name of the utility, such as 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. Values are shown in TABLE A-2.

TABLE A-2 Specific Hot Key Values

Example Value



Invoke the Settings GUI.


Invoke the Pop-up GUI


Press this key sequence twice to kill a session.


Press this key sequence twice to kill the process that has taken control of the X server.


Display the DTU’s MAC address.


Power cycle the DTU.

Hot Key Values

procedure icon  To Change the Hot Key for the Settings GUI

If you do not want to use Shift Props as your default hot key, use the system-wide defaults file to specify a function key. Users can still specify their preferences in the user defaults file.

Use this procedure to modify the settings GUI for all users on a server.

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

Tip - If you want to make the change mandatory, change the value in the
/etc/opt/SUNWut/utslaunch_mandatory.properties file.

2. Locate the original hot key entry for the utdetach utility and place a # in front of that statement.

The # comments out the first hot key property.

# utdetach.hotkey=Shift Pause

3. Type in the new hot key property after the first statement. For example,

utsettings.hotkey=Shift F8

4. Save the utslaunch_defaults.properties file.

The new hot key takes effect when the next user logs in. The next user to log in uses the new hot key to display the Sun Ray Settings screen. Users who were logged in before you changed the hot key continue to use the old value.

procedure icon  To Change the Hot Key Setting for a Single User

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

Note - 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.

Note - You can modify other hot keys in a similar fashion.

Power Cycling a Sun Ray DTU

procedure icon  To Power Cycle a Sun Ray DTU

single-step bullet  Disconnect then reconnect the power cord.

procedure icon  To Perform a Soft Reset

single-step bullet  Use the key sequence Ctrl-Power. The Power key at the right side of the top row of a Sun Type 6 or Type 7 keyboard has a crescent moon icon; the soft reset key sequence is often called Ctrl-Moon.

procedure icon  To Kill a User’s Session

single-step bullet  Use the key sequence Ctrl-Alt-Backspace twice.

This kills the Xserver process, alerting the current session’s parent process to start another session.