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
list of Sun Ray servers that can be used to obtain a Sun Ray
session.
Since there are many .parms files to create (one for each Sun Ray
model type), administrators should use the
utfwadm command to build the
.parms
files automatically. The
utfwadm command can include a template
.parms
file that contains key/value pairs.
This file 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.
The utfwadm command assumes that the
/tftpboot
directory exists. If this
directory does not exist, you must create it.
# 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 servers=server1,server2,server3 select=random
At a minimum, you must specify the
servers=
key. This instructs the Sun Ray
Clients which Sun Ray servers to use for a user session.
This key accepts a comma-separated list of either hostnames
or IP addresses. By default, the Sun Ray Clients will try to
connect to these servers in order. Use the
select=
key to instruct the Sun Ray
Clients to try the servers in a random order. It is not
necessary to have all of the Sun Ray servers listed here,
but there should be enough servers to be relatively safe
during a partial outage.
Use the utfwadm command to generate 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
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 10.2, “.parms Key/Value Pairs” lists the key/value pairs.
Table 10.2. .parms Key/Value Pairs
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 11, 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. Here are the valid keyboard country code values:
|
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= | Retrieves 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. |
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 10.1, “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. |