Upgrading the System
Release-specific upgrade information
Your system may have special upgrade considerations depending on your release. For release-specific upgrade information and to ensure that configuration information is correctly preserved, see the release notes for your release.
Using add system image is currently the only supported upgrade method for physical hardware systems.
You must download a new system image from Ciena Portal at https://my.ciena.com/CienaPortal, and then add the image to previous versions of the system that are present by using add system image. add system image also allows you to migrate the current configuration to the new image. After the system is rebooted the new image is running.
Before upgrading the system you must perform the following tasks.
- Save your existing configuration file for reference. Note: Your configuration file is named config.boot and is located in the /config directory.
- Ensure that you have enough space on your root partition to load the image. Note: You can determine the amount of space that is available by using show system storage.
- Download the ISO image file to use for your upgrade.
Upgrading the ISO
add system image uses an ISO file as the image source. The command 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.
Determine the location of the ISO file and record the name of the file.
To prepare for the upgrade perform the following steps.
- Enter add system image . Use the location and name of the ISO file as arguments in the command, see Example of upgrading the ISO.
- Before you reboot the system confirm that the new image is loaded and ready to run the next time the system is rebooted. Enter show system image, see Example of upgrading the ISO.
- Enter reboot. The system reboots with the new system image.
Example of upgrading the ISO
The following example shows how to use add system image to upgrade the xxx.iso system image, where xxx is the file name of the ISO image that you have downloaded. The following example uses the 2009 image.
vyatta@vyatta:~$ add system image /home/vyatta/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
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)