File Sync (Windows Only)

Working with files in Kahua just became a whole lot easier!  Users now have the ability to sync File Manager to a folder on their local PC.  Syncing will push physical files from Kahua to the user's PC, at which point the user can open and modify the file using its native application.  Once changes have been saved and the file closed, Kahua will sync the file back into the Kahua platform where it will be distributed to any other users who have also synced that project.  File sync is a great solution when working in areas that do not have an internet connection, since the files are stored locally on your PC, you do not need an active internet connection and can work on them offline.  Once reconnected, any changes will be pushed back into Kahua and files added by others will also be retrieved.  Kahua has also incorporated a file conflict checker to warn users in the event two users have modified the file at the same time.  If a conflict is detected, users will be given the option to create a new version of the file or discard their changes.  


File Sync is controlled by a new Role in the Groups app for File Manager called "Sync".  The Domain Admin and Domain Users groups have the role enabled by default.  This role will need to be enabled by an administrator for all other groups.  A Kahua Platform License is required to enable File Sync



File Sync best practices:

  • File Sync may impact system performance and bandwidth used based on the amount of files in the projects you have synced
  • Always map to a folder on your C: drive or some other local directory; do not map to a network location
  • Only enable syncing on projects that you need
  • The Kahua host must be running for files to sync; make sure you log in at least once per day
  • Folders cannot be created locally; users must create folders using the Kahua host
  • Files and Folders cannot be deleted from Kahua via the local directory; users must use the Kahua host for deleting
  • Files deleted via the Kahua host will be removed from the user's local directory
  • Folders that have been shared to you are not synced


There are two components to enabling file sync:  setting up your PC, which only needs to be performed one time; and enabling a project.  Once a project has been enabled, a sub-folder for your company will be created at the location you have selected and the project hierarchy will be built out below based on enabled projects.  


To set up File Sync on your PC:

  1. Open the Status dialog and select the Settings tab for File Sync
  2. In the Synchronization section, check the box to Enable syncing
  3. Click "Set Local Path"
  4. Browse to a directory on your PC where you would like to store the files, for instance, "Documents" or "Desktop".  Kahua recommends mapping to a sub-folder created specifically for syncing, such as "Kahua Sync".  The folder must be a local directory on your PC (C:\ or D:\) to permit offline access.  
  5. Save


To enable a project for syncing:

  1. Navigate to the project you would like to sync
  2. Open the Status dialog and select the Settings tab for File Sync
  3. In the Project section, click "Enable"
    NOTE:  The first time you enable a project, it can take several minutes for all files to be synced to your machine


Troubleshooting

  • If you find that files are not syncing, try disabling the File Sync functionality by unchecking the "Enabled?" box in the Synchronization section on the Settings tab, saving and then re-enabling the sync
  • It can take several minutes for all files to be synced and show in the Kahua host and/or Windows Explorer.  The amount of time it takes is affected by the number of files and folders being synced, the connection speed and the hardware specifications of your machine