Cashiering Hardware Console Self Update

Owned by Knowledge Assistant
Last updated: May 19, 2023
3 min read



Description of Issue

After the initial 2020.1 or higher Hardware Console installation, the Hardware Console will be able to detect when a newer version is available and allow the user to update it by clicking the Cashiering Hardware Console icon in the taskbar



Context

  • Cashiering

  • Hardware Console

  • 2020.2+

  • 2021.6+

  • 2021.1.11+



Cause

The Hardware Console self-updater feature helps users stay current with the latest hardware console updates. This functionality was introduced in 2020.2. 



Resolution

  1. The initial Cashiering 2020.2 installation requires that the user doing the installation enter the URL to the Cashiering web app (ui.web)

  2. When the Hardware Console launches, it does an update check immediately after initializing the hardware devices. It will recheck every 24 hours of Hardware Console running time.

  3. If an update is available, the user is prompted with a Windows notification, which includes the new version number. The user can also check for update availability by right clicking the Hardware Console taskbar icon.

  4. If the user clicks the notification or the Update Available taskbar context menu option, the Updater app will launch.

    1. Note: This update process does not require administrator privileges to be run

  5. The Updater app displays the currently installed version, the available version, and an Update button.

  6. If the user clicks Update, the update process will begin.

  7. The Updater will copy itself to a temporary location and relaunch with administrator access. If the user running the Hardware Console is not an administrator, the Updater app will prompt for administrator credentials using a UAC dialog.

  8. The Updater will download the latest update zip file, which is located in the web app under the HardwareConsole sub-folder.

  9. The installer (msi) will be extracted to a temporary folder.

  10. The current Hardware Console will be closed.

  11. The installer will be launched in non-interactive mode, retaining existing settings.

  12. Once the installer finishes, the Updater will exit, and the Hardware Console will relaunch.


IMPORTANT: If you are applying an update of Cashiering 2020.2 or higher, and you already have the Hardware Console deployed on client workstations, then you must first uninstall the current Hardware Console from those workstations, and then reinstalled using the instructions below. Once reinstalled at a version of TC 2020.2 or higher, the automated update features will be available.

Ex:

  • Updating from 2021.5 to 2021.9.0

    • Hardware Console will need to be uninstalled and reinstalled

  • Updating from 2021.6 to 2021.9

    • Hardware Console auto update can be used



Additional Information

2021.6.0.0/2021.1.11.0 Changes

Below is a summary of the installer changes for the 2021.6.0.0/2021.1.11.0 and higher releases

  1. Changed the installer name listed under Apps & Features to Cashiering Hardware Console (Web)

    1. The original name is Tyler Cashiering Hardware Console

  2. The shortcut and system tray hover text displays Cashiering Hardware Console (Web)

    1. The shortcut and system tray hover text for 2019.1/2019.3 is Tyler Cashiering Hardware Console

  3. Installing the files by default to C:\Program Files (x86)\Tyler Technologies\Cashiering (Web)

    1. The original install location was C:\Program Files (x86)\Tyler Technologies\Tyler Cashiering

    2. The other installers (2019.1/2019.3) will continue to install the files to C:\Program Files (x86)\Tyler Technologies\Tyler Cashiering

  4. Changed the port that is used to 48099

    1. Previously the port 48098 was used

    2. The other installers (2019.1/2019.3) will continue to use 48098

  5. Will uninstall the original Hardware Console software for 2020.1 and higher releases

    1. Will only support side-by-side installations for 2019.1 and 2019.3 that use the WPF program

  6. When using the Hardware Console, only one version at a time should be started and used with a particular Cashiering version

    1. When a different version is being tested, only that version's Hardware Console should be started and used

    2. Fully exit the Hardware Console from the browser and system tray before starting the Hardware Console for a different version

    3. Note: The Hardware Console may automatically start when the workstation is turned on. Check the system tray and exit the Hardware Console for the version not in use.


https://help.tylertech.com/TylerCashiering/HelpCentral_WV/TC/Content/Programs/CSHG_HardwareConsole.htm