System Image¶

To manage system images, use the following commands in operational mode.

List currently installed images

vrouter> cmd system-image list
3.0.0 (default) (current)
vrouter>

One image is displayed per line in the following format:

<image name> [(default)] [(current)] [(next)]

<image name>: Name used to identify the image. If not set, the version is used.
(default): Set if it is the default boot image.
(current): Set if it is the image on which the system is booted.
(next): Set if the image will be used for the next boot.

Download and install a new version

vrouter> cmd system-image import http://1.0.0.1:8000/6wind-vrouter-tr-ae-x86_64-v3.0.1.update
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  240M  100  240M    0     0   140M      0  0:00:01  0:00:01 --:--:--  140M
vrouter> cmd system-image list
3.0.0 (default) (current)
3.0.1 (next)
vrouter>

Note

The newly installed image becomes the next boot image, but does not automatically become the default boot image.

This enables to test the installed image at next reboot. In case of problem, resetting the system will boot the default image.

Of course, you can explicitly set the newly installed image as the default image whenever you wish.

Rename an image

vrouter> cmd system-image rename 3.0.1 new-name my-img
vrouter> cmd system-image list
3.0.0 (default) (current)
my-img (next)
vrouter>

Change the default boot image

vrouter> cmd system-image set-default my-img
vrouter> cmd system-image list
3.0.0 (current)
my-img (default) (next)
vrouter>

Remove an image

vrouter> cmd system-image delete my-img
vrouter> cmd system-image list
3.0.0 (default) (current)
vrouter>

Note

If the default boot image is deleted, the current image automatically becomes the default.