scan command

Use the scan command to build a list of available firmware and device driver updates for the targeted device. The XML file that the scan command generates can then be used by the compare command.

scan command syntax

Onecli.exe update scan [--imm <userid:password@IP[:port]>] [--esxi <userid:password@IP[:port]>]
[--cmm <userid:password@IP[:port]>] [--iobay <bay_number>] [--disable-imm-lan] [--output <folder>]
Table 1. scan command parameters
Parameter Required/Optional Notes
--imm Optional

userid:password@IP[:port] specifies access information for the target IMM.

The scan command is applied to the IMM, by default. If the --imm parameter is specified, the ToolsCenter Suite CLI runs in Out-of-Band (OOB) mode; otherwise, the ToolsCenter Suite CLI runs in In-Band (IB) mode.

Note: Both IPv4 and IPv6 addresses are supported. Enclose IPv6 addresses in brackets. For example, [FE80::3BA7:94FF:FE07:CBD0]. If the IPv6 is LLA (Link Local IPV6), the format is [FE80::3BA7:94FF:FE07:CBD0%xxx]. Replace xxx with the name of the interface through which either the service processor or the sftp server (for the --sftp argument) can be reached on the local network of the OS on which the ToolsCenter Suite CLI runs.
--esxi Required (see note)

userid:password@IP[:port] specifies access information for the target VMware ESXi Lenovo image.

The --esxi parameter specifies a VMware ESXi Lenovo image scan operation. It is required when scanning a customized VMware ESXi target.

Note: Both IPv4 and IPv6 addresses are supported. Enclose IPv6 addresses in brackets. For example, [FE80::3BA7:94FF:FE07:CBD0]. If the IPv6 is LLA (Link Local IPV6), the format is [FE80::3BA7:94FF:FE07:CBD0%xxx]. Replace xxx with the name of the interface through which either the service processor or the sftp server (for the --sftp argument) can be reached on the local network of the OS on which the ToolsCenter Suite CLI runs.
--cmm Required (see note)

userid:password@IP[:port] specifies access information for the target CMM.

The --cmm parameter specifies a CMM or I/O module scan operation. It is required when scanning either of these targets. When scanning an I/O module target, the --iobay parameter must also be specified.

Note: Both IPv4 and IPv6 addresses are supported. Enclose IPv6 addresses in brackets. For example, [FE80::3BA7:94FF:FE07:CBD0]. If the IPv6 is LLA (Link Local IPV6), the format is [FE80::3BA7:94FF:FE07:CBD0%xxx]. Replace xxx with the name of the interface through which either the service processor or the sftp server (for the --sftp argument) can be reached on the local network of the OS on which the ToolsCenter Suite CLI runs.
--iobay Required (see note)

bay_number specifies the I/O module bay number. Valid values are 1, 2, 3, or 4.

The --iobay parameter specifies an I/O module scan operation. When scanning an I/O module target, the --cmm parameter must also be specified.

--disable-imm-lan Optional The --disable-imm-lan parameter is used when scanning an IMM in IB mode. If this parameter is specified, the ToolsCenter Suite CLI disables the IMM Lan-over-USB channel after the command completes.
--output Optional

folder specifies the path name location and file name for the scan report XML file.

By default, the log file output is saved to the ../Onecli-%PID%-%date%-%time%/ directory with a file name of Onecli-update-scan.xml. Existing files are overwritten. Make sure that unique file names are specified, if multiple CLI commands are being run at the same time.

Example of the scan command

In this example, we are building a list of firmware (update scan command) installed in a CMM that is accessed with a user ID of “USERID”, a password of “PASSW0RD”, and an IP address of “10.240.252.102” (--cmm USERID:PASSW0RD@10.240.252.102 argument) storing the scan report XML file (using the default file name) in the “output” directory (--output .\872102cn03e\output\ argument).
Onecli.exe update scan --cmm USERID:PASSW0RD@10.240.252.102 --output .\872102cn03e\output\

Lenovo ToolsCenterSuite CLI tcliXXX-X.X.X
Based on module version X.X.X
Licensed Materials - Property of Lenovo
(C) Copyright Lenovo Corp. 2013-2016 All Rights Reserved
Invoking SHOW command ...
Connected to IMM by IP address 10.240.252.102
Start to scan CMM device 
Finish CMM scan
Save the scan result to .\872102cn03e\output\Onecli-update-scan.xml successfully