Applying a PayGlobal Patch
This article outlines the process for upgrading or applying a patch release.
Even though this article was originally created for the update from version 4.64.0.0 to 4.64.0.1, these instructions apply to all future patches and updates.
Upgrade steps:
IMPORTANT for Step 1:
The steps provided below are for deployments where LIVE and TEST run on different servers/environments. Do not install a patch directly on the server if you are running LIVE and TEST on the same server.
Installing the patch removes the major release and leaves you with ONLY the patch installed. If you run both LIVE and TEST on the same server, you will need to complete step 1 elsewhere, e.g. local computer/laptop, and copy it to the server. This will allow test and live to operate as required using different minor versions until you are ready to update the live database.
IMPORTANT for Step 3:
Relating to note above, if you are not updating LIVE and your HR.ini contains both LIVE and TEST company data sections - Please ensure you don’t change the LIVE Run_Version in HR.ini. I.e. don’t replace all instances of “4.64.0.0” to “4.64.0.1”. Manually make the changes to HR.ini.
Unzip the file and run the InstallPayGlobal v4.64.0.1.msi installer. Ensure you install this into a new folder using the version/release/patch number for the folder name (see screenshot below).
To find the current version folder, go to Help > About > Details in PayGlobal.
To make sure this has been done correctly, check you can see the new version folder.
Copy the required system files from the prior version folder to the new 4.64.0.1 folder:
RPM_HR.ini
PayGlobal.Business.NET.dll.config
The Rept folder
See important note above. Go back to the PayGlobal Login folder, and edit the HR.ini file in Notepad or a similar text editor.
Replace all instances of the old version number (e.g. "4.64.0.0") with the new version number, "4.64.0.1". In Notepad, press Ctrl + H to find and replace.
Save the file once this is done.
Check the update was successful:
Log in to PayGlobal.
Go to Help > About to confirm the version is correct.
Under Reports, run Update Reports Definitions Table, and check you can run a report.
Common problems
Problem: Process pay stuck on waiting. Or reports are not running (hanging).
Solution: This could be happening because the RPM_HR.ini file has not been copied across during the upgrade process (step 2 above).
Problem: "Error in procedure AddReportTask. Error is Could not parse report file” error occurs when printing reports.
Solution: This can occur the Rept folder was not copied (step 2 above) or if Update Reports Definitions Table was not run (step 4).