How to use the Lenovo XClarity Essentials Windows OneCLI to remotely collect system inventory and FFDC
How to use the Lenovo XClarity Essentials Windows OneCLI to remotely collect system inventory and FFDC
How to use the Lenovo XClarity Essentials Windows OneCLI to remotely collect system inventory and FFDC
Description
This article will document how to use OneCLI to remotely collect system inventory and FFDC (First Failure Data Capture) inventory with a system that has Windows installed.
Applicable Systems
- Lenovo ThinkSystem
- Lenovo ThinkServer
- Lenovo System x
Requirements
- Windows installed on your local system.
- Workstation/Laptop with direct network access to the XCC/IMM/TSM on the server.
- OneCLI utility installed on the Workstation/Laptop.
Solution
Complete the following steps to download, install, and use the OneCLI utility:
- Download the OneCLI utility from the following link: https://datacentersupport.lenovo.com/us/en/documents/LNVO-TCLI
- Scroll down to find the Microsoft Windows section and download the requested zip file.
- Copy the ZPI to a directory on the local hard drive.
- Unzip the ZIP file to a specified folder, OneCli.exe and other package files will be extracted.
- Enter the OneCLI directory, run the OneCli.exe command from the command line.
Note: It is required that users have administrator privilege to run the XClarity Essentials OneCLI command. The XClarity Essentials OneCLI will not check the user privilege while running, some functions may not work correctly if the user is not administrator.
- Use administrator privileges to open a command prompt window.
(Press WIN key ==> type in CMD ==> Right-click Command Prompt app and select run as administrator)
- Navigate to the directory where you extracted the OneCli Utility.(i.e. C:\XOneCli)
- Run the following command:
onecli.exe inventory getinfor --bmc USERID:PASSW0RD@BMCIPAddress
- This command will generate four output files into the directory stated after the --output. This directory can be changed to where the user would like.
- Two of the outputs are the system inventory files (formally known as DSA on System X systems).
- The first will be in an XML formated file.
- Second will be a ZIP of the xml file.
- Either one of these two files can be used to upload to the Lenovo Upload Tool
- The third output will be a folder containing the html files that can be viewed by any web browser locally.
- The fourth is a folder containing the FFDC file which can also be used to upload to the Lenovo Upload Tool.
- For an IPv6 address, the format is user:password@[IPv6]:port.
- The directory C:\Logs is where the logs will be downloaded and saved on the local Workstation/Laptop.
- The utility may take some time to pull the complete set of logs. This time depends on how full the logs are (approx. 15 – 45 minutes).
- Collect the logs in the directory from the user specified folder.
- The OneCLI log file should have the following format:
- OneCli-inventory-devinfo-(Year+Month+Day)-(Hour+Minute+Second) .xml
- OneCli-inventory-devinfo-20181029-034305.xml
- The FFDC log file should have the following format:
- (Machine Type+Model)_(Serial)_xcc_(Year+Month+Day)-(Hour+Minute+Second).TZZ
- 7X05RCZ000_0123456789_xcc_181029-024321.TZZ
- The OneCLI log file should have the following format:
Video
Table 1. Inventory application commands
Application |
Command |
Parameter (Optional) |
Note |
inventory |
getinfor |
--esxi |
If specified, the inventory application can receive information only on the VMware ESXi operating systems. For IPv4 address, the format is user:password@IPv4:port. For IPv6 address, the format is user:password@[IPv6]: port. |
--bmc |
• If specified, the inventory application can receive information using only out-of-band mode. For IPv4 address, the format is user:password@IPv4:port. For IPv6 address, the format is user:password@[IPv6]:port. |
||
--htmlreport |
Output contains HTML format. |
||
--ffdc |
Use the miscellaneous application with the ffdc parameter to get the ffdc log. |
||
--output |
If not specified, by default, the log file output is saved to: ./Onecli-%PID %-%date%-%time%/. |
Related Articles
- How to use the Linux Lenovo XClarity Essentials OneCLI to remotely collect system inventory and FFDC
- How to use the Lenovo XClarity Essentials OneCLI to collect system inventory and FFDC from Linux servers
- How to use the Lenovo XClarity Essentials OneCLI to collect system inventory and FFDC from Windows servers
- How to use the Lenovo XClarity Essentials OneCLI to collect system inventory and FFDC from servers using VMware
- How to upload a file to Lenovo Data Center support
- How to open a support ticket for Lenovo Data Center products