JetStream Software Portal

IO Filter Upgrade Failure

This article applies to all JSDR software versions.

Problem

During the JetStream DR upgrade process, which includes upgrading IO Filter, a failure may be reported and the upgrade task can time out. Subsequently, vCenter Tasks will indicate “An error occurred during host configuration.

Error message in task list.
Task details showing error.

Troubleshooting

1. Check if the host is currently in maintenance mode or if any affinity rules are blocking the action.

2. Ensure there are no other errors or issues with the host.

3. Navigate to JetStream DR → Configuration → Host Details and check the Status for any host problems.

Check the host details for any errors.

4. From the same screen, click the Show Host Errors button to reveal additional details.

Host error details.

5. Issue the following command from the ESXi CLI to determine if the old IO Filter VIB has been removed: esxcli software vib list | grep jet

6. If the old VIB has not been removed, attempt to manually remove it and then resume the upgrade.

  • The host must be in maintenance mode.
  • Issue the following command to remove the VIB: esxcli software vib remove -n "<VIB name from the (step-5 command output)>"
    • For example: esxcli software vib remove -n "jet"
  • If VIB removal from the host is unsuccessful using the above command, reboot the host and try again.

7. The Resume function of the Run command upgrade may result in the message “No upgrade available for cluster.

  • This can occur if a previous upgrade attempt updated the vibUrl in the cluster causing it to now point to the current IO Filter.
  • In this case, execute the Run command “resolve-cluster issue” to re-initiate the failed cluster upgrade.
No upgrade available for cluster message.

8. Attempt to restart the affected host after placing it into maintenance mode.

  • This action will automatically install the new IO Filter VIB.
  • If this step fails the new VIB may need to be manually installed on the host.

For the AVS environment, Microsoft support assistance is required for the ESXi CLI access, host reboot or manual VIB installation.

Was this article helpful?

Related Articles

Can We Help You?

Can't find what you're looking for?
Contact JetStream