Vyatta NOS documentation

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

show version

Displays information about the versions of system software.

show version [ all | added | deleted | downgraded | upgraded ]

A brief version summary is shown. Detailed information about constituent packages is not shown.

all
Displays all software that has been added, deleted, downgraded, or upgraded since the last baseline version upgrade.
added
Displays all packages that have been added since the last baseline version upgrade.
deleted
Displays all packages that have been deleted since the last baseline version upgrade.
downgraded
Displays all packages that have been downgraded since the last baseline version upgrade.
upgraded
Displays all packages that have been upgraded since the last baseline version upgrade.

Operational mode

Use this command to see what package changes have occurred since the last time a full version upgrade was performed.

The information shown always relates to the last full version upgrade. Therefore, the following conditions apply.

  • Immediately after a full version upgrade, entering a show version all command displays no changes.
  • If a package is added after an upgrade, entering a show version all command displays the added package.
  • However, if the added package is then deleted again, entering a show version all command displays no change because the system is now in the same state as it is immediately after the full version upgrade.

If there are no added, deleted, upgraded, or downgraded packages the output does not provide any package information.

Keep in mind that if you delete a package, packages that depend on the deleted package are also removed.

If there have been packages added, deleted, upgraded and/or downgraded the package information will immediately follow the general version information (see above). The output will list the added packages first, followed by all the deleted packages, followed by the list of upgraded packages, and finally ending with a list of downgraded packages. An example showing the full package information output follows at the end of this description.

The following example shows a version summary for a vRouter.


vyatta@vyatta:~$ show version
Version:      5.1R1
Description:  vRouter 5600 5.1R1 Standard
Built on:     Fri Sep 23 04:24:19 UTC 2016
System type:  Intel 64bit
Boot via:     image
Hypervisor:   KVM
HW model:     Bochs
HW S/N:       Not Specified
HW UUID:      2DA5E59E-32ED-4B1A-82CB-6B7B1E9D2D1A
Uptime:       17:04:15 up 3 min,  1 user,  load average: 0.12, 0.19, 0.09

The following example shows a version summary for a VNF platform.


vyatta@vyatta:~$ show version
Version:      5.1R1
Description:  vRouter 5600 5.1R1 vCPE
Built on:     Fri Sep 23 04:28:00 UTC 2016
System type:  Intel 64bit
Boot via:     image
Hypervisor:   KVM
HW model:     Standard PC (i440FX + PIIX, 1996)
HW S/N:       Not Specified
HW UUID:      97701E2E-817E-11E6-A7BC-B003F4010100
Uptime:       10:13:46 up 4 days, 23:00,  4 users,  load average: 1.72, 1.43, 1.46

The following example shows a version summary for a distributed services platform.


vyatta@vyatta:~$ show version
Version:      5.1R1
Description:  vRouter 5600 5.1R1 Control Plane
Built on:     Fri Sep 23 04:23:17 UTC 2016
System type:  Intel 64bit
Boot via:     image
Hypervisor:   KVM
HW model:     Standard PC (i440FX + PIIX, 1996)
HW S/N:       Not Specified
HW UUID:      83EE66A1-84B8-11E6-86C1-B003F4030304
Uptime:       10:12:54 up 20:28,  3 users,  load average: 0.01, 0.02, 0.00
Note:

The naming convention for vRouter images is vyatta-vr-platform-version_amd64.file-type where vr-platform = esx, kvm, hyperv, xen, and so forth; version = 5.1R1, and so forth; and file-type = iso, ova, img, and so forth.

The following examples describe the output format for each type of modified package; added, deleted, upgraded, and downgraded. Please note all examples are provided just to show the format.

Added packages are packages that are not one of the original released packages for the base release. Information about added packages is provided in the following format.
Aii    <package name>                    <package version>
The "Aii" is the indicator of an added package. This is followed by the package name and the package version. Here is an example of real output.
Aii archivemail            0.9.0-1.1
Aii mailagent              1:3.1-78-1

Deleted packages are packages that are part of the original released packages for the base release but have been removed from the system. Information about deleted packages is provided in the following format.

X    <package name>                    <package version>

The "X" is the indicator of a deleted package. This is followed by the package name and the package version. Here is an example of real output.

X   auditd                1:2.6.7-1        
X   gcc-6-base            6.3.0-11    

Upgraded packages are packages that are part of the original released packages for the base release but have been replaced with a newer version than was released with the base system. Information about upgraded packages is provided in the following format.

Uii  <package name>               <new package version>    (baseline: <old package version>)

The "Uii" is the indicator of an upgraded package. This is followed by the package name, the new package version, and then the baseline version number. Here is an example of real output.

Uii Vyatta-netconf-agent         0.18+1489084814      (baseline: 0.17+1689874855)
Uii Vyatta-service-dhcp-server   0.4+1490051665       (baseline: 0.3+1720041655)

Downgraded packages are packages that are part of the original released packages for the base release but have been replaced with an older version than was released with the base system. Information about downgraded packages is provided in the following format.

Dii  <package name>               <new package version>    (baseline: <old package version>)

The "Dii" is the indicator of a downgraded package. This is followed by the package name, the old package version, and then the baseline version number. Here is an example of real output.

Dii grep                      2.26-2               (baseline: 2.27-2)
Dii lftp                      4.5.2-1              (baseline: 4.7.4-1)

Given the examples above, the full output would look like the following.

vyatta@vyatta:~$ show version
Version:      17.2.0-DEV
Description:  vRouter 5600 17.2.0-DEV (Vyatta:XL_Ranch)
Built on:     Fri Apr  7 10:54:46 UTC 2017
System type:  Intel 64bit
Boot via:     image
Hypervisor:   KVM
HW model:     Standard PC (i440FX + PIIX, 1996)
HW S/N:       Not Specified
HW UUID:      6CD4D29E-7176-C344-B929-B2168FDD689A
Uptime:       19:48:00 up 4 days, 22:22,  1 user,  load average: 0.06, 0.03, 0.00
Aii archivemail           0.9.0-1.1
Aii mailagent             1:3.1-78-1
X   auditd                1:2.6.7-1        
X   gcc-6-base            6.3.0-11    
Uii vyatta-netconf-agent  0.18+1489084814      (baseline: 0.17+1689874855)
Uii vyatta-service-dhcp   0.4+1490051665       (baseline: 0.3+1720041655)
Dii grep                  2.26-2    		         (baseline: 2.27-2)
Dii lftp                  4.5.2-1  			         (baseline: 4.7.4-1)