Already a NinjaOne customer? Log in to view more guides and the latest updates.

NinjaOne Backup: Network Storage

Topic

This article discusses using a Network-Attached Storage (NAS) device to store your device backups.

Environment

NinjaOne Device Backup

Description

You can configure network-attached storage (NAS) to store image and file/folder local backups. This short video gives an overview of the process:

Refer to the sections below for more information on setting up NAS storage for your backups.

Best Practices

  • You should secure NAS access with its own service account that you only use for the Network Storage credential for NinjaOne Backup.
  • You should configure the NAS share for the above service account only, with no access to any other user account.
  • Consider isolating the NAS behind VLAN or firewall access rules.
  • Make sure you inactivate the Recycle Bin on the NAS to avoid storage bloat.
  • For extra security, do not make the share visible to the network via the discovery search features.
  • Always keep your NAS up to date.
  • Do not keep your NAS open to the internet.

Network Storage Setup and Management

Setting up Network Storage

To set up network storage for your backups, follow these steps:

  1. From the NinjaOne dashboard, navigate to AdministrationOrganizations and select an organization.
  2. Open the BackupStorage location tab and click + Add.
1.png
Figure 1: Storage Location (click to enlarge)
  1. Give the network storage a name.
  2. Enter the path to the storage.
  3. Select credentials from the organization's credential store or create a new one. 
  4. To make network storage the default for the organization, check Set as default network storage for this organization. If this is the first time setup, NinjaOne checks this box by default.
2.png
Figure 2: Add Local Storage (click to enlarge)
  1. To test the accessibility of the network storage, click Test

    NinjaOne will then prompt you to select an online Microsoft Windows device in the organization to test. 

  2. Click Start to begin the test.
    • If the test passes, a green check mark will be listed next to all verification steps.
    • If the test fails, an X will indicate the failed stage.

      3.png
      Figure 3: Test Network Storage Location (click to enlarge)
      Important Note: Test devices must be on the same network as the network storage.
  3. Click Save. NinjaOne will list the storage location in the organization editor.

Edit or Delete Network Storage

Select the checkboxes next to the storage location or place your cursor over the row to reveal the actions menu.

4.png
Figure 4: Local Storage (click to enlarge)
You can delete network storage devices if you are not using them as the default for the organization or a location. If you delete a network storage device that you're not using as a device default, NinjaOne will show devices currently using the device as their default storage location (with one list for active devices and another for deleted devices).
Screen_Shot_2022-07-25_at_1.32.24_PM.png
Figure 5: Remove Network Storage Device (click to enlarge)

Assigning Default Network Storage to Use with Backups

Organization Defaults

When adding a new network storage location in the organization editor for the first time, there is a checkbox that will be automatically marked to set that network storage as the default for the organization. However, you can change this setting by following these steps:

  1. Use the steps in the section above to edit one of the storage locations.
  2. Click the checkbox to change the default setting for organizational network storage location.

    6.png
    Figure 6: Set as default (click to enlarge)

Location Defaults

To adjust the default network storage per location:

  1. Open the Locations tab within the organization editor and place your cursor over the location whose network storage should be modified, then click Edit.

    7.png
    Figure 7: Locations (click to enlarge)

    The Edit Location configuration page displays in a dialog box.

  2. Open the Backup tab and select a default network storage option from the drop-down menu. 
  3. Click Save.
8.png
Figure 8: Default Network Storage (click to enlarge)

Device Defaults

To adjust the default network storage per device, follow these steps::

  1. Navigate to the device dashboard and open the Settings tab.
  2. In the NinjaOne Backup module, next to Network Storage, select Edit 

    9.png
    Figure 9: Network Storage (click to enlarge)

    The Network Location editor displays in a dialog box.

  3. Choose a configured network storage location from the drop-down menu, then click Save.
  4. Revert to the configured organization/location settings at any time by hovering over the Overridden label and clicking Revert.

    10.png
    Figure 10: Revert (click to enlarge)

Cloud Sync Failures

When using a hybrid backup plan, data is first stored on the NAS and then synced to the cloud. However, if data fails to sync to the cloud, a device health entry is generated on the device dashboard.

Customize Health Statuses for more information.

Consistency Checks

When using NAS to store backup data, NinjaOne Backup performs two different types of consistency checks.

  1. Pre-flight checks—before performing an incremental backup, the backup agent checks whether a full backup exists on the NAS.
  2. 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.

13.png
Figure 13: Run Integrity Check (click to enlarge)

From the Search tab, check off the device in question and select BackupRun Integrity Check. This option is only available if the device is online.

14.png
Figure 14: Run Integrity Check (click to enlarge)

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.

15.png
Figure 15: Cancel (click to enlarge)

If the integrity check fails, NinjaOne generates a device health alert.

16.png
Figure 16: Integrity check job failed (click to enlarge)

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.

FAQ

Next Steps