Skip to main content

Return codes

XClarity Essentials OneCLI issues a return code to indicate either successful execution of a command or to indicate that an error occurred while the program was running. A return code of zero indicates that the operation was successful, and a nonzero return code indicates an error.

To determine whether any errors occurred and when based on the associated timestamp, refer to one of the following log files:
  • For Windows, review the C:\Lenovo_Support\onecli.log file.
  • For Linux, review the /var/log/Lenovo_Support/onecli.log file.
Return codesTable
Common return codes

Table 1

config-related return codes

Table 2

update-related return codes

Table 3

FFDC-related return codes

Table 4

raid-related return codes

Table 5

diags-related return codes

Table 6

FoD-related return codes

Table 7

Table 1. OneCLI common return codes
Return codeDecimal baseDescription
0x000Success.
0x011Generic failure.
0x033Invalid application.
0x044Invalid command.
0x055Invalid parameter.
0x066Local file does not exist.
0x077Invalid file.
0x088Failed to create directory.
0x099Failed to open file.
0x0A10Failed to read file.
0x0B11Failed to write file.
0x0C12Authentication failed.
0x0D13Connection failed.
0x0E14Ping failed.
0x0F15Upload failed.
0x1016Download failed.
0x1117Internal error.
0x1218Time-out.
0x1319Failed to get XCC account through KCS.
0x1420Users are running on an IBM system. Do not use proxy tool in onecli extract path when set the executable binary of legacy ToolsCenter path in global.config.
0x1521LAN-over-USB device is disabled on BMC side. Enable it manually.
0x1622The BMC default internal IP conflicts with external machine. Correct the problem, and try again.
0x1723Failed to restart host system.
0x1824Failed to restart BMC.
0x1925Platform error.
0x1a26
  • For windows servers, LAN-over-USB device is not detected.

    .
  • For linux servers, some tools are not installed, including lsusb,lsmod,and modprobe.

0x1b27Failed to get driver information
0x1c28Failed to get machine type.
0x1e30Internal error of BMC.
0x1f31Failed to find applicable hardware component.
0x2032Failed to load LAN-over-USB device driver.
0x2133

For windows servers: Failed to run commands without root permission. Switch to root user and try again.

For linux servers: Failed to run commands without administrator permission. Switch to administrator user and try again.

0x2234Failed to update due to ESXI internal error.
0x2335CMM internal error.
0x2436Failed to verify the certificate/fingerprint for the connection(s) specified.
0x2537Manually quit OneCLI.
0x2638Invalid file folder.
0x2739Failed to encrypt/decrypt.
0x2840Fail to find the matching credential.
0x2941Fail to find the matching tool package for remote machine.
0x2a42Remote operation not support this remote machine.
0x2b43Could not find credential file.
0x2c44The path behind the option remoteos does not exist.
0x2d45Attended or unattended mode conflict.
0x2e46Passphrase error.
0x2f47Interrupted by user.
0x3048Encrypted file is not exist.
0x3149Encrypted file is invalid.
0x3250Failed to connect KCS. Check IPMI over KCS status.
0x3351Unable to access IPMI service with a password over 20 characters according to IPMI standard.
0x3452There is no RESTful service for the target server.
0x3553Check the format of input for connection parameter. For credential encrypt user, can't find crypt.json.
0x3654The password provided for this account must be changed before access is granted.
0x3755BMC CIM Over HTTPS is disabled.
0x3856Invalid BMC/CMM/SMM Address.
0x3957Check BMU requirement failed.
0x3a58One or more tasks failed.
0x3b59One or more tasks skipped.
0x3c60Fail to get data from Rest interface of BMC.
 
