I/O filter uninstallation issues

Product version: 11.0

Last modified: 05 March 2025

Problem

I get an error when NAKIVO Backup & Replication tries to uninstall the I/O Filter. How can I fix it?

Solutions

You may encounter an error when NAKIVO Backup & Replication is trying to uninstall the I/O Filter. To see the exact reason for the I/O Filter uninstallation failure:

  1. Go to the vCenter and open Cluster > Configure > I/O filters.

  2. Select nakfilter and click Error in the Filter Status column.

The error may occur due to the following reasons:

  • Uninstallation Fails Without Specific Error Message

    • Solution: Re-try the uninstallation process. Ensure the system resources and network connections are stable before initiating another attempt.

  • Server Error in vCenter Event Logs. Event Logs contain the errors with the Raw Fault Code equal to ServerFaultCode. The Raw Fault String is “Required parameter filterId is missing while parsing call information for method ResolveInstallationErrorsOnCluster_Task at line 1, column 285 while parsing SOAP body at line 1, column 271 while parsing SOAP envelope at line 1, column 38 while parsing HTTP request for method resolveInstallationErrorsOnCluster on the object of type vim.IoFilterManager at line 1, column 0.”

    • Solution: Check the configuration and verify that all required parameters, including the missing parameter ("filterId" in this example), are correctly specified.

  • Incorrect VIB URL or Inaccessible URL Error

    • Solution: Ensure the VIB URL provided is accurate and accessible from the system. Update the URL if necessary, and confirm network connectivity to the specified location.

  • Uninstallation Fails with “Cannot Complete the Operation” Error

    You may encounter the following error message: Cannot complete the operation. Click the restart button to retry or see vCenter event log for details. The main reason is that the Host cannot be put into maintenance mode to complete VIB uninstallation.

    • Solution:

      1. Go to the vCenter and suspend or power off all VMs on the corresponding host.

      2. Manually put the host into maintenance mode.

      3. When the IO filter is removed from the host, exit the maintenance mode.

      4. Repeat for all hosts in the Cluster if needed.

      5. Go to the NAKIVO Backup&Replication, open the Activities tab, and restart the failed Setting up real-time replication service action.