acquire command

Use the acquire command to download firmware and device driver updates for BMC-based system, CMM-based component, and SMM-based component from Lenovo or IBM support site.

acquire command syntax

OneCli.exe update acquire [--mt <arg>] [--ostype|-t <arg>] [--scope|-s <arg>] [--dir <arg>] [--includeid|-I <arg>] 
[--report] [--metaonly] [--proxy|-P <arg>] [--type|-T <arg>] [--xml] [--quiet|-q] [--platform] [--output|-o <arg>] 
[--nolog] [--config <arg>] [--proxy-cacert <arg>] [--cacert <arg>] [--proxy-insecure] [--insecure] [--help|-h]

Table 1. acquire command specific parameters
Parameter	Required/Optional	Notes
--comparexml	Optional	Specify the file name for the packages to be downloaded based on the compare result.
--dir	Optional	Specify the path name of the directory that will be used by the command. If no "--dir", the current directory will be used.
--includeid, -I	Optional	Acquire the specified included packages or UXSP through IDs. Usually an ID is the package file name without extension. For example: Target package ID: lnvgy_dd_sraidmr_7.700.20.00_sles12_indiv UXSP ID: lnvgy_utl_uxsp_tcsp06p-2.40_win2012r2_32-64 It is allowed to input multiple packages IDs using a comma-separated list. By default: none is included.
--metaonly	Optional	If the --metaonly parameter is specified, the acquire command will only download the XML files specifying the metadata for the update packages without downloading the update packages payload.
--mt	Optional	Specify the machine type of target device. Lenovo server, chassis, and enclosure all have machine types.
--noprereq	Optional	If specified, users should not download the prerequisite packages.
--ostype, -t	Optional	Specify the OS deployed on the target servers. Valid choices are win2008, win2012, win2012r2, win2016, rhel5, rhel6, rhel7, rhel8, rhel9, sles10, sles11, sles12, sles15, esxi5.0, esxi5.1, esxi5.5, esxi6.0, esxi6.5, platform, and none. "none" is the default setting and is used for OS independent updates, such as UEFI or BMC updates. When the ostype parameter is “platform”, OneCLI will acquire all packages required in update, including Maintenance OS, OneCLI, and platform UXSP. The --ostype parameter is not required for CMM, SMM, or I/O module targets.
--platform	Optional	Download the maintenance image and OneCLI tool for BMU secure erase and platform flash.
--proxy, -P	Optional	userid:password@host[:port] specifies the proxy information for connecting to the Lenovo Support Web site to download update packages or information. 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. Users can find the service processor or the SFTP server (for the --sftp argument) through this name on the local network of the OS that the OneCLI runs.
--report	Optional	If the --report parameter is specified, the acquire command will only output the IDs of the packages to update without downloading the packages or their metadata.
--scope, -s	Optional	Specify the scope of updates. Different scopes indicate different operation strategies. Valid choices are: uxsp (default choice): Suggest acquiring UXSP for the specific MT and ostype. latest: Suggest acquiring the latest packages or UXSP. individual: Suggest acquiring the specific packages or UXSP. In this case, the --scope (-s) parameter should be used with the --includeid parameter.
--type, -T	Optional	type specifies the type of package to download. Valid choices are: fw\|dd (default) to download firmware and device drivers fw to download firmware dd to download device drivers For the CMM and I/O module targets, only firmware can be downloaded.
--xml	Optional	Specify the output XML.
--proxy-cacert	Optional	Specify the path of proxy CACert.
--cacert	Optional	Specify the path of CACert.
--proxy-insecure	Optional	Do HTTPS proxy connections without verifying the proxy
--insecure	Optional	Allow insecure server connections when using SSL.
--config --configfile --help,-h --nolog --output, -o	Optional	Refer to Table 2.

Example of the acquire command

In this example, we are downloading (update acquire command) information (--metaonly argument) about the latest updates (--scope latest argument) for a machine type 8737 (--mt 8737 argument), storing it in the “pkg” directory (--dir .\pkg argument) and storing the log file in the “output” directory (--output .\output argument).

Onecli.exe update acquire --scope latest --mt 8737 --metaonly --output .\output --dir .\pkg

Network requirement of the acquire command

OneCLI supports to acquire the updates for the IBM system and the Lenovo system.

To acquire the updates for the IBM system from the IBM Web site, ensure that the firewall allows the following DNSes and ports. User can also obtain the URL from https://www-03.ibm.com/services/projects/ecc/serviceProviderIBM.gzip.
DNS IP address Port Protocol
www.ibm.com / / /
www-03.ibm.com 204.146.30.17 443 and 80 HTTP and HTTPS
eccgw01.boulder.ibm.com 207.25.252.197 443 HTTPS
To acquire the updates for the Lenovo system from the Lenovo Web site, ensure that the firewall allows the following DNSes and ports. User can also obtain the URL from https://support.lenovo.com/services/ContentService/SearchDrivers.
DNS Port Protocol
support.lenovo.com 443 and 80 HTTP and HTTPS
download.lenovo.com 443 and 80 HTTPS

DNS	IP address	Port	Protocol
www.ibm.com	/	/	/
www-03.ibm.com	204.146.30.17	443 and 80	HTTP and HTTPS
eccgw01.boulder.ibm.com	207.25.252.197	443	HTTPS

DNS	Port	Protocol
support.lenovo.com	443 and 80	HTTP and HTTPS
download.lenovo.com	443 and 80	HTTPS

Note

To use a proxy to run the acquire command, ensure that the proxy meets the following requirements:

The proxy is accessible to one of the following DNS: www.ibm.com, www-03.ibm.com, eccgw01.boulder.ibm.com, support.lenovo.com, and download.lenovo.com.
The proxy is set to Use basic authentication.
The proxy is a non-terminating and forwarding proxy.

Give documentation feedback