RShell Reference Manual
Revision 4.2, Copyright © 2009, Impinj, Inc.
Proprietary and Confidential
9
4.2.2.1 Config Image Default Command
The
config image default
command restores the configuration to the default settings. When
complete the command is automatically followed by a reboot. The custom application (if any) is
notified after the reboot, so that configuration specific to the custom application (if any) can also
be restored to the defaults. This command takes no parameters.
During restoration to the configuration defaults, the
show image summary
command reports the
UpgradeStatus
as 'WaitingForCDR'. When this command is executed the metafile retrieve-mode
is set to manual, canceling any previously scheduled periodic upgrade. When the reader
subsequently boots, it will be running the same System version as the one from which it
performed the configuration default restore, with the default configuration.
If the reader is in auto upgrade mode when the
config image default
command is issued, it is
possible that the reader is currently retrieving the metafile or performing an upgrade. In these
instances, this command may return "Previous-Command-In-Progress." In this case waiting for
the metafile to be retrieved or the upgrade to complete before executing this command again will
allow the command in progress to complete.
Usage: config image default
4.2.2.2 Config Image Fallback Command
The
config image fallback
command is used to revert back to the previous image. The successful
processing of this command is followed by an automatic reboot. This command takes no
parameters.
If there is no valid previous image available to fall back to, the command response will be
“Permission-Denied’. In the mean time, the reader operates normally except that all the
config
image
commands will be rejected with the reason “Current Image Invalidated.” Also if the
retrieve-mode is set to auto, the fallback command will cancel any previously scheduled periodic
upgrades. When the reader is rebooted, the previous image will be running.
If the reader is in auto mode during execution of this command, it is possible that the reader may
be currently retrieving the metafile or performing an upgrade. In these instances, this command
may return “Previous-Command-In-Progress.”
A fallback will utilize all the old configuration settings, including the upgrade metafile settings
as if the upgrade to the newer image was never performed—this may trigger an immediate
upgrade. If the URI of the old metafile is known and an immediate upgrade is not desired, the
user should remove or rename the old metafile before performing a fallback.
4.2.2.3 Config Image Metafile Command
This command takes the Universal Resource Identifier (URI) of the upgrade configuration
metafile as its parameter. It commands the reader to perform upgrades based on the information
in the metafile identified by the URI.
Usage: config image metafile <URI>
Upon receiving this command, the reader updates its local upgrade configuration URI. It then
retrieves the (new) upgrade configuration metafile, and performs the upgrade in accordance with
Содержание RShell
Страница 49: ...RShell Reference Manual...