Breadcrumbs

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.

Link to latest infrastructure requirements here.
PayGlobal application downloads are available here.

Upgrade steps:

IMPORTANT NOTES:

  1. Installing the patch removes the major release and all the configuration files. Make sure you backup the following before installing.

    • RPM_HR.ini

    • PayGlobal.Business.NET.dll.config

    • The Rept folder

  2. 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. See important point 1 above, 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.

  3. Relating to note 2 above; if you are not updating LIVE and your HR.ini contains both LIVE and TEST company data sections - ensure you only change TEST and not 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.


  1. 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).

    1. To find the current version folder, go to Help > About > Details in PayGlobal.

    2. To make sure this has been done correctly, check you can see the new version folder.

      PayGlobalInstallFolder.png


  2. Copy the required system files from the prior version folder or from the backup you made (important point 1), to the new 4.64.0.1 folder:

    • RPM_HR.ini

    • PayGlobal.Business.NET.dll.config

    • The Rept folder

  3. 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.

    PayGlobalInstallNotepad.png


  4. 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).