Table 2. OneCLI config-related return codes
Return codeDecimal baseDescription
0x5C92Invalid data field.
0x5D93Failed to change the settings. It is recommended to change the settings in batch mode by using the provided password.
0x5E94The required FoD key has not been installed.
0x5F95The setting has invalid current value.
0x6096Operation unavailable. Users should wait a moment and retry later.
0x6197Certificate does not exist.
0x6298The default value is empty.
0x6399Invalid e-maill address of destination.
0x64100The current version of firmware does not support this function. To resolve this issue, update the target firmware to the latest version.
0x65101Redfish internal error.
0x66102Failed to parse BMC data.
0x67103BMC data error.
0x68104The command is not supported on current system.
0x69105Query BMC error.
0x6A106Invalid certificates.
0x6B107Failed restoration.
0x6C108Failed replication.
0x6D109The password can only be changed in low security level.
0x6E110Previous passwords are not allowed. Try another passwords.
0x6F111The password does not meet password policy requirements.
0x70112User already exists.
0x71113Failed to run commands when executing batch command.
0x72114BMC internal error: No priviledge to complete this operation.
0x73115Invalid setting value.
0x74116Failed to display the instance setting. Create the instance first.
0x75117Invalid commands in the batch file.
0x76118Failed to reconnect to BMC after the command is executed successfully. To check the result, try another method.
0x77119Failed to generate, export, import, or delete certificates.
0x78120Failed to set the setting items.
0x79121Failed to get information.
0x7A122Create the record key of instance first.
0x7B123Unable to find setting.
0x7C124BMC internal error.
0x7D125Failed to run command.
Table 3. OneCLI update-related return codes
Return codeDecimal baseDescription
0x7d125Skip updating this package.
0x7c124Update does not take effect after successful flash.
0x7b123Current BMC version does not support this package. Upgrade BMC to the latest version and try again.
0x7a122Failed to update because this package does not support current method.
0x79121Failed to update because this device does not support current method.
0x78120The candidate update is older than the allowed minimum version.
0x77119Current BMC setting disallows downgrade.
0x76118Device error.
0x75117Another update in progress.
0x74116Failed to prepare update environment.
0x73115BMC RDOC space not enough. Remove other mounted device from BMC RDOC.
0x72114Failed to set up BMU environment.
0x71113Failed to boot into Maintenance Mode OS.
0x70112Failed to acquire.
0x6f111Unsupported OS.
0x6e110Failed to get OS type by using the scan command.
0x6d109No package needs update.
0x6c108UXSPI does not support the current command run in the IBM system.
0x6b107Update blue not supported.
0x6a106Failed to run UXSPI. For more information about the error, see UXSPI logs.
0x69105Failed to update flash because the error backup does not support the update.
0x68104Invalid or unsupported machine type.
0x67103Update error: Flash finished running, however multiple packages failed to be flashed. Check flash status xml for further information.
0x66102Users are running on an IBM system. Ensure that UXSPI_PATH is set to the executable binary of UXSPI in global.config.
0x65101Update error: Failed to generate common_result.xml.
0x64100Update not found.
0x6399No applicable update available in the Repository for the specified machine type or OS.
0x6298Failed to connect to the Repository.
0x6197Unrevoverable error.
0x6096Failed to download some update packages.
Table 4. OneCLI FFDC-related return codes
Return codeDecimal baseDescription
0x7D125Download SMM FFDC error: setup environment failed.
0x7C124Download SMM FFDC error: start dump failed.
0x7B123Download SMM FFDC error: query failed.
0x7A122Download SMM FFDC error: tar ffdc files failed.
0x79121Download SMM FFDC error: tftp server is not found.
0x78120FFDC log is uploaded to the specified FTP/TFTP server, but fails to download FFDC log from FTP/TFTP server.
0x77119Failed to get FFDC log.
Table 5. OneCLI raid-related return codes
Return codeDecimal baseDescription
0x7D125Ensure that the command of RAID configuration runs on the ThinkSystem server with the latest XCC firmware version.
0x7C124The target device does not exist.
0x7B123RAID config has no config to save.
0x7A122RAID config ini file error.
0x79121RAID config fails to operate.
0x78120There are no volumes. Add volumes at first.
0x77119The operation fails on some targets.
0x76118There are no controllers.
0x75117The operation fails on all targets.
0x74116RAID config does not support this command on M.2 SSD.
0x73115There are no disks of the target device.
0x72114Disk state error.
0x71113Current system does not support Intel RSTe software RAID.
0x70112There are no containers.
Table 6. OneCLI diags-related return codes
Return codeDecimal baseDescription
0x3452Failed to trigger diagnostic.
0x3553Failed to get status of diagnostic.
0x3654Failed to get result of diagnostic.
Table 7. OneCLI FoD-related return codes
Return codeDecimal baseDescription
0x7D125FoD key file is not valid.
0x7C124Specified machine type or serial number is not valid.
0x7B123FoD key file is not found.
0x7A122FoD key is not found from target key repository.
0x79121FoD key ID is not valid.
0x78120Active key exists in KMS Web site.
0x77119Authentication code does not exist.
0x76118Unique identifier is not valid.
0x75117Failed to Install the FoD key.
0x74116Failed to uninstall the FoD key.
0x73115Failed to export the FoD key.
0x72114Failed to report the FoD key.
0x71113Failed to get current tier.
0x70112Failed to execute command.
0x6F111The command is not supported on current system.
0x6E110Unable to find the processor specified by 'socketid' on current system.
0x6D109Failed to export the status report.
0x6C108The FoD SDSi is not supported on current system.
0x6B107Failed to get PPIN.
0x6A106The FoD SDSi is only supported with redfish interface.
0x69105The FoD SDSi dose not exist on current system.
0x68104The FoD SDSi specified by the socketid command does not exist on current system.
0x67103The FoD installed is not supported when specifying directory of parameter keyfile.
0x66102Could not find the match key from specified folder.
0x65101Failed to export part of keys from target system.
0x64100The key does not support the uninstall and the export commands.
0x6399The KMS website reports failure.
0x6298Failed to operate file.
0x6197Failed to generate the FoD key from KMS website.
0x6096The specified FoD key does not exist in the current system.
Table 8. Mapping table of return codes between OneCLI V2.3.0 and OneCLI V2.4.0
V2.3.0V2.4.0

