system controller hardware-license update

Update hardware license

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The system controller hardware-license update command downloads the hardware license from a specified location and updates the license file. By default, the license will be authenticated and verified against the system serial number and model string of the controller before performing the update of the hardware license. Update won't happen if the either of the following happens: authentication fails, the system serial number doesn't match, or the model string doesn't match.

Parameters

-package <text> - Package URL
This specifies the location from which the software image is to be downloaded. The location can be specified in any of the following ways:
  • As an HTTP URL in the form http://host_name[:port]/path_to_file. For instance, http://example.com/downloads/license.json. The management utility prompts you for a user name and password before beginning the download.
    Note: If you use HTTP to transfer software images, be aware that the management utility does not check whether the Web server is password protected; if it is not, press Enter at the prompt for user name and password.
  • As an HTTPS URL in the form https://host_name[:port]/path_to_file. For instance, https://example.com/downloads/license.json.
    Note: The HTTPS URL scheme requires that you install the HTTPS server certificate on the system by using the command "security certificate install -type server-ca".
  • As an FTP URL in the form ftp://host_name[:port]/path_to_file. For instance, ftp://example.com/downloads/license.json. If required, the management utility prompts you for a user name and password before beginning the download.
  • The FILE URL scheme can be used to specify the location of the package to be fetched from an external device connected to the storage controller. Currently, only USB mass storage devices are supported. The USB device is specified as file://usb0/<filename>. Typically, the file name is license.json. The package must be present in the root directory of the USB mass storage device.

Examples

The following example downloads license file and install it into the FRU ROM
cluster1::*> system controller hardware-license update -package http://example.com/license.json