Please note: This website includes an accessibility system. Press Control-F11 to adjust the website to the visually impaired who are using a screen reader; Press Control-F10 to open an accessibility menu.

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:

  1. Download the OneCLI utility from the following link: https://datacentersupport.lenovo.com/us/en/documents/LNVO-TCLI
  2. Scroll down to find the Microsoft Windows section and download the requested zip file.
    onecli tool
  1. Copy the ZPI to a directory on the local hard drive.
  2. Unzip the ZIP file to a specified folder, OneCli.exe and other package files will be extracted.
  3. Enter the OneCLI directory, run the OneCli.exe command from the command line.
    local disk

    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.
  1. 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)
    cmd
  1. Navigate to the directory where you extracted the OneCli Utility.(i.e. C:\XOneCli)
    tool directory
  1. Run the following command:

onecli.exe inventory getinfor --bmc USERID:PASSW0RD@BMCIPAddress --htmlreport --ffdc --output C:\Logs

  • 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.
  1. 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).
    onecli inventory getinfor
  1. Collect the logs in the directory from the user specified folder.
    logs
    • 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

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%/.

Additional Resources

Document ID:HT507519
Original Publish Date:10/27/2018
Last Modified Date:09/06/2024