VMware Update Manager/esxupdate error codes

Products

• VMware vCenter Server
• VMware vSphere ESXi

Issue/Introduction

This article provides a list of possible VMware Update Manager/esxupdate error codes that may be displayed if there are issues while executing the esxupdate utility or when an interaction is necessary. The esxupdate utility can be used to patch ESX/ESXi hosts and can be invoked as a standalone utility directly on the ESX/ESXi host. Also, VMware Update Manager uses it as a patching mechanism.

Symptoms:

Environment

VMware vCenter Update Manager 4.0.x
VMware ESXi 4.1.x Embedded
VMware ESX 4.0.x
VMware ESXi 4.0.x Embedded
VMware ESXi 4.1.x Installable
VMware ESXi 4.0.x Installable
VMware ESX 4.1.x
VMware vCenter Update Manager 4.1.x

Resolution

Error Codes

The following codes can be seen when executing esxupdate:

• NotRootError(EsxupdateError):
  description = 'The current user is not UID 0 (root).'
  errno = 1
  
  
• LockingError(EsxupdateError):
  description = 'Another instance of esxupdate is currently running.'
  errno = 3
  
  
• MetadataDownloadError(EsxupdateError):
  description = 'Failed to download metadata.'
  errno = 4
  
  
• MetadataFormatError(EsxupdateError):
  description = 'The format of the metadata is invalid.'
  errno = 5
  
  
• VibDownloadError(EsxupdateError):
  description = 'Failed to download VIB.'
  errno = 7
  
  
• VibFormatError(EsxupdateError):
  description = 'The format of the VIB is invalid.'
  errno = 8
  
  
• VibIOError(EsxupdateError):
  description = 'Error reading or writing VIB data.'
  errno = 9
  
  
• FileIOError(EsxupdateError):
  description = 'Unable to create, write or read a file as expected.'
  errno = 10
  
  
• DatabaseFormatError(EsxupdateError):
  description = 'The format of the database is invalid.'
  errno = 11
  
  
• DatabaseIOError(EsxupdateError):
  description = 'Unable to read or write to database.'
  errno = 12
  
  
• NoMatchError(EsxupdateError):
  description = 'No matching bulletin or VIB was found in the metadata.'
  errno = 13
  
  
• DependencyError(EsxupdateError):
  description = 'There was an error resolving dependencies.'
  errno = 14
  
  
• PackageManagerError(EsxupdateError):
  description = 'The package manager transaction failed.'
  errno = 15
  
  
• ConfigError(EsxupdateError):
  description = 'Failed to parse configuration files.'
  errno = 16
  
  
• VisorSetupError(EsxupdateError):
  description = 'There was an error setting up ESXi installation destination'
  errno = 17
  
  
• MaintenanceModeError(EsxupdateError):
  description = 'Maintenance mode is not enabled or could not be determined.'
  errno = 18
  
  
• PostScriptError(EsxupdateError):
  description = 'A post-transaction script failed with a nonzero exit code. '\
  'Examine esxupdate logs for more details. '
  errno = 19
  
  
• VibSignatureError(EsxupdateError):
  """ Base for all Vib signature errors """
  pass
  
  
• VibSigMissingError(VibSignatureError):
  description = 'Vib signature is missing.'
  errno = 20
  
  
• VibSigVersionError(VibSignatureError):
  description = 'Unsupported Vib signature version.'
  errno = 21
  
  
• VibSigFormatError(VibSignatureError):
  description = 'pkcs7.sig file is too short or corrupted.'
  errno = 22
  
  
• VibSigInvalidError(VibSignatureError):
  description = 'PKCS7 certificate is not valid (expired, etc) or ' \
  'the public key is missing.'
  errno = 23
  
  
• VibSigDigestError(VibSignatureError):
  description = 'Vib digest does not match the digest in the PKCS7 signature.'
  errno = 24
  
  
• UnsatisfiedDependencies(EsxupdateError):
  description = 'Additional VIBs are required to satisfy dependencies.'
  errno = 25
  
  
• BundleDownloadError(EsxupdateError):
  description = 'Failed to download offline bundle .zip.'
  errno = 26
  
  
• BundleFormatError(EsxupdateError):
  description = 'Invalid bundle ZIP archive, or missing metadata.zip inside.'
  errno = 27
  
  
• UnsupportedCommandError(EsxupdateError):
  description = 'The requested command is not supported on the platform.'
  errno = 28
  

Additional Information

Warning Error Codes

The follow codes can be seen when an interaction is necessary:

• NeedsRebootResult(NormalExit):
  description = 'The update completed successfully, ' \
  'but the system needs to be ' \
  'rebooted for the changes to be effective.'
  errno = 80
  
  
• HostdRestartResult(NormalExit):
  description = 'Hostd needs to be restarted to complete installation.'
  errno = 81
  
  
• HostNotChanged(NormalExit):
  description = 'Host was not updated, no changes required.'
  errno = 82