Introduction
Anyone can upgrade Handyman Office; either manually or automatically via automatic update. Although we recommend an IT partner or GSGroup to plan and carry out the upgrade if you have multiple servers such as Application Server, Terminal Server, DMZ etc. The upgrade is done from the server where the main installation of Handyman Office is located.
When we launch a new version, we will always open up for manual upgrade for a limited period before the version becomes available on automatic update.
This article contains instructions on how to upgrade Handyman Office manually and automatically.
Environment
Application Server, Terminal Server
Step by Step
Preparation
Before embarking on an upgrade of Handyman Office, it is important to familiarize yourself with the following:
- No users can use Handyman Office while the upgrade is in progress. Mobile users can of course continue to work as normal, but will not be able to sync their devices until the upgrade is complete
- All integrations with Handyman should be stopped manually.
- Customers with special customization's must clarify with GSGroup and any relevant third party whether any of the customization's require additional work to function after an upgrade.
- Handyman services (Synchronization Server, FileImport, JobAgent) will be automatically stopped during the upgrade and must be restarted manually from the ControlCenter when upgrade is complete.
- Terminal servers must 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 installed Handyman Office locally on their PC (not via Terminal Server / Citrix etc.) must upgrade their version, this is done automatically when the user logs on to Handyman.
- If you have SQL Server Express or Foundation Edition, you must be aware of the limitations these versions have. You must expect that the database will grow approximately 20% after upgrading from version 795 sp2 or older to Handyman version 8 and later. SQL Server Express has a 10GB limitation, and if the Handyman database should become larger than this after the upgrade, Handyman Office will not work properly. If this is a concern, please contact Support and we will assist you with this issue.
Manual Upgrade of Handyman Office
- Contact Support to get hold of the setup-file
- Download the setup file to your PC or Application Server
- Right-click on the setup file and select Run as Administrator.
- Follow the steps by clicking Next
- The last step in the process is upgrading the database itself. All clients that are upgraded will be listed here. This part of the upgrade will take some time, depending on the hardware and size of the database(s). This step will only occur when the main installation is upgraded. When other Terminal Server or local users upgrade their installations, the database will already be upgraded.
-
- When everything is done you will see a message about Installation complete.
- We recommend a server restart after installation.
Automatic Upgrade of Handyman Office
- Click on the information-icon in Handyman Office
- Click on the link "Check for new version"
- Follow the procedure that is presented to you to carry out the upgrade
If you have a version that is between 8.0.0 and 8.0.3.10992, you must manually download a new version of Handyman UpdateService before you can follow the usual upgrade procedure. This is added to the Handyman folder and replaces the existing file named ehmUpdateService.exe. You can download ehmUpdateService.exe here: exe or zip.
If you are unsure where the Handyman installation is located:
- Right-click on the Handyman Office icon on your desktop and select Open File Location
- In most cases you will C:\GSGroup \Handyman\Office, but this may vary.
- Navigate up a folder to C:\GSGroup\Handyman\
- Delete the existing ehmUpdateService.exe file and upload the file you downloaded
