SOFTWARE DISTRIBUTION (ESD)

May 19, 2018

3.2.1 Overview

ESD Client for Release 2 supports features to enhance the ability to transact and download, adjust the percentage of
bandwidth used to download and support for Forced Fallback to a previous version of software.
The new features introduced in ESD Release 2, 2009 are:

  1. Download Only
  2. Bandwidth Control
  3. Transact and download
  4. Filter Package Download
  5. Download Status Reporting
  6. Western Union forced fallback
  7. Agent Initiated Fallback
  8. Miscellaneous Items

3.2.2 Functionality

3.2.2.1 Download Only

If the terminal ID entered in ESD login screen is different than the one configured for Translink, ESD will give the user the
option to only download the package without automatically installing it.
When choosing to download only, the system will allow the user to save the download to a customized location. However,
the configured location can always be used if preferred.
Once the download is finished, ESD will save it to the chosen location, in a folder named with the package name and the
terminal ID (“packagename_termID”), so that all the downloads can be uniquely identified and stored as a historical.
See Appendix F for detailed flow.

NOTE: The download-only functionality will always be triggered when Translink is not present on the PC, since Translink

Terminal ID will not be configured. This functionality will never be shown when Translink triggers ESD automatically.

3.2.2.2 Bandwidth Control

ESD application uses all available bandwidth by default to download the software. However, if the user doesn‟t want ESD to use all bandwidth to be able to share it with other applications and not affect the bandwidth performance, there is a configuration option to use only a certain percentage of the available bandwidth. With this option, ESD will download at the necessary speed so that only a percentage of the bandwidth will be used by ESD.
If the user wants to submit transactions while downloading a software update, this option is ideal to minimize the impact on
transaction performance while downloading.

3.2.2.3 Transact and download

To be able to transact and download without issues, Translink installation is now delayed if ESD detects that Translink is
running when the download is completed. ESD will inform the user that updates are ready to install, but the installation will
not start until Translink is properly closed. Installation will start automatically one minute after Translink has been closed.
ESD will keep reminding the user, every hour, that updates are ready to install if Translink is still running.
See appendix F for detailed flow.

3.2.2.4 Filter Package Download

When a Translink package is downloaded using an ESD client prior to Rel 2, 2009, many files which may already be present
on the agent‟s PC are also downloaded (e.g. Windows system components – dll & ocx). This adds to the setup package size
thereby increasing the time taken to download the package.
A new functionality is incorporated in the ESD Client, where only necessary Windows files are downloaded. This
functionality decreases the size of the setup up to a 25% resulting in decreased download time as well. This feature could be disabled for agents who require full download.

3.2.2.5 Download Status Reporting

ESD Excel Add-in 3.2 has features to report on download status.
When querying the information for a terminal ID, the latest status reported by the ESD Client will be shown if the user using that terminal ID is using ESD Client version 3.0.0.0. New columns “Status”, “Status Date” and Status Time” were added to display this information.
The possible statuses are:

 Download Set: This is the status that will be shown when a package has been set for that terminal ID using the
Excel Add-in or the management suite

  • Download Started: Once the ESD Client 3.0.0.0 starts a download, the status will be set to “Download started” and the date and time will be updated.
  • Download Cancelled: This status will be shown when the download is interrupted
  • Download Completed: When the download completes, but the installation hasn‟t been triggered, this is the status that will be shown
  • Download Invoked: When ESD 3.0.0.0 finishes downloading and triggers Translink installation, this status will be reported
  • Download Attempt – No package set: This status will be shown when the terminal ID tried to do a download but there was no package setup for that terminal.

Former Active/Inactive buttons and columns were removed.

The tool bar in Excel Add-in 3.2 will be displayed as follows:

ESD Excel Add-in tool bar

Figure 31 ESD Excel Add-in tool bar

3.2.2.6 Western Union forced fallback

This feature allows WU to force an agent to fallback to a previous version of Translink. When a terminal ID is set for a
forced fallback, Translink does not allow transactions until the fallback process is finished successfully. However, if the
system cannot fallback automatically, it will not lock the user.
Translink will initiate fallback process automatically after receiving the instruction to fall back from the Host. If the user is idle in the sign-on screen, Translink will force exit after a configured amount of idle time in sign-on screen is met, and
initiate the fallback process.
The system will first attempt to fallback locally to the previous version that the user had and use the previous configuration.
If this local process fails, then ESD will be triggered to start a new download and re-install the previous version.

