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.
For Out-of-Band (OOB) mode, scan results include only System x firmware (IMM, UEFI, and DSA) and option firmware.
For In-Band (IB) mode, both System x firmware and device drivers and firmware for installed options.
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>]
| 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
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