NAME
utfwadm - Sun Ray firmware version management
SYNOPSIS
/opt/SUNWut/sbin/utfwadm { -A | -D } { -a | -s enetSuf-
fix | -e enetAddr } -n interf [ -n interf ] ... [ -f
firmware ]
/opt/SUNWut/sbin/utfwadm -P
/opt/SUNWut/sbin/utfwadm -R
DESCRIPTION
The utfwadm command manages firmware upgrades to Sun Ray
appliances. The appliances are capable of loading firmware
upgrades and programming new firmware into their flash PROM
memory.
The firmware file contains a version string which can be
extracted from the file using the what(1) command. When an
appliance is powered on, the firmware obtains an IP address
and other configuration information using the DHCP protocol.
Part of the configuration information is a DHCP variable,
NewTVer. If this variable is defined, the firmware compares
it with its own version string. If it is not the same, the
firmware initiates an upgrade which replaces the current
firmware with the new version.
The utfwadm command must be run when a new firmware version
is installed to set the NewTVer variable and force the
appliances to load the new version on their next power
cycle. The DHCP facility allows variables such as NewTVer to
be set on either a per-network or per-unit basis in the
dhcptab(4) file, and utfwadm allows firmware upgrades to be
targeted either to entire Sun Ray subnetworks or individual
appliances. The Sun Ray subnetworks must have been previ-
ously set up using the utadm(1M) command. The command must
be run with super-user privileges.
OPTIONS
The following options are supported
-a This causes the given operation to be applied to all
units attached to the given interfaces.
-A Add the defined appliances to the list of units to be
upgraded with a new firmware version. The following
options determine which subset of the units should be
upgraded. This option sets the NewTVer variable in the
appropriate context. It also copies files from the
firmware install directory into the boot directory,
renaming them to contain their version strings.
-D Remove the defined appliances from the list of units
to be upgraded. This option causes the NewTVer vari-
able to be unset.
-e enetAddr
This causes the operation to be applied to only the
specified unit with Ethernet address given by ene-
tAddr, where all six hex bytes of the address are
specified.
-f firmware
This option gives the pathname for the firmware to be
downloaded to the appliances. If firmware refers to a
file, the hardware version is extracted from the ver-
sion string within the file, and the file is copied to
the /tftpboot directory to be downloaded only to that
version of the hardware. If firmware refers to a
directory, then all files named ``Corona*'' in the
directory are copied to the /tftpboot directory with
their version strings appended. If the -f option is
not given, a default location is used.
-n interface
Apply the given operation to units connected to the
Ethernet interface interface. Multiple interfaces may
be given, or the special keyword all, which applies
the operation to all configured Sun Ray interfaces.
-P This variant of the command prints out the version to
which each domain should be upgraded on the next power
cycle. A domain may be either an interconnect subnet
or individual appliance. If it is a subnet, then the
Intf column lists the interface device. If it is an
individual appliance, then its Ethernet address is
given in the Domain column, and the Intf column con-
tains the interface name.
-R Remove the firmware files that were copied into the
boot directory.
-s enetSuffix
This causes the operation to be applied to only the
specified unit, where enetSuffix is given as the last
three hex bytes of the Ethernet address. The hex pre-
fix "0x080020" is added to the address.
The -z option is RESERVED for use by the Sun Ray Server
Software and should not be used.
FILES
These are the files used by this command:
/var/dhcp/dhcptab
file or NIS+ table
/tftpboot
default location of firmware boot files
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWuto |
|_____________________________|_____________________________|
SEE ALSO
dhtadm(1M), dhcpconfig(1M), what(1), dhcp(4),
dhcp_network(4), dhcptab(4), attributes(5), utadm(1M)
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |