Consistency Checks
When using NAS to store backup data, NinjaOne Backup performs two different types of consistency checks.
- Pre-flight checks—before performing an incremental backup, the backup agent checks whether a full backup exists on the NAS.
- Integrity checks—checks run on demand to confirm that the data on the NAS matches the data in the database.
Both of these consistency checks are performed using a hash check, where an encoded version of the file is compared to the version of the file in the database.
For information about different errors that may be encountered during a consistency check, refer to NinjaOne Backup: Troubleshooting Error Codes.
Pre-flight checks
NinjaOne runs a pre-flight check whenever it starts a backup job. If the pre-flight check fails, that backup job will fail, and an error will display indicating job failure due to the failed pre-flight check.
Integrity checks
You can run Integrity checks on demand from the device page or from the Search tab.
From the device page, move your cursor over the backup icon and select Run Integrity Check. This option is only available if the device is online.
From the Search tab, check off the device in question and select Backup → Run Integrity Check. This option is only available if the device is online.
Once an integrity check has been triggered on a device, it shows as a running action on the device. You can cancel a running integrity check by clicking the downward-facing arrow in the events list for the action.
If the integrity check fails, NinjaOne generates a device health alert.
From the drop-down menu in the device health alert window, you will have options to Clear, Retry, or view Warnings.
The Warnings option opens a dialog box with information about the specific errors causing the check to fail.
Additional Considerations
- Backup to local storage will complete with a warning if available disk space is less than five percent. or 500 GB; whichever number is lower.
- Backup to local storage will fail if available disk space is less than two percent, or 200 GB, whichever number is lower.
- You can manually clear failed integrity checks as described above. However, if you want to change the status that an integrity check failure will put your device in, you must configure this setting using Health Statuses.
- For hybrid plans, if you delete backup data from the NAS, a new backup plan will have to be created and run for NinjaOne to back up the data again.
- Data Integrity Check with API utilizes the existing integrity check function that is only available for Local or Hybrid plans to perform a data integrity check on the locally stored dataset.
