Introduction
Anyone can upgrade Handyman Office either manually or automatically through automatic updates. However, we recommend seeking assistance from an IT partner or GSGroup if you have multiple servers, such as Application Server, Terminal Server, DMZ, etc. The upgrade process is initiated from the server where the main installation of Handyman Office is located.
When a new version is released, we provide a limited period for manual upgrades before making the version available for automatic updates.
This article provides instructions on how to manually and automatically upgrade Handyman Office.
Environment
Application Server, Terminal Server
Step by Step
Getting Ready
Prior to starting a Handyman Office upgrade, it is crucial to become acquainted with the following:
- During the upgrade, users will not be able to use Handyman Office, but mobile users can continue working normally, although they won't be able to synchronize their devices until the upgrade is completed.
- All integrations with Handyman need to be manually stopped.
- Customers with special customizations should check with GSGroup and any relevant third party if additional work is needed for the customizations to work after the upgrade.
- Handyman services (Synchronization Server, FileImport, JobAgent) will be automatically stopped during the upgrade and must be manually restarted from the ControlCenter once the upgrade is complete.
- Terminal servers need to be put into installation mode: https://support.microsoft.com/nb-no/help/252330/when-you-toggle-terminal-services-to-application-server-mode-some-prog
- All users who have locally installed Handyman Office on their PC (not via Terminal Server / Citrix, etc.) need to upgrade their version, which will be done automatically when they log on to Handyman.
- If you have SQL Server Express or Foundation Edition, be aware of their limitations. After upgrading from version 795 sp2 or older to Handyman version 8 and later, the database will grow approximately 20%. SQL Server Express has a limit of 10 GB, so if the Handyman database exceeds this limit after the upgrade, Handyman Office won't function properly. If this is a concern, please contact Support for assistance.
How to Manually Upgrade Handyman Office
- Contact Support to obtain the setup file.
- Download the setup file to your PC or Application Server.
- Right-click on the setup file and choose "Run as Administrator".
- Follow the instructions by clicking "Next".
- The final step is to upgrade the database. A list of all upgraded clients will be shown. This step may take some time, depending on the hardware and size of the database(s). This upgrade process only occurs when the main installation is upgraded. When other Terminal Server or local users upgrade their installations, the database will already be upgraded.
-
- Once all tasks are finished, you will receive a message indicating that the installation is complete.
- It is recommended to restart the server after the installation process.
Upgrade Handyman Office Automatically
- Open Handyman Office and click on the information icon.
- Click on the "Check for new version" link.
- Follow the presented procedure to complete the upgrade.
If you don't know where the Handyman installation is located, follow these steps:
- Right-click on the Handyman Office icon on your desktop and choose "Open File Location".
- In most cases, the location is C:\GSGroup\Handyman\Office, but it might be different for you.
- Go up one level in the folder hierarchy to C:\GSGroup\Handyman\.
- Delete the existing ehmUpdateService.exe file and replace it with the file you downloaded.
