Transitioning from Toolscenter to Xclarity Essentials

Transitioning from ToolsCenter to XClarity Essentials

Why Transition While Lenovo is committed to innovate and deliver the best software tools for managing our new generation of servers, we’re also making an effort to maintain backward compatibility with previous generations of servers and software to protect your existing assets.

Lenovo XClarity Essentials toolset provides the latest and greatest capabilities for managing Lenovo ThinkSystem, System x and ThinkServer. XClarity Essentials was built on the Lenovo ToolsCenter foundation and will replace it going forward.

Backward compatibility is maintained in two ways:

1. All XClarity Essentials tools and commands support the new ThinkSystem and Lenovo System x from the M4/M5 and X5/X6 generations, and have partial support for ThinkServer also. 2. Customers using Lenovo ToolsCenter tools or IBM ToolsCenter tools can migrate to XClarity Essentials commands with very small effort. This is the focus of this document.

If you have existing automation assets that you want to preserve and refresh to XClarity Essentials command syntax to support your existing servers and the new ones, please read on. XClarity Essentials toolset is also updated to access the latest Lenovo infrastructure such as acquiring firmware updates and linking to online documentation.

The existing ToolsCenter will remain available to IBM brand systems. The existing ToolsCenter will continue to direct you to resources on the IBM infrastructure. If you prefer to keep your existing assets intact then you are not obligated to migrate. You can simply use XClarity Essentials to manage your Lenovo servers.

Tools Support List after Transition

Systems Tools Support

Lenovo Inventory • OneCLI ThinkSystem; • UpdateXpress Lenovo System Update x & • Bootable Media Creator (BoMC) ThinkServer Configuration (See page 3 for list.) Deployment • System x: Server Guide/ Server Guide Linux Toolkit/Server Guide Window Toolkit v10.x

• ThinkSystem: XClarity Provisioning Manager

IBM System x Inventory Online DSA The XClarity Essentials OneCLI can v10.x also be used to control embedded (See page 4 DSA/ASU/UXSPi functions, acting as a for list.) Update UXSPi v10.x uniform interface for both Lenovo and IBM system. (See Case 3 on page 5 for more information.) Configuration ASU v10.x

Deployment • Server Guide/ Server Guide Linux Toolkit/Server Guide Window Toolkit v10.x

• XClarity Essentials BoMC v10.x or above

Note:

The latest versions of the above tools are on the XClarity Essentials Support website.

US Government customers must use IBM ToolsCenter Tools v9.6x (DSA/ASU/UXSPi/BoMC/SG/SGLTK/SGWTK) on IBM support website

How to smoothly migrate to XClarity Essentials OneCLI Case 1: If you are using ToolsCenter 1.x tools (DSA, ASU, UXSPi) to manage your Lenovo Brand Systems  Step 1: Download the XClarity Essentials OneCLI binary (.zip for Windows / .tgz for Linux) and extract it to your local file system (recommended location: “/opt/onecli/”).

 Step 2: Locate and run the commands for the functions you need to perform. See the XClarity Essentials OneCLI User Guide for detailed instructions. Note: The new OneCLI commands and parameters are clearer and more straightforward. See pages 4-5 for an overview.

Case 2: If you are already using ToolsCenter 1.x tools commands in a batch file or shell script  Step 1: Backup the ToolsCenter 1.x tools binary folder contents, retaining the empty folder structure.  Step 2: Download the XClarity Essentials OneCLI binary (.zip for Windows / .tgz for Linux ) and extract it to the same folders where the ToolsCenter 1.x tools were stored.  Step 3: Edit your scripts to substitute the old tool names. For example, in a Windows system: o If you were using “lnvgy_utl_uxspi_10.2_winsrvr_32-64.exe,” replace it with “uxspi.exe” o If you were using “asu64.exe,” replace it with “asu.exe” o If you were using “lnvgy_utl_dsa_dsala5q-10.1_portable_windows_x86- 64.exe,” replace it with “dsa.exe”  Step 4: Run the updated scripts to confirm correct function.

