Description

This article will introduce the procedure used to view and backup the current BMC configuration with the Lenovo XClarity Essentials Windows OneCLI. The saved configuration information can be replicated to another system or used to restore the current server.

Applicable Systems

ThinkSystem, ThinkServer

Limitations

• OneCLI does not restore or replicate some settings from the saved file
• When running the OneCLI config restore and replicate command, you could encounter one or more of the following situations:
  • Some settings have been filtered to restore because their value is empty.
  • Some settings, for example, the VPD settings for the restore command, have been skipped.
  • Some settings that can’t be found on the target system have been ignored.

You might have to restart the BMC for some settings or values set through the OneCLI config application to take effect and be displayed in the BMC Web interface.

Solution

1. Download the OneCLI utility from the following link: https://datacentersupport.lenovo.com/us/en/documents/LNVO-TCLI
2. Scroll down to find the appropriate Windows section, and download the requested zip file.

3. Create a directory for the OneCLI tool.
4. Download and extract the contents of the.zip file to the new directory.
5. Open a command prompt window with administrator permission by right-clicking Command Prompt and selecting Run as administrator.

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 an administrator.

6. From the Command Prompt navigate to the directory where you extracted the OneCli Utility.(i.e. C:\XOneCli)

7. Enter the config --help command to show the available config application commands.

8. The table below lists commands to help you back up the XCC configuration.

Command Descriptions

• Show: Use this command to display the current values of specified settings.
• Showgroups: Use this command to display the names of variable classes on the system
• Save: Use this command to save specified settings to a setting file
• Restore: Use this command to restore a saved setting file to the current system
• Replicate: Use this command to replicate the save setting value on another system

Note: The only difference between the restore and replicate commands is that restore can set the noreplicate setting class.

9. Run the config showgroups command to show the available names of the group class. The XCC(BMC) setting group is IMM.

OneCli.exe config showgroups

OneCli.exe config show IMM

11. Use the following commands to backup and save the XCC configuration.

• To retrieve the XCC configuration from the host server:

OneCli.exe config IMM save --file directory

• To retrieve the XCC configuration from the remote server:

OneCli.exe config IMM save --file directory connection_options

12. Go to the directory in which you saved the configuration file, copy the file, and save it to another backup storage space.
13. Use the following command to restore the saved setting file to the current system.

OneCli.exe config restore –file directory

The utility might take some time to complete the restoration process.

14. You can also use the following command to replicate a saved setting file to the target server.

OneCli.exe config replicate –file directory connection_options

The settings in the non-replicated group are saved in a specific file and cannot be replicated.

Video

Related Articles

• OneCLI User Guide
• How to back up the XCC configuration using LXCE OneCLI on Linux
• How to set or change the UEFI Admin password using Lenovo XClarity Essentials Windows OneCLI