Return code/

decimal base

Description

Return code/

decimal base

Description
0x00/0Success.0x00/0Success.
0x01/1Invalid command.0x04/4Invalid command.
0x02/2Generic failure.0x01/1Generic failure.
0x03/3XML file is missing.0x06/6Local file does not exist.
0x04/4Restart OS Failure.0x17/23Failed to restart host system.
0x05/5Failed to connect.0x0D/13Failed to connect.
0x06/6Platform error.0x19/25Function not supported on target system.
0x07/7Input xml file format error.0x07/7The file is not valid.
0x08/8OPEN DLL FAILURE.0x11/17Internal error.
0x09/9GET NULL POINTER.0x11/17Internal error.
0x0A/10NO INTERFACE FOUND.0x11/17Internal error.
0x0B/11RETURN INVALID RESULT.0x11/17Internal error.
0x0C/12Unknown exception.0x01/1Generic failure.
0x0D/13Invalid parameter.0x05/5Invalid parameter.
0x0E/14Local file does not exist.0x06/6Local file does not exist.
0x0F/15Failed to create directory.0x08/8Failed to create directory.
0x10/16Failed to read or write file.0x09/9Failed to open file.
0x11/17Ping BMC failed.0x0E/14Ping failed.
0x12/18Fail to get XCC account through KCS.0x13/19Fail to get XCC account through KCS.
0x13/19
  • BMC Lan Over USB device driver is not detected (for windows).

  • Miss some tools, such as: lsusb, lsmod, and modprobe (for linux).

0x1A/26
  • LAN-over-USB device is not detected. Make sure that RNDIS is correctly installed (for windows).

  • LAN-over-USB device is not detected. Make sure that following tools are installed: lsusb, lsmod, and modprobe (for linux).

