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.
Become superuser on the Sun Ray server.
Create the /tftpboot
directory on the Sun Ray server if it
does not exist already.
# mkdir /tftpboot
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.
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
format, with case sensitivity and no spaces allowed. Options
that take values of key
=value
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)
Key | Description |
---|---|
bandwidth= | Sets the maximum bandwidth limit used by the Sun Ray Client, in bits per second. |
cmdcashsize= | 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 |
disablegui=[force | none |
| 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. |
kbcountry= | 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. |
Log | Sets the logging level for various classes of logging events, where
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 Log |
LogHost= | The Sun Ray server where logging output is saved when one or more
Log |
lossless=[0 | 1] | When set to 1, does not permit lossy compression to be used. |
MTU= | Sets the network MTU. The value used is the minimum of those supplied from various sources. |
poweroff= |
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
For example, |
select= |
Permissible values are |
servers= | Specifies a comma-separated mixture of host names or IP addresses indicating the available session servers. |
stopkeys=[ | 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
If this parameter is set to 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. |