A P P E N D I X A - User Settings and Concerns

A P P E N D I X A

User Settings and Concerns

Supported Devices and Libraries

Sun Ray Server Software supports a wide variety of end-user devices, including both 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

Mass storage support in Sun Ray Server Software 3 is limited to flash disks, memory card readers, Zip drives, and hard drives. SRSS 3 does not support CD, DVD, or 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.

Managing Monitor Settings

Sun Ray users can modify their screen resolution settings by invoking utsettings. Any resolution selections they make within a session remain 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.

Settings selected through utsettings apply only to the DTU where utsettings is run; a user moving to another DTU does not bring the new timing along as part of the session. However, the selected timing is retained and used again if a user hot desks back to the original DTU.

If the session is associated with a personal mobile token (a smartcard or an NSCM credential), 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 may use the utresadm command to:

Arrange for a particular monitor timing to be used whenever a specific token is presented on a specific DTU.

Arrange for a particular monitor timing to be used on a specific DTU, regardless of the token that is presented at the DTU.

Arrange for a particular monitor timing to be used on all DTU's regardless of the token that is presented at the DTU.

Any conflict among settings is resolved in favor of the most tightly-specified 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.

Configuring Hot Key Preferences

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

System-wide default setting

User default setting

System-wide mandatory setting

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
File	Defaults	Description
`/etc/opt/SUNWut/utslaunch_defaults.properties`	System-wide	This file contains helpful default properties. Any properties specified here override any defaults built into the application itself.
`$HOME/.utslaunch.properties`	User	This file contains the user's preferred values, which override any application or site-wide defaults.
`/etc/opt/SUNWut/utslaunch_mandatory.properties`	System-wide mandatory	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:

<utility_name>.hotkey=value

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	Notes
`Shift+Props`	This brings up the Settings GUI.
`Ctrl+Alt+Backspace` twice	This kills a session.
`Ctrl+Alt+Del` twice	This kills the process that has taken control of the X server.
`Shift+Pause`	This detaches a non-smart card mobility session.
`Mute+Softer+Louder`	This displays the DTU's MAC address.
`Ctrl+Power` Key	This cycles power.

Users can configure both Shift+Props and Shift+Pause.

Setting Hot Key Values

To Change the Hot Key for the Settings GUI

If you do not want to use the Sun Props key 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.

To Change the Hot Key Used to Detach NSCM Sessions

Note - This resembles the procedure for changing the hot key for the settings GUI except for Step 3.

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

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

# utsettings.hotkey=Shift SunProps

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

utdetach.hotkey=Alt F9

To Change the Hot Key Setting for a Single User

1. In your home directory, create the .utslaunch.properties 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

To Power Cycle a Sun Ray DTU

disconnect then reconnect the power cord.

To Perform a Soft Reset

use the key sequence Ctrl-Power (the Power key at the right side of the top row of the Sun Type 6 keyboard has crescent moon icon).

To Kill a User's Session

Use the key sequence Ctrl-Alt-Bksp-Bksp.

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