0x14/20No package needs update.0x6E/110No package needs update.
0x15/21Users are running on a blue system. Do not use proxy uxspi in onecli extract path when set the executable binary of UXSPI path in global.config.0x14/20Users are running on a blue system. Do not use proxy uxspi in onecli extract path when set the executable binary of UXSPI path in global.config.
0x16/22Authentication with BMC failed.0x0C/12Authentication failed.
0x17/23Authentication failed by FTP server.0x0C/12Authentication failed.
0x18/24Fail to create directory or put file in FTP server: No such file or directory, or permission denied for the specified user name.0x0F/15Upload failed.
0x19/25LXCE has no enable permission. Enable BMC Lan Over USB device manually.0x15/21LAN-over-USB device is disabled on BMC side. Enable it manually.
0x1A/26Fail to upload data to specified FTP server.0x0F/15Upload failed.
0x1B/27Fail to connect through IPMI.0x0D/13Failed to connect.
0x1C/28Ping CMM failed.0x0E/14Ping failed.
0x1D/29Fail to get driver information.0x01/1Generic failure.
0x1E/30Fail to get machine type.0x01/1Generic failure.
0x1F/31Fail to get firmware information.0x01/1Generic failure.
0x20/32Fail to read inventory XML.0x0A/10Failed to read file.
0x21/33Fail to write inventory XML.0x0B/11Failed to write file.
0x22/34Fail to write inventory HTML.0x0B/11Failed to write file.
0x23/35UXSP xml do not exist. Check the UXSP package.0x06/6Local file does not exist.
0x24/36Time-out.0x12/18Time-out.
0x60/96Failed to run the command.0x01/1Generic failure.
0x61/97Failed to get information.0x7D/125Failed to get information.
0x62/98Failed to set the setting items.0x7C/124Failed to set the setting items.
0x63/99Failed to open the file.0x09/9Failed to open file.
0x64/100Failed to read the file.0x0A/10Failed to read file.
0x65/101Failed to write the file.0x0B/11Failed to write file.
0x66/102Failed to generate/export/import/delete certification.0x7B/123Failed to generate/export/import/delete certification.
0x67/103Failed to reconnect to BMC after the command is executed successfully. Users could try another method to check the result.0x7A/122Failed to reconnect to BMC after the command is executed successfully. Users could try another method to check the result.
0x68/104One or more commands are not valid in the batch file.0x79/121One or more commands are not valid in the batch file.
0x69/105Failed to show the instance setting. The instance should be created at first.0x78/120Failed to show the instance setting. The instance should be created at first.
0x6A/106Invalid value for set command.0x77/119Invalid value for set command.
0x40/64Update error: Acquire command failed.0x01/1Generic failure.
0x41/65Update error: Scan command failed.0x01/1Generic failure.
0x42/66Update error: Query command failed.0x01/1Generic failure.
0x43/67Update error: Compare command failed.0x01/1Generic failure.
0x44/68Update error: Flash command failed.0x01/1Generic failure.
0x45/69Update error: File related error occurred, see log/xml for more information.0x0B/11Failed to write file.
0x46/70Update error: CIM service fails. See log/xml for more information.0x01/1Generic failure.
0x47/71Update error: There is something wrong with the device. See log/xml for more information.0x78/120Update error: There is something wrong with the device. See log/xml for more information.
0x48/72Update error: Failed to generate common_result.xml.0x0B/11Failed to write file.
0x49/73Could not get OS type using scan command.0x6F/111Failed to get OS type.
0x4A/74Invalid/unsupported machine type.0x68/104No applicable update available on the repository for specified machine-type/OS.
0x4B/75Invalid/unsupported OS.0x70/112Current Operating System is not supported.
0x4C/76Authentication failed, unable to validate userid/password.0x0C/12Authentication failed.
0x4D/77Update error: Flash finished running, however multiple packages failed to be flashed. Check flash status xml for more information.0x0B/11Failed to write file.
0x4E/78Users are running on an IBM system. Make sure that UXSPI_PATH is set correctly to the executable binary of UXSPI in global.config.0x72/114Users are running on an IBM system. Make sure that UXSPI_PATH is set correctly to the executable binary of UXSPI in global.config.
0x4F/79Users are running on an IBM system. But the current command is not supported in UXSPI.0x6D/109Users are running against an IBM system, but the current command is not supported.
0x50/80Update blue not supported.0x6D/109Users are running against an IBM system, but the current command is not supported.
0x51/81UXSPI does not run successfully, to trace error, see log relate to UXSPI.0x11/17Internal error.
0x52/82Update module was not able to write to XML file.0x0B/11Failed to write file.
0x53/83Update flash module failure: failed to run flash with ESXi. See log/xml for more detail information.0x01/1Generic failure.
0x54/84Update flash module failure: failed to run flash with IOSwitch. See log/xml for more detail information.0x01/1Generic failure.
0x55/85Update flash module failure: failed to run flash with CMM Update. See log/xml for more detail information.0x01/1Generic failure.
0x56/86Update flash module failure: failed to run flash with OOB. See log/xml for more detail information.0x01/1Generic failure.
0x57/87Update flash module failure: Error occurred when running xFirmware for in-band flash.0x01/1Generic failure.
0x58/88Update flash module failure: Error occurred when running Option Update for in-band flash.0x01/1Generic failure.
0x5A/90Update flash failure: Error payload file does not exist.0x07/7Local file does not exist. (dynamic message)
0x5B/91Update flash failure: Error backup does not support.0x6C/108Backup bank does not exist.
0x5C/92The BMC default internal IP conflicts with external machine. Correct the problem, and try again.0x16/22The BMC default internal IP conflicts with external machine. Correct the problem, and try again.
0x5E/94Update flash failure: current BMC does not support internal SFTP for this case.0x7B/123Current BMC version does not support this package. Upgrade BMC to the latest version, and try again.
0x5F/95Update application fails to run.0x01/1Generic failure.
0xD0/208Download SMM FFDC error: setup environment failed.0x7D/125Download SMM FFDC error: setup environment failed.
0xD1/209Download SMM FFDC error: start dump failed.0x7C/124Download SMM FFDC error: start dump failed.
0xD2/210Download SMM FFDC error: query failed.0x7B/123Download SMM FFDC error: query failed.
0xD3/211Download SMM FFDC error: tar ffdc files failed.0x7A/1222Download SMM FFDC error: tar ffdc files failed.
0xD4/212Download SMM FFDC error: upload path does not exist.0x0F/15Upload failed.
0xD5/213Download SMM FFDC error: upload failed.0x0F/15Upload failed.
0xD6/214Download SMM FFDC error: tftp server is not found.0x79/121Download SMM FFDC error: tftp server is not found.
0xD7/215Download SMM FFDC error: time-out.0x12/18Time-out.
0xD8/216Download SMM FFDC error: unknown error.0x01/1Generic failure.
0xD9/217FFDC log is uploaded to the specified FTP/TFTP server, but fails to download FFDC log from FTP/TFTP server.0x78/120FFDC log is uploaded to the specified FTP/TFTP server, but fails to download FFDC log from FTP/TFTP server.
0xDA/218Failed to get FFDC log.0x77/119Failed to get FFDC log.
0xB0/176Raid config fails to operate.0x7D/125Raid config fails to operate.
0xB1/177Raid config ini file error.0x7C/124Raid config ini file error.
0xB2/178Raid config has no config to operate.0x7B/123Raid config has no config to operate.
0xB3/179Raid config does not need make good.0x7A/122Raid config does not need make good.
0xB4/180Raid config does not need make jbod.0x79/121Raid config does not need make jbod.
0x34/52Fail to trigger diags.0x7D/18Fail to trigger diags.
0x35/53Fail to get status of diags.0x7C/124Fail to get status of diags.
0x36/54Fail to get result file.0x7B/123Fail to get result file.
0x37/55Diagnostics time-out.0x12/18Time-out.
0x80/128Failed to run the command.0x01/1Generic failure.
0x81/129The FoD key file is not valid.0x7D/125The FoD key file is not valid.
0x82/130Specified machine type or serial number is not valid.0x7C/124Specified machine type or serial number is not valid.
0x83/131The FoD key file is not found.0x7B/123The FoD key file is not found.
0x84/132Authentication failed.0x0C/12Authentication failed.
0x85/133The FoD key is not found from target key repository.0x7A/122The FoD key is not found from target key repository.
0x86/134The FoD key ID is not valid.0x79/121The FoD key ID is not valid.
0x87/135Active key exists in KMS Web site.0x78/120Active key exists in KMS Web site.
0x88/136Authentication code does not exist.0x77/119Authentication code does not exist.
0x89/137Unique identifier is not valid.0x76/118Unique identifier is not valid.
0x8A/138Failed to install the FoD key.0x75/117Failed to Install the FoD key.
0x8B/139Failed to uninstall the FoD key.0x74/116Failed to export the FoD key.
0x8C/140Failed to export the FoD key.0x73/115Fail to export the FoD key.
0x8D/141Failed to report the FoD key.0x72/114Failed to report the FoD key.
0x8E/142Failed to get current tier.0x71/113Failed to get current tier.
0xA0/160MODULEMANAGER_ERRORDeprecated
0xA1/161MODULEMANAGER_NO_NEWER_UPDATEDeprecated
0xA2/162MODULEMANAGER_XML_PARSE_ERRORDeprecated
0xA3/163MODULEMANAGER_DOWNLOAD_ERRORDeprecated
0xA4/164MODULEMANAGER_INCOMPATIBLE_ERRORDeprecated
0xA5/165MODULEMANAGER_COPY_ERRORDeprecated
0xDD/221Switch does not support EHCM or the CMM build is not supported to check EHCM.0x76/118Switch does not support EHCM or the CMM build is not supported to check EHCM.
0xDE/222Check EHCM time-out because the EHCMState is busy or setting up.0x12/18Time-out.
0xDF/223Reseat failed.0x01/1Generic failure.