13.1. How to Centralize Sun Ray Client Configurations (.parms)

Once a Sun Ray Client discovers the firmware server, it downloads its corresponding *.parms file. This file contains the firmware revision, which is checked against the client to make sure its firmware is up-to-date. The .parms file can also be used to centralize and provide other Sun Ray Client configuration values, such as the servers keyword used to specify the Sun Ray servers if the sunray-servers DNS entry isn't used. See Table 13.1, “Sun Ray Client Configuration Parameters (.parms)” for the list of configuration values.

By default, utsetup creates an initial set of .parms files for each Sun Ray model type. You can use the -i option of the utfwadm command and a template file to centralized updates for all the .parms file. The key/value entries in the template will be appended to each model-specific .parms file.

  1. Become superuser on the Sun Ray server.

  2. Create the /tftpboot directory on the Sun Ray server if it does not exist already.

    # mkdir /tftpboot
  3. Create the template for the .parms file.

    This template is a text file with key/value pairs, and it can be located anywhere on your file system. It is common practice to store it in the /tftpboot directory. In this example, the file is named srsconfig, and it resides in the /tftpboot directory.

    # vi /tftpboot/srconfig

    See Table 13.1, “Sun Ray Client Configuration Parameters (.parms)” for the list of key/value pairs that you can add to the .parms file.

  4. Use the utfwadm command to update the .parms files.

    The utfwadm command automatically uses the latest firmware installed on the Sun Ray server. Again, the following example uses /tftpboot/srsconfig for the template file location.

    # /opt/SUNWut/sbin/utfwadm -AaV -i /tftpboot/srconfig

Table 13.1, “Sun Ray Client Configuration Parameters (.parms)” lists the key/value pairs.

Additional key/value pairs included in the .parms files are in key=value format, with case sensitivity and no spaces allowed. Options that take values of 0 or 1 have a default value of 0 if not specified. The following table lists the options that are allowed. For details on the options that can be used to configure the .parms files, see the utfwadm man page.

Table 13.1. Sun Ray Client Configuration Parameters (.parms)




Sets the maximum bandwidth limit used by the Sun Ray Client, in bits per second.


Sets the command cache used to store the list of recent commands, in Kbytes. Default value is 512 Kbytes, maximum value is 8192 Kbytes, and a zero value disables the command cache.

compress=[0 | 1]

When set to 1, forces compression on. Default is 1 (compression on).

fastload=[0 | 1]

When set to 1, forces the maximum TFTP transfer size if the TFTP server supports it. The default is 512-byte packets. Over a high latency connection, using this setting typically doubles the speed of firmware downloads.

fulldup=[0 | 1]

When set to 1, forces full duplex setting.

enablegui=[force | none | hashed-passwd | prompt | off]

disablegui=[force | none | hashed-passwd | prompt | off]

Enables or disables the Configuration GUI. These keywords should be changed only with the utfwadm -G or utfwadm -g command, respectively. See Chapter 14, Sun Ray Client Firmware for details.


Forces the keyboard country code number (keyboard map) for a non-U.S. USB keyboard that reports a country code value of 0. This value can also be set on the Advanced menu of the Configuration GUI.

See Section 13.18, “Keyboard Country Codes” for the list of code numbers.


Sets the logging level for various classes of logging events, where XXX is one of Appl, Vid, USB, Net, or Kern. Valid values are 1 through 7, with 7 providing the most detailed logging output. A separate entry must be specified for each type. The logging information is saved in the /var/opt/SUNWut/log/messages file on the LogHost.

When using a shared network (LAN) with external DHCP server support (configured network using utadm -L on), logging for each event type is disabled unless the LogXXX value and the LogHost value are set.


The Sun Ray server where logging output is saved when one or more LogXXX entries are specified. Valid value is a resolvable DSN host name or an IP address of a Sun Ray server. When using a failover group, the primary Sun Ray server should be specified.

lossless=[0 | 1]

When set to 1, does not permit lossy compression to be used.


Sets the network MTU. The value used is the minimum of those supplied from various sources.


Sets how much time a Sun Ray 3 Series Client will be idle before it turns off. The default power off time is 30 minutes. Setting poweroff=0 disables the power off feature. When the power off feature is enabled, the firmware enforces a minimum power off value of 10 minutes and a maximum power off value of 30 days. The value for the power off feature is in minutes.

For example, poweroff=15 sets the idle power off timer to 15 minutes.


Permissible values are inorder or random. Selects a server from the server list either starting at the beginning or at random, respectively.


Specifies a comma-separated mixture of host names or IP addresses indicating the available session servers.

stopkeys=[keyn[-keyn]* | none]

Specifies an alternative combination of modifier keys to perform the same function as the Stop key on the Sun keyboard or the Ctrl-Pause key sequence. By default, this alternative combination is Ctrl-Shift-Alt-Meta. See Section 13.2, “Sun Ray Client Hot Keys” for details.

The value of keyn can be any combination of the Ctrl-Shift-Alt-Meta keys, but at least two of the keys must be used. For example, you can set this value to Ctrl-Alt or Meta-Ctrl-Shift.

If this parameter is set to none, the alternative key combination is disabled.

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

stopqon=[0 | 1]

When set to 1, enables the Stop-Q key sequence to be used to disconnect a Sun Ray Client from a server, in particular, if it's using a VPN connection.

utloadoff=[0 | 1]

When set to 1, disables the ability to use the utload program to force a Sun Ray Client to load firmware.

videoindisable=[0 | 1]

When set to 1, disables the input source on the front of a Sun Ray 270 Client, and it locks the monitor into displaying only the client output.