image

Required Command-Line Mode = Enable

Required User Level = Admin

Use the image command to manage software images for the GigaVUE® HC 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>
   move <src filename> <dst filename>
   

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

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 ta100xx image from the builds folder on 192.168.1.25:

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

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

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>

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 ta100xx.img

move <src filename> <dst filename>

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

(config) # configuration moveta100xx oldimage

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