Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ for Enterprise Vault Agent Administrator's Guide
  3. Appendix A. NetBackup Enterprise Vault Migrator
  4. Troubleshooting the Enterprise Vault migrator
  5. About troubleshooting issues with the migrator
  6. Is the migration being configured appropriately?
NetBackup™ for Enterprise Vault Agent Administrator's Guide

Is the migration being configured appropriately?

From the Advanced tab on the Vault Store Partition Properties dialog box, you can configure a partition for migration. Make sure that you enter the value of NBU Policy and NBU Server correctly.

To verify that you configured the migration properly, click Test.

If the test fails, and the NBU Policy and NBU Server configurations are correct, the issue could be due to one of the following reasons:

  • The xbsa (Datastore) license is not installed in NetBackup.

    If the Datastore license is not installed in NetBackup, the test fails. The user interface does not provide any notification that a licensing issue is the cause of the failure.

    If it is a licensing issue, the following message (or something similar) appears in the exten_client logs.

    InvalididParameterHandler bsa_checkfeatureID: None of the features are licensed.

    This string may also appear in the Dtrace logs.

    Failed to initialize xBSA. Make sure NetBackup client is installed and configured.

    To resolve this issue, perform the following:

    • Install the required NetBackup license.

    • Restart the NetBackup services. Do that only if it is required.

  • NBUMigrator is not registered.

    In certain scenarios you must manually install and register the migrator. In this case, if you have not followed the registration steps then the following error appears as an Enterprise Vault pop-up dialog box.

    The selected file migration software is not registered or installed. Reason: Class not registered

    To resolve this issue, register the Enterprise Vault migrator.

  • The xbsa.dll is not present in the system path.

    In the first version of the Enterprise Vault migrator (NBUMigrator.dll), the path of the file xbsa.dll needed to be present in the PATH environment variable. That is no longer the case with the later releases of the Enterprise Vault migrator. The path is now configured programmatically.

    If the xbsa.dll is not present in the system path, then the following message is logged on the Dtrace logs.

    Failed to load xbsa library. Check the NetBackup client installation, ensuring that xbsa.dll is installed.

    To resolve this issue perform the following:

    • Add the path of xbsa.dll to the PATH environment variable. The xbsa.dll is present under NBU_INSTALL_DIRECTORY\bin.

    • Restart the Enterprise Vault Admin service. Restarting this service restarts all of the Enterprise Vault services. You need to restart all of the Enterprise Vault processes because certain processes may use the migrator (NBUMigrator.dll). Restarting them enables them to locate and load the xbsa.dll.

Feedback

Was this page helpful?
Previous

Is the data being collected?

Next

Is the data being migrated?

Feedback

Was this page helpful?