Starting with the November 2024 Update of Pagico, a new data sync engine (v2) became available. This newer data sync engine offers substantial gains in performance and reliability, and it will replace the legacy data sync algorithm in the near future. Since v1 and v2 sync engines operate separately, there are some important things to know before enabling the v2 sync.
About the v2 Data Sync Engine
The v2 Data Sync Engine was re-written from the ground up to enable super fast data sync. Simple data changes (such as new tasks, marking tasks as complete, new notes, new project, etc) can be synced in under 2 seconds on the computer side, and the same changes can be synced in under 0.5 second on the mobile side. Larger sync operations, such as re-syncing your entire database, still need multiple sync cycles to complete but the sync cycles will finish significantly faster than the legacy sync engine.
Shorter Cycles, and No More "Useless" Cycles
The v2 Data Sync Engine uses a delta sync approach where it only syncs the changes you made between revisions. As such, each sync gets started right away, skipping the previous "Comparing Notes" stage which may take up to 30 seconds in large teams. Useless cycles are the ones that infinitely repeats itself without doing any real work. This was a known issue in the past due to the complexity of the legacy data sync engine, and this issue no longer exists in v2. Therefore, you won't see Pagico endlessly sync any more; significantly reducing the usage of computer and network resources.
Enabling the v2 Data Sync Engine
What You Need
To utilize the v2 Data Sync Engine, you'll need:
- For your computer: Pagico November 2024 Edition or newer
- For mobile device: Pagico Mobile 7.12 or newer
How To
You can enable the v2 Data Sync by going to the Settings section and switching ON the v2 Data Sync Engine option. Alternatively, Pagico may prompt you to enable the v2 Data Sync with a popup panel. Here's what to expect when you enable the v2 Data Sync Engine:
- All your connected workspaces (Inbox, Personal Cloud, and teams if any) will be automatically migrated to version 2.
- The automatic migration will take up to a few minutes, depending on the amount of data you have in them. While the server migrates your workspace, you will see a holding message like "Sync will start soon..." in the Sync Status area. This message will automatically go away as soon as the migration is completed.
- Once a workspace is upgraded to version 2, it will no longer allow v1 sync. For Pagico apps that are either too old to support the v2 sync, or hasn't enabled v2 sync yet, you may see a message in the Sync Status area that says "Workspace already upgraded to v2, please enable v2 sync to continue".
Special Notes for Team Users
In order to upgrade to the v2 data sync, all team members must update their Pagico apps and enable the v2 data sync. If any team member activates the v2 data sync first, then all other team members must be switching to v2 data sync right away. V1 sync will stop functioning as soon as the teams are upgraded to v2.
More Details about the v2 Data Sync
The v2 Data Sync Engine operates separately from v1 and it is designed to be a replacement of the legacy, v1 data sync. Therefore, by enabling the v2 sync algorithm, the server will start to make a copy of your existing teams (and Personal Cloud) for v2. This means that you need to switch to v2 Sync on all of your Pagico-running devices. If you have some devices on v1 sync and others on v2, they will no longer be in sync.
- Before you start with the v2 sync switch, make a backup copy of your database first.
- The initial workspace migration will be done automatically on the server side, and this may take up to a few minutes depending on the amount of information you have in your team. During the migration process, you will see Pagico attempting to sync but then switch to the waiting mode with a "Sync will resume soon..." message. This is normal.
- It is best to enable v2 sync on one of your computers first. This will cause Pagico to attempt to sync with all your teams (as well as Personal Cloud) once, essentially kicking off the auto migration process on your cloud-based data sync repositories.
- When the sync cycles have completed successfully, you can turn on the v2 sync on your other computers (if any). This process should not take long, as the auto-migration process on each team only occurs once.
- When v2 sync is enabled, you'll see a "v2" label in the Sync Status display area.
- In some cases, some of your devices may need to check out all the data that's already in your team (or Personal Cloud). This may take up to several sync cycles. In this case, you may see the data sync going constantly. Periodically, Pagico would report the overall sync progress (e.g. Personal Cloud, 54% synced) to indicate that it is not stuck in an infinite loop situation. If the sync appears to be repeating, just let Pagico sync and it will eventually finish.
- How many cycles should it take? Pagico checks out 500 items in each cycle. So if your Personal Cloud contains 5000 items, it will take Pagico 10 sync cycles to complete a full sync.
- In the unlikely event of data sync issues popping up, please contact support@pagico.com and we will help you out!