3.2.2.7 Agent Initiated Fallback

This feature will allow the agent to return to a previous version of Translink when major issues are experienced after an
upgrade.
The software for rollback will try to perform a local fallback to return the user to the exact previous state. However, if this
fails, ESD Client will be invoked to perform a new download and installation.
A password will be prompted by the application to allow the user to invoke a Translink fallback. This password has to be
provided from Western Union to the agent, and it is a fixed password, as in ESD Configuration application.
See Appendix F for detailed flow.

3.2.3 Setup Consideration

3.2.3.1 Local Configuration

3.2.3.1.1 Bandwidth Selection

In the new “Advanced” tab in the ESD configuration application (former “Telephony” tab), an option was added to allow the user select the amount of bandwidth ESD will use for download.

ESD Configuration Utility

Figure 32 ESD Configuration Utility

The user can choose not to limit the bandwidth usage (default option) or instruct ESD to only use a percentage of the
available bandwidth. The percentage range that can be used is between 5%-95%.
Only digits will be allowed to be entered for a maximum of 2 digits.

3.2.3.1.2 Selective Download

Another configuration option, „Filter Download Package‟ is used to enable/disable the functionality to not download certain files if they are already present on agent‟s PC.

3.2.3.1.3 Excel Add-in tool

In the ESD Excel Add-in tool, the configuration screen does not show the Active/Inactive columns, instead new columns for “Status”, “Status Date” and “Status Time” were added, as shown in the following figure:

ESD Importing tool configuration options

Figure 33 ESD Importing tool configuration options

3.2.3.2 Host setup / Configuration

To initiate a forced fallback, ETCH flag has to be set to “F”. Also, the idle timer shall be setup so that Translink can exit after this time is met in idle state on the sign-on screen to initiate the process.

3.2.3.3 Package setup/Configuration

ESD packages optionally carry a file named WUESDLAUNCH.ini to indicate special installation requirements. When ESD is instructed to invoke the installer after the download is completed, if the wuesdlaunch.ini file is present, it will invoke the installer according to the instructions given in this file.
Following are the different possibilities to configure the wuesdlaunch.ini file according to the capabilities of the Translink installer:

  • For ESD to run the installer non-silent, the wuesdlaunch.ini shall say “Setup.exe”
  • For ESD to run a Translink upgrade in silent mode, the wuesdlaunch.ini file shall say “Setup.exe -s”
  • To run a full installer in silent mode, is should say “Setup.exe -s -overwrite”. This setting will leave the user with a fresh install of Translink overwriting whatever version and configuration pre-existent in the PC.
  • If, in any of the cases, the users wants Translink application to be launched after the installation, added to the instructions above, it shall say “–RUNTL”.

Note: If the wuesdlaunch.ini file is not present, ESD will attempt to run the instruction “Setup.exe”. If there is no “setup.exe” in the package downloaded, then ESD will display an error message.

See Appendix F for examples of WUESDLAUNCH.ini file.

3.2.4 Backwards Compatibility

ESD Client 3.0.0.0 works with any previous Translink version. However, since “Forced fallback” functionality is a feature
that needs Translink Release 2, 2009 or above, the following table shows the behavior when used with older Translink
versions.

Forced fallback scenarios
If ETCH fla g is set to F in the following scenarios:
Old TL New TL No TL
No ESD Old TL does not react to ETCH in F If fallback utility exists, TL will trigger fallback utility. If fallback utility is not present either, TL will show an error message, reset the flags and continue working.

Agent will continue with incorrect TL version

NA
Old ESD Old TL does not react to ETCH in F TL will trigger ESD to perform the fallback process (downloads). NA
New ESD Old TL does not react to ETCH in F. However, if fallback is initiated manually, it will start the fallback process. If fallback fails, it will initiate ESD. TL will trigger the fallback utility to perform the fallback. If fallback fails, it will initiate ESD. ETCH will have no effect. However, if fallback is initiated manually, user will receive the error message saying “TL was not found, Fallback will close”.