Note: XClarity Essentials OneCLI has proxy tools that can accept the same commands and parameters as ToolsCenter Suite CLI v1.x, using them to invoke an OneCLI executable file. This means that you need to modify only the file names in your scripts. For more information, see Chapter 8, “ASU, DSA, and UXSPI proxy tools,” of the XClarity Essentials OneCLI User Guide. Case 3: If you want to manage both Lenovo and IBM branded systems and already have ToolsCenter Suite CLI 1.x tools installed in these systems  Step 1: Download the XClarity Essentials OneCLI binary (.zip for Windows / .tgz for Linux ) and extract it to your local file system (recommended location: “/opt/onecli/”).  Step 2: If you are managing a Lenovo system, follow the steps in Case 1.  Step 3: If you are managing an IBM system, add the existing ToolsCenter 1.x tools path and names to the OneCLI Global Config file. This will cause OneCLI to automatically invoke the ToolsCenter 1.x tools when it detects an IBM system. For detailed instructions, see Chapter 3, “Support IBM System,” in the XClarity Essentials OneCLI User Guide.  Step 4: Set a value of “ACQUIRE_REPOSITORY=BOTH” in the OneCLI Global Config file so that OneCLI will connect to both IBM and Lenovo websites to obtain the latest update packages.

Note: Following this process allows use of a uniform XClarity Essentials OneCLI interface to manage both Lenovo and IBM systems using batch files.

System Support List Below lists are updated in Aug. 2017. The up-to-date list should refer to XClarity Essentials Support Website.

Lenovo ThinkSystem

Lenovo ThinkSystem ST550 Server (7X09, 7X10) Lenovo ThinkSystem SR630 Server (7X01, 7X02) Lenovo ThinkSystem SR650 Server (7X05, 7X06) Lenovo ThinkSystem SN850 Server (7X15) Lenovo ThinkSystem SN550 Server (7X16) Lenovo ThinkSystem SR530 Server (7X07, 7X08) Lenovo ThinkSystem SR550 Server (7X03, 7X04) Lenovo ThinkSystem SR850 Server (7X18, 7X19) Lenovo ThinkSystem SR950 Server (7X12, 7X11, 7X13)

Lenovo System x & ThinksServer

System x ThinkServer Lenovo Flex System x240 M4 Compute Node (7162, 2588) ThinkServer RD340 Lenovo Flex System x240 M5 Compute Node (9532, 2591) ThinkServer RD350 Lenovo Flex System x440 Compute Node (7167, 2590) ThinkServer RD440 Lenovo Flex System x280 X6 Compute Node (7196, 4258) ThinkServer RD450 Lenovo Flex System x480 X6 Compute Node (7196, 4258) ThinkServer RD540 Lenovo Flex System x880 X6 Compute Node (7196, 4258) ThinkServer RD550 Lenovo NeXtScale nx360 M5 DWC (5467) ThinkServer RD640 Lenovo NeXtScale nx360 M5 (5465) ThinkServer RD650 Lenovo System x3250 M6 (3633,3943) ThinkServer RQ750 Lenovo System x3500 M5 (5464) ThinkServer RS140 Lenovo System x3550 M5 (5463, 8869, 8693) ThinkServer RS160 Lenovo System x3650 M5 (5462, 8871, 8695) ThinkServer SD350 Lenovo System x3750 M4 (8753) ThinkServer TD340 Lenovo System x3850 X6 (6241) ThinkServer TD350 Lenovo System x3950 X6 (6241) ThinkServer TS140 Lenovo Converged HX Series (8693) ThinkServer TS150 ThinkServer TS440 ThinkServer TS450 ThinkServer TS460 Note Only the XClarity Essentials OneCLI provides inventory function support for ThinkServer systems.

IBM System x

