How to upgrade Merge1

Article: 100058486
Last Published: 2025-03-31
Ratings: 43 0
Product(s): Merge1

Description

Before moving forward, perform the following steps: 

  • Take a backup of the Merge1 database
  • Take a Snapshot of the Merge1 VM
  • Export the PDF from the Licensing section

This will allow for a recovery in case there are issues during the upgrade. 

Note: The Merge1 7.0 Agent requires the following to be installed. 

• .NET 8.0 Runtime  ( Link )
• ASP.NET Core 8.0 Runtime (Link )

Upgrade from a previous version of Merge1 v7

  1. Make sure that all connectors are in an idle state.

  2. Turn off the schedulers.

  3. Stop the Agent service from the Services.

  4. Un-register the old Merge1 agent. (Link)

  5. If Merge1 Agent service fails to be deleted, perform manual deletion:

    1. Delete the Merge1 Agent service by running SC Delete <agent service name> in CMD prompt.

  6. Uninstall the Merge1 Agent application
  7. Install the new Merge1 version on top of the previous one.

  8. Connect to the same DB and upgrade the schema(important!).

  9. Open Merge1 and verify the version from Licensing.

  10. Install the Merge1 Agent application

  11. Register the new Merge1 agent. (Link)

  12. Turn on the Agent service from the Services.

  13. From the Agent Pools section, verify the Merge1 Agent version.

  14. Turn on the schedulers

 

Important Notes

You must install the new version of the Agent. The Merge1 application version and the version of the Merge1 Agent must be the same.

Before you begin the upgrade, regardless of your current version, please make sure to export the PDF from the licensing section. This step is important because during the upgrade, we need to upgrade the database's schema. This will reset the license to a one-month trial period each time and change the Activation Request Code, which is based on the machine's MAC address and hashes of the CPU ID. By exporting the PDF from the licensing section before the upgrade, the Technical Support Engineer (TSE) will have information about your connectors, user count, and expiration date. They will then generate a new license key with the updated activation request code based on the information in the PDF.

If using the Audit DB, you will need to manually connect to the Audit DB after installing the new version and upgrading the schema of the Merge1 DB, 

Was this content helpful?