home

Supported platforms

Vyatta documentation

Learn how to install, configure, and operate the Vyatta Network Operating System (Vyatta NOS) and Orchestrator, which help drive our virtual networking and physical platforms portfolio.

Show Page Sections

Upgrading a template-installed system

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

Vyatta NOS VMware template consists of the following:

  • Vyatta NOS ISO
  • Other VMware-specific modifications and optimizations

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

Table 1. Upgrade options for Vyatta NOS 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

Vyatta NOS ISO

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

You are not sure

Use the procedure given in Upgrading Vyatta NOS 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 Vyatta NOS template.

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

To upgrade Vyatta NOS VMware template:

  1. Save your current system configuration (/config) to a separate location on your network.
  2. Using the new Vyatta NOS VMware template, create a new Vyatta NOS 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 Vyatta NOS 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 Vyatta NOS ISO using “add system image”

The procedure to upgrade Vyatta NOS ISO is detailed in this section.

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

The add system image command uses a Vyatta NOS 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 Vyatta NOS 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)