Skip to main content

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, yes.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to version 6 and later.

Other available versions:

Version 5 | Version 4Link: What version am I on?

Code42 Support

Understand and troubleshoot backup issues with Mac file watching services

Who is this article for?

Code42 for EnterpriseSee product plans and features
CrashPlan for Small Business 

CrashPlan for Small Business, yes.

Code42 for Enterprise, yes.

Link: Product plans and features.

This article applies to version 6 and later.

Other available versions:

Version 5 | Version 4Link: What version am I on?

Overview

The Code42 app uses file watching services to monitor your Mac computer for file changes. This article describes:

  • The technical details about how the Code42 app and file watching services work together
  • Recommended solutions for errors associated with file watching services

How the Code42 app uses file watching services

At a high level, here's how the Code42 app coordinates with Mac file watching services to back up your new or changed files:

  1. The Code42 app starts to back up.
  2. The Code42 app requests a snapshot from the file watching service for all local drives.
  1. The file watching service creates a snapshot containing information on all new or changed files.
  2. The file watching service provides the Code42 app with details to access the new snapshot.
  3. The Code42 app backs up ALL files using the snapshot until it reaches a file that has changed since the snapshot was created or the backup session finishes.

This process repeats when the file watching service reports data in your file selection has changed.

Diagnose problems with file watching services

If your backup never reaches 100%, or you see the message "unable to back up n files" in your History.log file, you can check your logs to find the files that are not backing up

The reason may be due to one of the following file watcher-related problems:

Recommended solutions

Unable to back up files due to restricted permissions

The Code42 app cannot back up files or folders that have restricted permissions and display a red circle in the Finder. You can either prevent Code42 app from trying to back up the files by modifying your file selection, or you can perform the following steps to change permissions on the files to allow the Code42 app read/write access:

  1. In Finder, select the folder you want to update.
  2. Choose File > Get Info.
    Permissions
  3. Click the triangle next to Sharing & Permissions to expand the section.
  4. Click the lock icon to allow editing of your settings.
  5. When prompted, enter your password to allow changes to the Finder.
  6. Next to everyone, click No Access to display privilege options.
  7. Select Read & Write.
    Read and write access
  8. Click the gear icon, then select Apply to enclosed items to apply the setting to enclosed subfolders and files.
    Click OK when prompted to confirm the change.
    Apply to enclosed items
  9. Click the lock icon again to prevent future changes.

Code42 app is unaware of file changes

Because the Code42 app uses a file watching service to detect file changes, the Code42 app real-time file watch feature cannot detect any new or changed files in your file selection if the file watching service does not report the changes to the files. Confirm that the file watching service is reporting file changes:

  • Manually start the file verification process in the Code42 app by selecting Scan for file changes.
  • (Code42 app version 6.9.2 and earlier) If you notice that new files are not being detected and backed up by the Code42 app, it could be that Spotlight has not indexed the files. Re-index Spotlight by following the steps outlined in this Apple support article.