Description

Lenovo XClarity Essentials OneCLI (OneCLI) is a command-line utility that is ideal for a non-GUI environment. It not only provides users with a command-line interface to the same functions available with UpdateXpress, but it also enables the scripting of updates. This utility is used to apply firmware or driver updates within the operating system for a target server.

This article introduces the procedures used to run OneCLI to remotely acquire and install firmware drivers on your system.

Applicable Systems

Configuration Applications

Lenovo XClarity Essentials OneCLI (OneCLI)

Operating Systems

Windows, Linux

Prerequisites

• An SFTP server is required, and you must ensure that port 6990 is enabled for SFTP/SSH
• A OneCLI-supported operation system version must be installed on an Internet-connected workstation/laptop
• OneCLI must be installed on the workstation/laptop
• The workstation/laptop must have direct network access to XCC on the target server
• Users must have the access to run OneCLI with administrator or root privileges

Procedures

1. Go to https://support.lenovo.com/solutions/lnvo-tcli, find the appropriate OS section, and download the requested ZIP or TGZ file.

2. Unzip the file and copy the contents to a specified folder.

For Windows:

Unzip and copy the contents to a specified folder.

For Linux:

1. Open Terminal and ensure the user has root privileges.
2. Use the tar command to unzip the file

tar xvf "Zipfile.tgz" -C /path/foldername

Where Zipfile.tgz is the downloaded file, and -C is the path and folder where the files will be extracted.

3. Follow the procedures set out below to launch OneCLI.

For Windows:

1. Open a command prompt window with administrator privileges.
2. Go to the directory where you saved the utility – e.g. C:\onecli.

For Linux:

Go to the directory where you saved the utility – e.g. /root/Desktop/onecli.

4. Acquire the update files for a specific server using the following command:

onecli update acquire --mt XXXX --ostype YYYYY --scope option --dir C:\Test

where:

• XXXX is the four-digit machine type of the target server – e.g. 7x04, 7x18.
• YYYYY is the OS installed on the server if you intend to download drivers on the server as well. Possible inputs are win2012, win2012r2, win2016, win2019, rhel6, rhel7, sles11, sles12, and none (OS independent).
• option is whether you want to download the latest package or use UpdateXpress packages. The input options are latest or uxsp. It is recommended that you use latest.
• C:\Test is the directory you want to download the files into.

Example:

onecli update acquire --mt 7x02 --ostype none –scope latest --dir C:\Test\7x02

5. (Optional) Use the following commands to compare the list of installed firmware and device drivers with the firmware and drivers in the downloaded package:

onecli update compare --scope option --type PP --dir C:\Test --bmc USERID:PASSWORD@BMCIPAddress --output c:\compare\XML

where:

• PP is the type of comparison you want to make. The input options are:
• fw, dd (default) to compare firmware and device drivers
• fw to compare firmware
• dd to compare device drives
• --output is to download the logs or comparison XML in the directory. If you encounter failure, this will help you to identify the causes. It will also help you compare updates quickly.
• USERID:PASSWORD@BMCIPAddress is the XCC access information on the target server

Example:

onecli update compare --scope latest --type fw –bmc USERID:PASSW0RD@10.10.10.10 --dir C:\Test\7x02 --output c:\Test\compare

6. Apply all the firmware and driver updates using the following command:

Onecli update flash --scope option --bmc USERID:PASSWORD@BMCIPAddress --sftp USERID:PASSWORD@SFTPIPAddress:6990 --dir C:\Test,

where USERID:PASSWORD@SFTPIPAddress:6990 is the SFTP access information

7. To update a single piece of firmware or driver level, use one of the following commands:

• To update a single piece of firmware without performing a comparison

Onecli update flash lnvgy_fw_imm2_tcoo26k-3.73_anyos_noarch --nocompare --includeid lnvgy_fw_imm2_tcoo26k-3.73_anyos_noarch --bmc USERID:PASSWORD@BMCIPAddress --sftp USERID:PASSWORD@SFTPIPAddress:6990 --dir C:\Test --output c:\logs

# --includeid is required when --nocompare is specified.

• Specify the update scope --scope to individual with the --includeid parameter to update an individual device

Onecli update flash --scope individual --includeid lnvgy_fw_imm2_tcoo26k-3.73_anyos_noarch --bmc USERID:PASSWORD@BMCIPAddress --sftp USERID:PASSWORD@SFTPIPAddress:6990 --dir C:\Test --output c:\logs

Table. 1 OneCLI global parameters

Video

Additional Information

• Lenovo XClarity Essentials OneCLI User Guide
• How to back up and restore the XClarity Controller configuration using the Lenovo XClarity Essentials Windows OneCLI

Related Articles

• Lenovo ThinkSystem firmware update page
• Lenovo ThinkAgile Series system firmware update page