Features

FYI Migrate FAQs

Will reinstalling the FYI Migrate app cause documents to be duplicated?

No. Simply installing the latest version of the FYI Migrate app will only update the app. This will not cause any documents to be duplicated.

What are the "Skipped" documents?

There will likely be some documents skipped during the migration process. The skipped files represent documents that have been uploaded successfully already.

1426_Skipped_docs.gif

When the FYI Migrate app completes a full sync, it will then revisit each document on an hourly basis (looking for new/edited files). If it comes across a file it has already uploaded, and the file has not been edited, then the app will "skip" the file.

What are the "Excluded" documents?

There will likely be some documents excluded from the upload. These exclusions have been defined based on feedback received during previous data migrations.

1427_Excluded_docs.gif

Depending on the system you are migrating from, the exclusions will differ. Most commonly, excluded files relate to items that are neither usable nor useful inside of FYI, such as database files for your historical DM system.

For details of the standard files that are excluded, refer to What data is migrated into FYI?

Excluded files for your practice's document migration can be accessed from the Migration Audit Report in FYI. Refer to Implementors: Migration Audit Report.

What are the "Error" documents?

There may be errors during the upload.

1428_Errored_docs.gif

The most common examples of where this occurs are:

  • The document is in the process of being edited.
    The FYI Migrate app will re-attempt to sync these documents each hour, which commonly solves the issue.
  • The document file has no data.
  • The FYI Migrate app cannot access the document.

Error files for your practice's document migration can be accessed from the Migration Audit Report in FYI. Refer to Implementors: Migration Audit Report.

Can I continue working whilst it syncs?

Yes, absolutely. Whilst FYI is syncing your documents, your entire team can continue working in the legacy system uninterrupted. So long as the FYI sync is running (generally right up until Migration Cut-Off), it is picking up any newly created or edited documents.

There are three things to be aware of though once the sync is underway:

  • If you delete document(s) or folder(s) in your legacy system after FYI has synced them, then they will not be deleted from FYI.
  • If you move document(s) or folder(s) in your legacy system after FYI has synced them, then it may result in duplicates of those documents appearing in FYI.
  • If you rename document(s) in your:
    • Folder-based system, for example Windows Explorer, a new document will be synced to FYI.
    • Database system, for example MYOB AE, the document will be updated with a new version but will not be renamed.
  • If you rename folder(s) in your folder-based system, for example Windows Explorer, documents will be duplicated in FYI. Refer to Modifying Files While the Migrate App is Running.

We recommend communicating the above to your team in advance of the sync kicking off.

If you make a mistake selecting the Folder Structure

If you select the wrong level of the folder structure:
Contact FYI to delete the documents and delete the FYI data file. You can then start again.

Note: If the data is not deleted, the FYI Migrate app records that it has already brought them into FYI.

If you select an incorrect folder:
Contact FYI to delete the documents and update the folder selections in the app and continue the Migrate.

Are documents with long file paths migrated?

In Windows File Explorer, there is a general file path limit of 260 characters. This is the combination of the folder path and the file name. If you believe this could impact your document migration, please do some research and testing to ensure long file paths are being accounted for.

For example, if you are migrating from Dropbox, you can enable your Windows Explorer to accept file paths greater than 260 characters. Once this is done, FYI is able to sync these documents.

To enable Windows to accept file paths greater than 260 characters, refer to the Microsoft article Maximum Path Length Limitation.

Once long file paths are enabled on the PC that Dropbox syncs with, Dropbox should not have any issues syncing the full library. Refer to this Dropbox article.

Note: FYI does not guarantee that files with file paths greater than 260 characters if originally stored in the cloud such as on Dropbox, will be migrated to FYI. Consider shortening the file path before starting the FYI Migrate App. For example, update the route folder originally called "Firm's Tax & Accounting Client Documents" to a shorter folder name of "Clients".

How fast should it be syncing?

The speed of your data sync is dependent on a number of factors, primarily:

  • Your bandwidth (internet speed); and
  • The size of the files being uploaded
  • A high volume of local writes for caching

Greater internet speed and smaller file sizes will increase the number of documents we can sync in a given period.

We recommend adding the Migrate folder to the exclusion list on the server's antivirus, as well as reviewing the network traffic to https://api-ap-southeast-2.fyi.app to ensure there are no bottlenecks. Documents are uploaded directly to AWS S3 using pre-signed URLs. Refer also to Technical Requirements.

How long will it take to sync my documents?

As a guide, the FYI Migrate app will sync about 250GB of data in one business day if left to run uninterrupted on a relatively fast internet connection.

What if the sync stops or the FYI Migrate app stops or is closed?

If you select Stop, the sync will effectively pause. You can then select Start to continue the sync.

If the FYI Migrate app stops itself, this could be for various reasons. You can select Start to continue the sync and it will pick up where it last left off.

If the FYI Migrate app is closed, or the computer it is running on is shut down, the syncing process will stop. To restart the sync:

  1. Open the migration application
  2. Log back in (if prompted)
  3. Ensure all settings are exactly as they were.
  4. Then start the sync again (it will pick up where it left off).

Important note for database systems: On the Select your folder(s) to Migrate screen, it is critically important you select the same folder as the initial sync.

Important note for folder based systems: If you sync a different folder to the one you synced originally, this can result in duplicate data. Duplicates can of course be deleted from within FYI following the import completion, but if at any time you need FYI to completely clear your sync so that you can start again, please contact your Onboarding Consultant or FYI Implementor and pause any ongoing syncs. This may also delay your Go Live date.

What if the sync stops and I do not have the original files?

If the sync has stopped and you need to restart it, but you do not still have the original files and/or there are additional files to sync.

  • If the path is 100% the same, then it can just be started again (see above), it will not overwrite changes.
  • But, if the path has changed, it will duplicate the import so this must be avoided. Please contact your Onboarding Consultant or FYI Implementor to discuss further.

Can I sync from more than one historical document source simultaneously?

Only one instance of the FYI Migrate can run per device. We recommend using different user profiles for each migration to easily identify the Migration Audit Report.

  • When migrating from a folder system, you can include multiple folders to sync.

    Important Note: Ensure the import source name is different. For Windows Explorer, this is the top-level folder (for example, C:\Data\Documents\Clients and C:\Data\Documents\HR).

    The top-level folder name cannot be the same, so you cannot sync G:\Clients and H:\Clients simultaneously as the second one will overwrite the first.

    We would recommend updating the source path folder name. For example, if the two folders are called Clients, update one to be Client A and the other to Client B.

  • If you want to run a sync of a folder-based system and a database system at the same time, for example, MYOB or Virtual Cabinet, this can be done but it must be done on a separate computer or server with a different instance of the FYI Migrate app.

  • If you want to run a sync of any database system at the same time, for example MYOB or Virtual Cabinet, this can be done but it must be done on a separate computer or server with a different instance of the FYI Migrate app.

What do I do after the sync is finished?

Once the Migration Sync in the FYI Migrate app is complete, your documents are imported. They are then ready to be refiled. Liaise with your Onboarding Consultant or FYI Implementor who will arrange refiling in consultation with you.

When can we Uninstall the FYI Migrate app?

When all documents have been successfully migrated, and the practice has confirmed that all documents have been migrated and filed, you can uninstall the FYI Migrate app.

Refer to Uninstalling the FYI Migrate App.

Was this article helpful?
0 out of 1 found this helpful