Lenovo XClarity Essentials OneCLI - Applications for Server Configuration and Management
Explore Lenovo XClarity Essentials OneCLI: Versatile Command-Line Applications for Server Configuration & Management
Explore Lenovo XClarity Essentials OneCLI: Versatile Command-Line Applications for Server Configuration & Management
Overview
Lenovo XClarity Essentials OneCLI is a collection of several command-line applications, which can be used to configure the server, collect service data for the server, update firmware and device drivers, and perform power-management functions on the server. Lenovo XClarity Essentials OneCLI (OneCLI) is comprised of individual ToolsCenter application modules that are easily updated. Starting from 1.2.0, Lenovo XClarity Essentials OneCLI (OneCLI) also support inventory on some ThinkServer systems.
IMPORTANTNew setting names on ThinkSystem V4 platform Due to ThinkSystem V4 platform adopting OpenBMC and aiming for full Redfish alignment, the format of UEFI and BMC settings have changed. User must use XClarity Essentials OneCLI 5.x to read and configure UEFI and BMC settings. This is applicable to all ThinkSystem V4 servers with Intel and AMD processors with XCC3. The command parameter is same as previous version of OneCLI, but the setting names have changed to reflect new Redfish style and to get rid of legacy IMM.xyz style. For example:
If the user need to run one batch configuration command against servers of multiple generations, there is a “-c” feature for backward compatibility so that user can retain the existing configuration file across servers.
|
Applicable Systems
Supported Lenovo Systems
- ThinkEdge
- ThinkSystem
- ThinkServer
- WenTian(问天)
- Legacy ThinkServer (inventory function only)
- System x
Supported Lenovo Storage (Secure erasure function only)
- Storage
What's New
Version 5.1.0
- Add compatibility mode for BMC settings on the ThinkSystem V4 servers
- Deploy OS on the ThinkSystem V4 servers
- Rollback user selected firmware bundle on the ThinkSystem V4 servers
- Terminate the update task during the update process
- Support local SED key management for direct attached NVMe drives
- Add configuration, inventory and update functions for CXL memory
- Enhance secure erasure function with a template
- Add UEFI extra settings exposed to OneCLI
- Configure midplane VPD settings on ThinkSystem D3 Chassis
- Add NOLOG item to prevent logs generation in global configuration file
- Configure Active Directory on the WenTian servers
- Lenovo ThinkSystem HD350X V4 7DK3
- Lenovo ThinkSystem HD350M V3 7DK4
- Lenovo ThinkSystem HS350X V3 7DBM
- Lenovo WenTian WA5480 G5/WA5488 G5 7DHQ
- Lenovo WenTian WR5220 G5/WR5228 G5 7DFX
- Red Hat Enterprise Linux 9.5
For more information about each version, click What's new and look for the desired version you're searching for.
Download OneCLI
Version 5.1.0 Binaries
| Microsoft Windows | |
|---|---|
|
|
| Linux | |
|
|
|
User Guide |
|
| Lenovo XClarity Essentials OneCLI User Guide | |
| Lenovo XClarity Essentials OneCLI User Guide for ThinkServer | |
Older Versions
Version 4.4.1 Binaries
|
|
|||
|---|---|---|---|
| Microsoft Windows | |||
|
|||
| Linux | |||
|
lnvgy_utl_lxce_onecli02a-4.4.1_linux_x86-64 |
|
||
| OneCLI 4.4.1 open source software license | |||
| OneCLI 4.4.1 Windows opensource code | OneCLI 4.4.1 Windows ThirdPartyNotice | ||
| OneCLI 4.4.1 Linux opensource code |
OneCLI 4.4.1 Linux ThirdPartyNotice
|
||
Version 4.4.0 Binaries
|
|
|||
|---|---|---|---|
| Microsoft Windows | |||
|
lnvgy_utl_lxce_onecli01t-4.4.0_winsrv_x86-64 lnvgy_utl_lxceb_onecli01t-4.4.0_winsrv_x86-64 (executable) |
|
||
| Linux | |||
|
lnvgy_utl_lxce_onecli01t-4.4.0_linux_x86-64 lnvgy_utl_lxceb_onecli01t-4.4.0_linux_x86-64 (executable) |
|
||
| OneCLI 4.4.0 open source software license | |||
| OneCLI 4.4.0 Windows opensource code | OneCLI 4.4.0 Windows ThirdPartyNotice | ||
| OneCLI 4.4.0 Linux opensource code |
OneCLI 4.4.0 Linux ThirdPartyNotice
|
||
Version 4.1.0 Binaries
|
Lenovo XClarity Essentials OneCLI Version 4.1.0 02c Lenovo XClarity Essentials OneCLI Version 4.1.0 02g (Hotfix for ThinkSystem SR850 V3 and SR860 V3 only) |
|
|---|---|
| Microsoft Windows | |
|
lnvgy_utl_lxce_onecli02c-4.1.0_winsrv_x86-64 lnvgy_utl_lxceb_onecli02c-4.1.0_winsrv_x86-64 (executable) Hotfix for ThinkSystem SR850 V3 and SR860 V3 only lnvgy_utl_lxce_onecli02g-4.1.0_winsrv_x86-64 lnvgy_utl_lxceb_onecli02g-4.1.0_winsrv_x86-64 (executable) |
|
| Linux | |
|
lnvgy_utl_lxce_onecli02c-4.1.0_linux_x86-64 lnvgy_utl_lxceb_onecli02c-4.1.0_linux_x86-64 (executable) Hotfix for ThinkSystem SR850 V3 and SR860 V3 only |
|
|
OneCLI 4.1.0 open source software license |
|
| OneCLI 4.1.0 Windows opensource code | OneCLI 4.1.0 Windows ThirdPartyNotice |
| OneCLI 4.1.0 Linux opensource code | |
Version 4.0.1 Binaries
| Lenovo XClarity Essentials OneCLI Version 4.0.1 | |
|---|---|
| Microsoft Windows | |
|
lnvgy_utl_lxce_onecli01w-4.0.1_winsrv_x86-64 lnvgy_utl_lxceb_onecli01w-4.0.1_winsrv_x86-64 (executable) |
|
| SUSE Linux Enterprise Server Edition | |
|
lnvgy_utl_lxce_onecli01w-4.0.1_sles_x86-64 lnvgy_utl_lxceb_onecli01w-4.0.1_sles_x86-64 (executable) |
|
| Red Hat Enterprise Linux Edition | |
|
lnvgy_utl_lxce_onecli01w-4.0.1_rhel_x86-64 lnvgy_utl_lxceb_onecli01w-4.0.1_rhel_x86-64 (executable) |
|
| OneCLI 4.0.1 open source software license | |
| OneCLI 4.0.1 Windows opensource code | OneCLI 4.0.1 Windows ThirdPartyNotice |
| OneCLI 4.0.1 Linux opensource code | |
Version 3.4.0 Binaries for RHEL 6 and SLES 11 (the last supported OneCLI version)
| Lenovo XClarity Essentials OneCLI Version 3.4.0 | |
|---|---|
| SUSE Linux Enterprise Server 11 Edition | |
|
lnvgy_utl_lxce_onecli01u-3.4.0_sles_x86-64 lnvgy_utl_lxceb_onecli01u-3.4.0_sles_x86-64 (executable) |
|
| Red Hat Enterprise Linux 5 Edition | |
|
|
Version 2.7.0 Binaries for RHEL 5 and SLES 10 (the last supported OneCLI version)
| Lenovo XClarity Essentials OneCLI Version 2.7.0 | |
|---|---|
| SUSE Linux Enterprise Server 10 Edition | |
|
|
| Red Hat Enterprise Linux 5 Edition | |
|
|
Note: The Digital Certificate Authority on Lenovo's download service will be upgraded on September 21, 2018. After that date, you must use the latest version of OneCLI (Version 2.3.0, or newer) to acquire updates successfully. If you cannot switch to the x64 version, please follow the guide to update the certificate manually.
In OneCLI 2.4.0 (released on 10/26/2018), to better serve the purpose of scripting and automation, program exit/return code (IMPORTANT: this is the CLI code you typically get by running the command "echo%errorlevel%" for Windows and "echo $?" for Linux) has been refined. If you use OneCLI version 2.3.0 and before, when moving to 2.4.0, you may upgrade your scripting solution. Please click here for detailed information.
Related Articles
Downloading and installing OneCLI
- How to download Lenovo XClarity Essentials OneCLI
- How to install Lenovo XClarity Essentials OneCLI on Windows
- How to install Lenovo XClarity Essentials OneCLI on Linux
Collecting inventory and service data
- How to use the Lenovo XClarity Essentials Linux 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 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 read OneCLI HTML report
System configuration settings
- How to back up and restore the XClarity Controller configuration using the Lenovo XClarity Essentials Linux OneCLI
- How to back up and restore the XClarity Controller configuration using the Lenovo XClarity Essentials Windows OneCLI
- How to set or change the UEFI Admin password using Lenovo XClarity Essentials Windows OneCLI
- How to set or change the UEFI Power On password using Lenovo XClarity Essentials Windows OneCLI
- How to set recommended UEFI settings for Lenovo ThinkAgile HX systems using Lenovo XClarity Essentials OneCLI
- How to set recommended UEFI settings for Lenovo ThinkAgile HX systems using LXCE Windows OneCLI batch feature
- How to update VPD using OneCLI
Performing updates
- How to use Lenovo XClarity Essentials OneCLI to locally update your system
- How to use Lenovo XClarity Essentials OneCLI to remotely update your system
Diagnostics
Miscellaneous
- How to use the Linux OneCLI to clear UEFI logs on a remote server
- How to use the Windows OneCLI to clear UEFI logs on a remote server
- How to use the Lenovo XClarity Essentials OneCLI serase command to securely erase hard disk drive data
- How to use OneCLI to collect failed OS screens and health reports
- How to use OneCLI syshealth command to query the system health status
- How to enable the D2 System Management Module Management Access using Windows OneCLI
Additional Information
Other LXCE Offerings
