Skip to main content

system node image get

Contributors
Suggest changes

Fetch a file from a URL

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

Description

This command fetches a file from the specified URL and stores it in the /mroot/etc/software directory.

Parameters

[-node {<nodename>|local}] - Node (privilege: advanced)

This parameter specifies the node that fetches and stores the package.

-package <text> - Package URL (privilege: advanced)

This parameter specifies the URL that provides the location of the package to be fetched. Standard URL schemes, including HTTP, HTTPS, FTP and FILE, are accepted. 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 image.tgz . The package must be present in the root directory of the USB mass storage device. 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".

[-replace-package <true>] - Replace the Local File (privilege: advanced)

Specifies whether an existing package is deleted and replaced with a new package. If you enter this command without using this parameter, its effective value is false and an existing package is not replaced with the new one. If you enter this parameter without a value, it is set to true and an existing package is replaced with the new one.

[-rename-package <text>] - Rename the File (privilege: advanced)

Use this parameter to enter a package name that is different than the file name in the URL.

[-background <true>] - Run in the background (privilege: advanced)

This parameter allows the operation to run in the background. The progress of the operation can be checked with the command system image show-update-progress. If this command is entered without using this parameter, its effective value is false and the operation runs in the foreground. If this parameter is used without a value, it is set to true.

Examples

system image get http://example.com/image.tgz -rename-package image2.tgz -replace-package