IBM BladeCenter HS22 (7870, 1936, 7809, 1911) IBM BladeCenter HS22V (7871, 1949) IBM BladeCenter HS23 (7875, 1929) IBM BladeCenter HS23E (8038, 8039) IBM BladeCenter HX5 (7872, 1909 1910, 7873) IBM Flex System x220 Compute Node (7906, 2585) IBM Flex System x222 Compute Node (7916) IBM Flex System x240 Compute Node (8737, 8738, 7863) IBM Flex System x280 X6 Compute Node (4259, 7903) IBM Flex System x480 X6 Compute Node (4259, 7903) IBM Flex System x880 X6 Compute Node (4259, 7903) IBM NeXtScale nx360 M4 (5455) IBM System x iDataPlex dx360 M2 server (7321, 6380, 7323) IBM System x iDataPlex dx360 M3 (6391) IBM System x iDataPlex dx360 M4 (7912, 7913) IBM System x3100 M4 (2582) IBM System x3100 M5 (5457) IBM System x3200 M3 (7327, 7328) IBM System x3250 M3 (4251, 4252, 4261) IBM System x3250 M4 (2583) IBM System x3250 M5 (5458) IBM System x3300 M4 (7382) IBM System x3400 M2 (7836, 7837) IBM System x3400 M3 (7378, 7379) IBM System x3500 M2 (7839) IBM System x3500 M3 (7380) IBM System x3500 M4 (7383) IBM System x3530 M4 (7160) IBM System x3550 M2 (7946, 4198) IBM System x3550 M3 (7944, 4254) IBM System x3550 M4 (7914) IBM System x3620 M3 (7376) IBM System x3630 M3 (7377) IBM System x3630 M4 (7158) IBM System x3650 M2 (7947, 4199) IBM System x3650 M3 (7945, 4255, 5454) IBM System x3650 M4 (7915) IBM System x3650 M4 BD (5466) IBM System x3650 M4 HD (5460) IBM System x3690 X5 (7147, 7192, 7148, 7149) IBM System x3750 M4 (8722, 8733, 8752, 8718) IBM System x3755 M3 (7164) IBM System x3850 X5 (7145, 7146, 7143, 7191) IBM System x3850 X6 (3837, 3839) IBM System x3950 X5 (7145, 7146, 7143, 7191) IBM System x3950 X6 (3837, 3839)

Appendix: ToolsCenter 1.x to XClarity Essentials Tools Migration Guide  General

OneCLI General Syntax

./OneCLI verb modifier variable

Where verb is: config / inventory / update

System Configuration / FOD System Inventory System Updates Management Old Tool = DSA Old Tool = UXSPi Old Tool = ASU ONECLI verb = inventory ONECLI verb = update ONECLI verb = config New syntax: New syntax: ./OneCLI inventory modifier New syntax = ./OneCLI config modifier Where modifier is: ./OneCLI update modifier Where modifier is: getinfor Where modifier is: show getdevices acquire set formatlog query save upload scan batch compare restore flash showvalues loaddefaults comparedefault createuuid delete deletecert export generate import loaddefault nodes replicate showdefault showdes showgroups

 System Config Function

General Syntax ./OneCLI config modifier variable_value

MODIFIER FUNCTION VARIABLE_VALUE show Display system variables. all / UEFI / IMM / group set Set system variable values. batch Run multiple commands in batch format. --file save Save the current system BIOS state (can be used to template --file a system configuration). restore Restore a saved system BIOS state. --file showvalues Show supported variable values. all / UEFI / IMM / group loaddefaults Reset defaults. all / UEFI / IMM comparedefault Compare current values to default values for one or more all / UEFI / IMM / setting group createuuid Generate and set the Universally Unique Identifier delete Delete an instance of a setting deletecert Delete a certificate on IMM

export Export a selected certificate or certificate sign request file --file generate Generate a private key and public key --file import Import a certificate into IMM --file loaddefault Load default values for one or more settings nodes Detect the available notes in current system replicate Replicate all settings in the input update configuration file --file showdefault Show the default value for one or more settings showdes View help for one or more settings showgroups List the setting groups that are available on the server

 System Inventory Function

General Syntax ./OneCLI inventory modifier variable_value

MODIFIER FUNCTION VARIABLE_VALUE getinfor Obtain a diagnostic report (in-band or out-of-band). --ffdc getdevices Show devices that can be inventoried. formatlog Format the inventory log in human-readable format. --srcdata upload Upload diagnostic logs to Lenovo support.

 System Update Function

General Syntax ./OneCLI update modifier variable_value

MODIFIER FUNCTION VARIABLE_VALUE acquire Obtain firmware updates --mt –ostype (win2008/win2012/win2012r2/win2016// and device driver updates rhel5/rhe6/rhel7/sles10/sles11/sles12/esxi5.0/esxi5.5/es for a set of machine types, xi6.0/none) –scope (latest / uxps/individual) –type (fw / models, and operating dd) systems to create a device driver and firmware repository. query Query the firmware --mt –ostype (win2008/win2012/win2012r2/win2016// repository. rhel5/rhe6/rhel7/sles10/sles11/sles12/esxi5.0/esxi5.5/es xi6.0/none) –scope (latest / uxps/individual) –type (fw / dd) scan Scan a target system to determine its device driver and firmware levels. compare Compare targeted system device drivers and firmware to repository data. flash Update system device drivers and firmware.