NSX VIBs fail to install reboot required
search cancel

NSX VIBs fail to install reboot required

book

Article ID: 336614

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

Symptoms:

Host preparation fails.

The installation status shows 'Not Ready' and the error when you click on 'Not Ready' is:

Host reboot is required to complete agent VIB installation. Resolving this error will attempt to put the host into maintenance mode and reboot it.

Subsequent reboots do not resolve the issue.

The displayed error is correct, but misleading, as the installation failed and is being rolled back.

This can be seen in the esxudate.log:

 2018-08-14T07:27:05Z esxupdate: 37643: HostImage: DEBUG: installer LiveImageInstaller failed: ([], 'Error in running [\'/etc/init.d/vxlan-vib\', \'start\', \'install\']:\nReturn code: 1\nOutput: Errors: \nunknown module \'ixgbe\'\nTraceback (most recent call last):\n File "/etc/init.d/vxlan-vib", line 268, in <module>\n updateIxgbeDriver()\n File "/etc/init.d/vxlan-vib", line 197, in updateIxgbeDriver\n ixgbeConfig = localcli(\'system module parameters list -m ixgbe\')\n File "/etc/init.d/vxlan-vib", line 50, in localcli\n raise Exception(\'Failed to execute "localcli %s": %s\' % (cmd, out))\nException: Failed to execute "localcli system module parameters list -m ixgbe": \n\nIt is not safe to continue. Please reboot the host immediately to discard the unfinished update.'). Clean up the installation.^@


Environment

VMware NSX for vSphere 6.2.x

Cause

The installation fails becasue NSX Manager does a check for the ixgbe drivers on each ESXi before installing the NSX VIBs. If these drivers are not present the install will fail, even if the ESXi host does not use these drivers.

This is a known issue affecting NSX 6.2.x
This issue is resolved in NSX 6.3.x and 6.4.x for ESXi 6.0 and upwards.

Resolution

Upgrade to NSX 6.3.x or 6.4.x and ESXi 6.0 or greater.


Workaround:

If you are unable to upgrade, the only workaround is to:

Install the ixgbe driver, then continue with the install of the NSX VIBs.

Once the NSX VIBs have successfully installed, you can remove the ixgbe driver, if unneeded.