Background
The Update Manager in the Xbase++ Workbench usually provides a seamless update experience; after clicking "Download and Install", the update process usually runs through without further user interaction. However like all processes, it can fail. This article provides some background information and procedures for dealing with errors occuring while applying an update.
Update Cache
Updates are delivered in the form of Microsoft Installer (.msi) files which are downloaded to your computer. The system stores these files in a location called the update cache and it is located in the following folder:The update archives in the update cache follow the following naming convention: <product-level>.<version>.<language>.<date>.msi. For example:
xpp-prof.20-00-1449.en.20210614.msi.Log Files
A log file is written each time an update is applied to an Xbase++ installation. These logs are stored in the update cache, and follow the same naming convention as the update archives. For example:xpp-prof.20-00-1449.en.20210614.log. In cases where an error prevents a system from being updated, the log file may provide clues as to what went wrong.Dealing with "missing installation package" errors
Applying an update involves two steps to be performed by the update process:- Removing old files
- Installing new files
In such cases, you can use the following procedure for pointing the installer to the missing file:
- Ensure the required file is located in your update cache directory (Example:
c:\users\..your user..\appdata\roaming\alaska-software\xpp20\update-cache\xpp-prof.20-00-1314.20210503.en.msi). If the archive is missing, it must be downloaded again from the Alaska update server. Please contact Tech Support for further details on how to do this. - Use Windows Explorer to copy the update archive from the update cache to your Windows desktop
- Rename the update archive and remove the date from the file name (Example:
xpp-prof.20-00-1314.en.msi) - Click "Browse..." in the missing file dialog and point the system to the renamed update archive on your desktop
- Click "Ok" to continue
Dealing with missing or corrupt files in your installation
If runtime or other files become corrupt or are deleted after or during an update process, doing a repair install may fix the issue. To do this, open the "Apps and Features" applet in your system settings, pick "Alaska Software Xbase++ 2.0" from the list of installed packages and select "Modify". In this installer dialog that is opened, select the "Repair" option for initiating a repair process. If this doesn't help, Xbase++ must be reinstalled manually. See the following sections for details.
Uninstalling an Xbase++ build
In some cases, a problem cannot be resolved in a way allowing the automatic update process to run through successfully. In such cases, Xbase++ must be uninstalled and then reinstalled from scratch. To uninstall your current Xbase++ build, open the "Apps and Features" applet in your system settings, pick "Alaska Software Xbase++ 2.0" from the list of installed packages and select "Uninstall".Restarting an update or reinstalling an Xbase++ build
Sometimes an update must be restarted. For example, if Xbase++ needs to be reinstalled. Restarting an installation can be done in two ways: if a problem was corrected in the current Xbase++ build and the Workbench still runs, simply open the Update Manager and select the desired build in the update list. Select "Download and Install" to proceed.If Xbase++ had been uninstalled or if the Workbench no longer comes up, a reinstall must be performed. To do this, locate the update archive with the desired build in your update cache, and double-click the file in Windows Explorer (Example:
c:\users\..your user..\appdata\roaming\alaska-software\xpp20\update-cache\xpp-prof.20-00-1440.20210623.en.msi). Follow the instructions for initiating a normal install process.
