image

Required Command-Line Mode = Enable

Required User Level = Admin

Use the image command to manage software images for the GigaVUE H Series node.

The image command has the following syntax:

image
   boot <location <1 | 2> | next> 
  delete <image filename>
   fetch <download URL> [filename]
   install <image filename> [location <1 | 2>]
   move <src filename> <dst filename>
   options serve all

The following table describes the arguments for the image command:

Argument

Description

boot <location <1 | 2> | next>

Specifies which of the two available boot images to boot at the next reboot. Images are installed in one of the two available boot locations—1 or 2.

location—Specifies to boot from a specified location. The show image command provides information on the images installed in each of the two boot locations, allowing you to select the desired image.
next—Specifies to boot from the next partition after the one currently booted. This argument is handy after you have installed a new image—the image is automatically installed at the location you did not boot last, so booting from the next location will use the image you just installed.

delete <image filename>

Deletes the specified image file. Type image delete ? to see a list of image filenames available for deletion. You cannot delete the currently active image file.

fetch <download URL> [filename]

Retrieves the specified image file from the named location using HTTP, HTTPS, FTP, TFTP, SCP, SFTP, or USB.

Note:  It is recommended that you use only secured protocols.

Optionally, you can include a filename for the local image. The format for the download URL is as follows:

[protocol]://username[:password]@hostname/path/filename newfilename

For example, the following command uses SCP to retrieve the hdd48xx image from the builds folder on 192.168.1.25:

(config) # image fetch scp://user:password@192.168.1.25/builds/hdd48xx

The CLI shows you the progress of the image fetch with a series of hash marks, returning you to the system prompt when complete.

Note:  Only the GigaVUE-TA100, GigaVUE-TA100-CXP, GigaVUE‑HC1, and GigaVUE‑HC3 support the USB parameter.

For example on a GigaVUE-TA100, use the image fetch command with the HTTP parameter to fetch the software image from an external web server as follows:

(config) # image fetch http://1.1.1.1/ta100_2016-02-17_gm.img

install <image filename> [location <1 | 2>]

Installs the named image file at the specified location. The location argument is optional—if you do not supply it, the image is automatically installed at the next location after the one currently booted. Use image install ? to see a list of images available for installation.

The GigaVUE‑OS presents a series of status messages as it verifies and uncompresses the image, creates filesystems, and extracts the image, returning you to the system prompt when complete.

For example:

(config) # image install hdd48xx.img

move <src filename> <dst filename>

Renames the specified image file. For example, the following command renames hda22xx as oldimage:

(config) # configuration move hda22xx oldimage

options serve all

Specifies whether or not all image files on this node be made available for HTTP and HTTPS downloads.

Related Commands

The following table summarizes other commands related to the image command:

Task

Command

Displays information on available images, including currently installed images, images available for installation, the last booted partition, and the next boot partition.

show images

Negates image boot location changes.

(config) # no image boot next

Makes all image files on this node unavailable for download.

(config) # no image options serve all