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 a template-installed system

There are multiple upgrade options for a vRouter template-installed system.

The vRouter VMware template consists of the following:

  • vRouter ISO
  • Other VMware-specific modifications and optimizations

The way you upgrade a vRouter template-installed system depends on what part of the template has changed. The table below shows the upgrade options for a vRouter template-installed systems.

Table 1. Upgrade options for vRouter VMware template-installed systems
What has changed What you need to upgrade

VMware-specific modifications

Upgrade the full template. Use the procedure given in Upgrading the full template

vRouter ISO

Upgrade just the ISO. You can use the add system image command. Use the procedure given in Upgrading the vRouter ISO using “add system image”

You are not sure

Use the procedure given in Upgrading the vRouter ISO using “add system image”

Upgrading the full template

The new template must be upgraded if there are changes to the VMware-specific content in the vRouter template.

When VMware-specific content in the vRouter VMware template changes, you must perform an upgrade to the new vRouter VMware template by using the procedure in this section.

To upgrade the vRouter VMware template:

  1. Save your current system configuration (/config) to a separate location on your network.
  2. Using the new vRouter VMware template, create a new vRouter virtual machine in your VMware environment. Use the instructions given in Installing the system.
  3. Perform initial configuration of the new virtual machine and test the installation to verify connectivity on the network.
  4. Shut down the old system so it does not conflict with the new system.
  5. Load the configuration you saved onto the new vRouter virtual machine.
  6. For each Ethernet interface in the loaded configuration, delete the hardware ID. In configuration mode, use the delete interface dataplane dpxpypz hw-id command, where dpxpypz is the name of the Ethernet interface.
    In configuration mode, use the delete interface dataplanedpxpypz hw-id command, where dpxpypz is the name of the Ethernet interface.
  7. Reboot the system by using the reboot command.
    The system restarts with the new configuration.

Upgrading the vRouter ISO using “add system image”

The procedure to upgrade the vRouter ISO is detailed in this section.

When the ISO of the vRouter VMware template changes, perform an upgrade to the ISO.

The add system image command uses a vRouter ISO file as the image source. It installs the image with existing images 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, determine the location of the vRouter ISO file and record the name of the file.

To upgrade the ISO:

  1. Enter the add system image command. Use the location and name of the vRouter ISO file as arguments in the command, as shown in Sample session: “add system image”.
  2. Before you reboot, confirm that the new image is loaded and ready to run the next time the system is rebooted.
  3. Enter the show system image command; see Sample session: “add system image”.
  4. Reboot the system by entering the reboot command.
The system restarts with the new system image.

Sample session: “add system image”

An example session has been provided to show how the ISO system image is upgraded.

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 uses the 3.2R1 image.

Adding a system image


vyatta@vyatta:~$ add system image /home/vyatta/xxx.iso
Checking MD5 checksums of files on the ISO image...OK.
Done!
What would you like to name this image? [3.2R1]:
OK.  This image will be named: 3.2R1
Installing "3.2R1" image.
Copying new release files...
Would you like to save the current configuration
directory and config file? (Yes/No) [Yes]:
Copying current configuration...
Would you like to save the SSH host keys from your
current configuration? (Yes/No) [Yes]:
Copying SSH keys...
Setting up grub configuration...
Done.
vyatta@vyatta:~$

Displaying system images

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)