Skip to main content

Upgrading to the Latest Major Version

Table of Contents:

Upgrading to the Latest Major Version

To upgrade to the latest major version of MirrorSync, follow the steps below. Only the installer step is required immediately — the remaining steps can be completed later, but should be done soon to ensure optimal performance and long-term compatibility.

1. Run the Installer​

Run the latest MirrorSync installer on every server involved in the sync. This includes the syncing server, the hub server (if it's separate from the syncing server) and any FileMaker spoke servers.

2. Update MirrorSync Scripts (Soon After)​

After installing the newest version, you should be able to continue syncing without doing anything else. However, you should update the MirrorSync scripts in your FileMaker databases soon to take advantage of all of MirrorSync 7's optimizations and features.

To upgrade your scripts:

  • In both hub and spoke files:
  1. Right click and duplicate the existing MirrorSync 6 and MirrorSync 6 worker scripts. (This gives you a backup of your customizations.)
  2. In the original MirrorSync 6 and MirrorSync 6 worker scripts, delete all steps.
  3. Copy the contents of the new scripts from the MirrorSync Support.fmp12 file (included with the installer package download) and paste them into the now-empty originals.
  4. Right-click the scripts and set them to use Full Access privileges, if they don't already; it's our experience that this resolves quite a few rare problems.

Duplicating the scripts and replacing the contents of the original script preserves any script references that rely on the exact script names.

Note:

Spoke databases do not need to have their scripts updated immediately, even if you've updated the hub scripts. They can continue to sync using older scripts and be updated at any point in the future (such as when you're using the MirrorSync versioning feature to replace the spoke database). However, updating them soon is recommended for improved performance.

3. Reapply Script Customizations​

Review your duplicated (backed-up) scripts and reapply any customizations to the newly updated scripts.

There's only one customization that always needs to be reapplied:

  • Replace the initialization of $$MIRRORSYNC_URL in the scripts with the correct URL of your MirrorSync server.
  • You can find this value in the duplicated copy of your old script.
  • If your old script has $$MIRRORSYNC_URL_EXTERNAL uncommented, copy/paste that script step into your new script in the same place.
Note:

This step is optional, but recommended to ensure you're using the latest layout elements and user interface improvements. It will not impact performance or function.

To update the layout used for sync operations:

  • Go to the layout named "MirrorSync" in your FileMaker file.
  • Do not delete the layout, but delete all layout objects on it.
  • Open the MirrorSync Support.fmp12 file included with the installer.
  • Copy all objects from its "MirrorSync" layout and paste them into your now-empty layout.
Note:

This step is optional, but recommended to ensure you're using the latest layout elements and user interface improvements. It will not impact performance or function.

If you need help or have questions during the upgrade process, please contact 360Works support; we’re happy to assist.