T-Plan Robot Enterprise 4.2.1 Update & Upgrade
- Update & Upgrade Window
- Auto Updater
1. Update & Upgrade Window
The Update & Upgrade window
T-Plan Robot Enterprise
download new software versions and/or upgrade the current
open the window select Tools
-> Update & Upgrade in the main GUI menu.
Whenever the window is opened, it contacts the T-Plan release server
receive so called release descriptor with information on all public
releases of T-Plan Robot Enterprise. If there's no internet connection, the
displays a warning message and exits.
The release data is displayed in form of a tree where releases are
grouped by the version (such as for example 2.3, 2.3.1 etc). The
is by default filtered to
display just those releases that are compatible with your current
operating system. This behavior can be changed in the window preferences
(see (3) below) to enable download of software for other platforms.
- Release tree shows
available releases. The currently installed release is displayed
green and marked as "current".
If the window identifies a new suitable
update release, it displays it in magenta and marks it as "recommended".
descripion shows a short description of the selected
button opens the Update &
preferences in the Preferences
There are several parameters which control behavior of this
the Auto Updater feature.
Save button downloads the selected release and saves it
the local file system. This is designed to support users who
create an additional installation from a standalone ZIP release
apply the update manually (for example those who create
company builds or pick up just the Java libraries). This feature
also enables to download releases which can not be used
direct update, such as for example releases with Windows
or releases in Mac OS X application format (.dmg). For
manual installation or update see the Release
Install button downloads the selected release and
update or reinstall of the current Robot
installation. No changes are made to the software at this point
update is applied only after the window is closed with OK and
application gets restarted. The update
process is described in details later on
Install button is enabled only if the selected release
identified as a patch one
(typically a standalone release in ZIP format), it is compatible with the local OS
application has sufficient
permissions to the current installation path. If the
button is disabled for a particular release, it can be still
through the Download &
button and installed manually.
button saves the scheduled update and prepares the update
no update has been set up through Download
Install, the button is disabled.
closes the window and cancels the update (if scheduled).
opens this help topic.
An update process initiated through the Download & Install button
through three stages:
- Download of the
package from the T-Plan release server to the local file system.
The download progress is indicated by a simple window as is
Each downloaded binary is checked for integrity through an CRC32
sum. If the file is corrupted, the window displays an error and
As downloads are by default stored to an OS-specific
temporary location, they get deleted after system restart. To
feature save all binaries to a permanent location set up the Download Directory parameter
in the Update & Upgrade
- An update task is created and configured. It
standalone thread (routine) which registers with the Java
Machine (JVM) to get called as part of the Java shut down
successful set up of the update task gets reflected in the GUI.
release tree of the Update
Upgrade window displays the corresponding release in
marks it as "ready to
The OK button gets
the Download & Install button
To save the planned update leave the window with OK.
- As the update
is called on Java exit, the actual update
files is not carried on until the application is
properly finished through the Exit
item or through the OS provided Close button in the window
update can be actually cancelled or
changed through the Update
Upgrade window until the application gets finished. Do
the Robot application through the system means such as the Task Manager on Windows or xkill on
Unix/Linux because it will cancel the update task.
The update is performed in several steps:
- A back
up directory is created in the OS specified
- The update task processes contents of the
and updates the specified Robot installation. A back up copy
file is created before it gets updated. If the update
with an error, it restores the original installation from
the back up
- A log
details is displayed in web browser.
If the update
, check the log for errors which are typically in
form of a
Java exception stack trace. Most update problems are caused by
insufficient file permissions. If the update stopped on a
file, check its permissions and make sure that the update process
the right to read and write to the file. If you experience any
errors, contact the T-Plan
If the update log does not open
in web browser, it is likely that Robot's web browser settings are
configured properly. The log file is named like
and it is located in the OS
temporary folder (usually
on Unix/Linux). To get the temporary path eventually start Robot's
the System Information
look for value of the java.io.tmpdir
If you need to restore any of
original application files
, for example if you have
the start scripts, you may retrieve them from the back up
which is listed at the beginning of the update log. Be aware that
back up location is likely to get deleted after OS restart.
2. Auto Updater
Auto Updater checks the
release list for updates at configured time intervals. This process
runs only when the Robot is started in GUI mode with no automation
being executed. If there's a new update release available, tit
an informational message notifying the user of the release.
The default time interval is set to 2 weeks. It can be configured in
the Update & Upgrade
in the Preferences window. To
the feature set the time period to "Never".