Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

Show Page Sections

Upgrading the Linux KVM System

Release-specific upgrade information

Your system may have special upgrade considerations, depending on the release.

For release-specific upgrade information, and to ensure that configuration information is correctly preserved across upgrades, consult the release notes for your release.

Before upgrading

Before upgrading your system, perform the following tasks.

  • Save your existing configuration file for reference. Your configuration file is named config.boot and is located in the directory /config.
  • Make sure you have enough space on your root partition to load the image. You can determine the amount of space available by using the show system storage command.
  • If you install or upgrade the vRouter image without setting the CPU flags, the system boots and displays the following error: Starting vPlane services: huge igb_uio dataplane ERROR: This system does not support “SSSE3”. Please check that RTE_MACHINE is set correctly. Refer to the procedure Installing the Vyatta Linux KVM image to resolve the issue.

Upgrading the system by using the add system image command

The add system image command uses a vRouter ISO file as the image source. It installs the new image and sets the new image as the default boot image. The new image is run the next time the system is rebooted.

To prepare for the upgrade, download the new image, determine the location of the vRouter ISO file, and record the name of the file.

To upgrade the ISO, perform the following steps:
  1. Enter the add system image command.

    Use the location and name of the vRouter SO file as arguments in the command, as shown in the following example.

  2. Before you reboot, confirm that the new image is loaded and ready to run the next time the system is rebooted. Enter the show system image command.

    See the example for the command in the next sections.

  3. Reboot the system by entering the reboot command. The system restarts with the new system image.

Sample session: add system image

The following example shows a session in which the add system image command is used to upgrade to the xxx.iso system image, where xxx is the file name of the ISO image you have downloaded.

The following example shows a session in which the add system image command is used to upgrade to the vyatta-2009-base.iso system image corresponding to the 2009 release:


vyatta@vyatta:~$ add system image /home/vyatta-2009-base.iso

Welcome to the DANOS - Vyatta NOS Edition image installer.
Checking MD5 checksums of files on the ISO image...OK.
Executing installer from downloaded image...
What would you like to name this image? [2009.09091217]: 
This image will be named: 2009.09091217
Would you like to save the current configuration 
directory and config file? (Yes/No) [Yes]: 
Saving current configuration...
Would you like to save the SSH host keys from your 
current configuration? (Yes/No) [Yes]: 
Saving SSH keys...
Copying squashfs image...
Copying kernel and initrd images...
Copying saved configuration to config partition.
Copying saved SSH host keys.
Copied machine-id: 05537b411843b2b33b0db9b33f79595a
Done.

The following example shows how to display installed images:


vyatta@vyatta:~$ show system image
The system currently has the following image(s) installed:
   1: xxx (default boot)
   2: yyy (running version)