How to back up and restore the XClarity Controller configuration using the Lenovo XClarity Essentials Linux OneCLI

Description

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

Applicable Systems

ThinkSystem, ThinkServer

Limitations

OneCLI may 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, 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.

Procedure

Download the OneCLI utility from the following link: https://datacentersupport.lenovo.com/documents/LNVO-TCLI
Scroll down to find the appropriate Linux section.

onecli

Download and copy the TGZ file to a directory on the hard drive.
Unzip and extract the OneCLI utility using the below command:

tar zxvf FILENAME.tgz -C directory, where FILENAME is the downloaded TGZ file, and -C  is the folder where all the files will be extracted. Please ensure sure that the target folder already exists, or you will need to create it.

Once complete, navigate to where the utility was extracted. Please ensure that users have root privileges to run the LXCE OneCLI commands. OneCLI will not check for the correct permission while running, but some functions may not work correctly if the user does not have root privileges.
Enter the config --help command to show the available config application commands.

./OneCli config --help

confighelp

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

table

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.

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

./OneCli config showgroups

showgroups

Use the show command and IMM group class to view the XCC(BMC) settings.

./OneCli config show IMM

IMM

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

To retrieve the XCC configuration from the host server:

./OneCli config IMM save --file directory

The file will be saved to the utility folder if the directory is not specified.

savelocal

To retrieve the XCC configuration from the remote server:

./OneCli config IMM save --file directory connection_options

The file will be saved to the utility folder if the directory is not specified.

saveremote

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

./OneCli config restore --file directory

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

restore

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

./OneCli config replicate --file directory connection_options

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

replicate

Video

Document ID:HT507950

Data publicării inițiale:02/28/2019

Data ultimei modificări:09/30/2024