- Created by Ribbon Communications on Jul 12, 2022
In this section:
The following procedure provides you with instructions to roll back the DSC 8000 software to a previous software version.
The screen captures in this page are examples only and are the same between releases with the exception of the software version numbers in these screen captures.
To verify the status of each system card before a rollback
Click to read more...
It is recommended that you verify the status of the AMC124 CPU, Ethernet Switch (MCH), and AMC348 I/O cards before you perform a rollback. All these cards should be running the same current software load. However, it is possible that some cards are shown as running the previous software load. This might occur if an earlier upgrade attempt encountered a failure on the card, or if some other interruption to the upgrade occurred. If this is the case, the rollback can continue.
If any card is found to be running an unexpected software load, or is reported to be inaccessible, contact Customer Support before proceeding with the rollback.
- Log onto one of the Management CPU cards on the DSC 8000 (slot 2, p19p1.3 or slot 13, p19p2.5).
- At the Linux prompt, enter startmenu and press ENTER.
- Select System and press ENTER.
- Select Software Revisions and press ENTER.
- Do the following:
To check the CPU status, select CPU Versions and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- No new load detected on system. Upload and run load .sh file on /var/log before attempting upgrade. CPU (current) dsc_8000_18_1_0_nb20190830 OS: Ribbon7.4.12 (Servicepack) [none applied] CPU (previous) dsc_8000_17_0_0_nb20181005 OS: 16.4.15 (Servicepack) RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE----------RELEASE--VERSION----PACK---IMAGE-------CARD STATUS--- -------------------------------------------------------------------------------- Slot 2 MGMT 18.1.0 (nb20190830) SP: OS: Ribbon7.4.12 18 procs running Slot 13 MGMT 18.1.0 (nb20190830) SP: OS: Ribbon7.4.12 18 procs running Slot 3 ROUTING 18.1.0 (nb20190830) SP: OS: Ribbon7.4.12 12 procs running Slot 9 --TBD-- N/A SP: OS: 16.4.15 0 procs running Slot 12 ROUTING 18.1.0 (nb20190830) SP: OS: Ribbon7.4.12 12 procs running (p=servicepack is partially applied) Select CPU slot number (9) to begin commissioning of individual card(s). Enter slot # or ENTER to cancel:
To check the Ethernet Switch status, select Switch Versions and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- MCH (current) dsc_8000_18_1_0_nb20190830 (Servicepack) [none applied] MCH (previous) dsc_8000_17_0_0_nb20181005 (Servicepack) RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE------RELEASE-VERSION----PACK-----IMAGE------------CARD STATUS----- -------------------------------------------------------------------------------- --Chassis 1 -- Slot 1 MCH 18.1.0 (nb20190830) SP: Slot 14 MCH 18.1.0 (nb20190830) SP: (p=servicepack is partially applied) Status legend: A - Active, S - Standby, ? - Unknown Select MCH slot number (1 14) to begin upgrade of ISM and SWITCH functions on that MCH. VERSION field modifiers (investigate & update): '***' - a mismatch between the two switches within the MCH. '*!!' - one of the two switches within the MCH is unreachable. Enter slot # or ENTER to cancel:
To check the IO status, select IO Versions, and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- IO (current) AMC348 dsc_8000_18_1_0_nb20190830 OS: rel_12_00_p04.x511.img (Servicepack) [none applied] IO (prev) AMC348 dsc_8000_17_0_0_nb20181005 OS: rel_11_00_p05.x511.img (Servicepack) RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE----------RELEASE-VERSION------PACK-----IMAGE------- -------------------------------------------------------------------------------- Slot 8 IO AMC348 18.1.0 (nb20190830) SP: OS: rel_12_00_p04.x511.img (p=servicepack is partially applied) Select IO slot number (8) to begin upgrade or decommissioning of individual card(s). Enter slot # or ENTER to cancel:
To roll back CPUs to a previous software version
Click to read more...
Check the current status of the CPU, Ethernet Switch (MCH), and I/O cards in the system from the Software Revisions menu before performing the Rollback.
Log onto one of the Management CPU cards on the DSC 8000 (slot 2, p19p1.3 or slot 13, p19p2.5).
At the Linux prompt, enter rollback, and press ENTER.
[root@TMAslot2 ~]# rollback :::::::::::::::::::::::::::::::: Ribbon DSC :::::::::::::::::::::::::::::::: Rollback from Upgrade Utility _____________________________________________ Type "q" to quit from most prompts or CTRL-C. Getting software versions [ ==================== ] 100% This machine has identity 2. Reference current (new) version is: dsc_8000_18_1_0_nb20190830 (Ribbon Linux release x511 7.4.12) Reference previous (old) version is: dsc_8000_17_0_0_nb20181005 (PT Linux release x511 16.4.15) Software Versions ID | OS |SW | Status ------------------------------------------------- 2 | 7.4.12 | dsc_8000_18_1_0_nb20190830 |* 3 | 7.4.12 | dsc_8000_18_1_0_nb20190830 |* 12 | 7.4.12 | dsc_8000_18_1_0_nb20190830 |* 13 | 7.4.12 | dsc_8000_18_1_0_nb20190830 |* Rollback in-container! Rollback targets: [2, 3, 12, 13] Type "yes" to proceed (yes/no):
Type "yes", and press ENTER.
Stopping all software on 3 Machine 3 will be reverted and restarted. Boot Rollback ------------- Saving defunct-upgrade grub configuration (for manual use and debugging)... Restoring previous grub configuration... Moving current kernel file collection to defunct-upgrade location Restoring previous kernel file collection file restored: vmlinuz-4.4.0 file restored: System.map-3.4.2-1.fc16.x86_64 file restored: initramfs-4.4.0.img file restored: config-3.4.2-1.fc16.x86_64 file restored: initramfs-3.4.2-1.fc16.x86_64.img file restored: System.map-4.4.0 file restored: vmlinuz-3.4.2-1.fc16.x86_64 file restored: vmlinuz-4.4.0.old Relabel filesystems to new names. Notes: No /shared drive (logs/stats) detected Ready to reboot. Waiting for machine 3 to recover. Ready for next rollback. Type "yes" to proceed (yes/no):
Select "yes" and press and ENTER.
Stopping all software on 12 Machine 12 will be reverted and restarted. Boot Rollback ------------- Saving defunct-upgrade grub configuration (for manual use and debugging)... Restoring previous grub configuration... Moving current kernel file collection to defunct-upgrade location Restoring previous kernel file collection file restored: initramfs-3.4.2-1.fc16.x86_64.img file restored: vmlinuz-4.4.0.old file restored: config-3.4.2-1.fc16.x86_64 file restored: System.map-4.4.0 file restored: vmlinuz-4.4.0 file restored: System.map-3.4.2-1.fc16.x86_64 file restored: vmlinuz-3.4.2-1.fc16.x86_64 file restored: initramfs-4.4.0.img Relabel filesystems to new names. Notes: No /shared drive (logs/stats) detected Ready to reboot. Waiting for machine 12 to recover. Ready for next rollback. Type "yes" to proceed (yes/no):
Type "yes" and press ENTER.
Stopping all software on 13 Machine 13 will be reverted and restarted. Boot Rollback ------------- Saving defunct-upgrade grub configuration (for manual use and debugging)... Restoring previous grub configuration... Moving current kernel file collection to defunct-upgrade location Restoring previous kernel file collection file restored: initramfs-3.4.2-1.fc16.x86_64.img file restored: vmlinuz-3.4.2-1.fc16.x86_64 file restored: vmlinuz-4.4.0.old file restored: config-3.4.2-1.fc16.x86_64 file restored: vmlinuz-4.4.0 file restored: initramfs-4.4.0.img file restored: System.map-4.4.0 file restored: System.map-3.4.2-1.fc16.x86_64 Relabel filesystems to new names. Ready to reboot. Waiting for machine 13 to recover. Ready for next rollback. Type "yes" to proceed (yes/no):
Type "yes" and press ENTER.
Stopping all software on 2 This machine, 2, will be now be reverted. Boot Rollback ------------- Saving defunct-upgrade grub configuration (for manual use and debugging)... Restoring previous grub configuration... Moving current kernel file collection to defunct-upgrade location Restoring previous kernel file collection file restored: config-3.4.2-1.fc16.x86_64 file restored: System.map-3.4.2-1.fc16.x86_64 file restored: initramfs-3.4.2-1.fc16.x86_64.img file restored: initramfs-4.4.0.img file restored: vmlinuz-3.4.2-1.fc16.x86_64 file restored: System.map-4.4.0 file restored: vmlinuz-4.4.0 file restored: vmlinuz-4.4.0.old Relabel filesystems to new names. Ready to reboot. This machine, 2, will now be restarted.
- Log onto the CPU after rebooting and verify the CPU to ensure the rollback was successful and the CPUs are properly running on previous software (see To verify CPUs have been properly rolled back to previous software version).
To verify CPUs have been properly rolled back to previous software version
Click to read more...
If an asterisk appears beside any of the system cards during the verification process, the rollback for the respective card was unsuccessful. In this case, it is recommended that you contact Customer Support.
- Verify that the software has been rolled back properly by doing the following:
- Navigate to the Software Revisions screen.
Select CPU Versions, and press ENTER.
Ensure that the software and OS have been rolled back, all cards are running the same software, and that there are no asterisks beside any of the cards.AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- No new load detected on system. Upload and run load .sh file on /var/log before attempting upgrade. CPU (current) dsc_8000_17_0_0_nb20181005 OS: 16.4.15 (Servicepack) [none applied] CPU (previous) Not_Available OS: N/A (Servicepack) RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE----------RELEASE--VERSION----PACK---IMAGE-------CARD STATUS--- ------------------------------------------------------------------------------- Slot 2 MGMT 17.0.0 (nb20181005) SP: OS: 16.4.15 18 procs running Slot 13 MGMT 17.0.0 (nb20181005) SP: OS: 16.4.15 18 procs running Slot 3 ROUTING 17.0.0 (nb20181005) SP: OS: 16.4.15 12 procs running Slot 9 --TBD-- N/A SP: OS: 16.4.15 0 procs running Slot 12 ROUTING 17.0.0 (nb20181005) SP: OS: 16.4.15 12 procs running (p=servicepack is partially applied) Select CPU slot number (9) to begin commissioning of individual card(s). Enter slot # or ENTER to cancel:
To roll back Ethernet (MCH) Switches to a previous software version
Click to read more...
- At the Linux prompt, enter startmenu, and press ENTER.
- Select System, and press ENTER.
- Select Software Revisions, and press ENTER.
Select Switch Versions, and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- MCH (current) dsc_8000_17_0_0_nb20181005 (Servicepack) [none applied] RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE------RELEASE-VERSION----PACK-----IMAGE------------CARD STATUS----- -------------------------------------------------------------------------------- -- Chassis 1 -- Slot 1 MCH * 18.1.0 (nb20190830) SP: Slot 14 MCH * 18.1.0 (nb20190830) SP: (p=servicepack is partially applied) Status legend: A - Active, S - Standby, ? -Unknown Select MCH slot number (1 14) to begin upgrade of ISM and SWITCH functions on that MCH. VERSION field modifiers (investigate & update): '***' - a mismatch between the two switches within the MCH. '*!!' - one of the two switches within the MCH is unreachable. Enter slot # or ENTER to cancel:
Type "14" to rollback MCH slot14 and press ENTER.
Note: flex_slot.conf file doesn't exist ... This is ok if the SDA is not configured on the system. Software Update for Switch Card in Slot #14 Determining running and current software version. Please wait... Running on SWITCH (slot14_0): -Load: dsc_8000_18_1_0_nb20190830 Current SWITCH version (on MGMT CPU): -Load: dsc_8000_17_0_0_nb20181005 -Servicepack: [none applied] 'u' - Update version (update slot14_0 to match the current load): -Load: dsc_8000_16_1_0_nb20180111 Select action to take, or any other key to cancel:
Type "u" and press ENTER.
avail_switch_current_load is dsc_8000_17_0_0_nb20181005 avail_ism_current_load is Running SWITCH software is out-of-date! You have opted to update/reboot slot #14, thereby loading the current software: -Load: dsc_8000_17_0_0_nb20181005 -Servicepack: [none applied] MCH upgrade pre-step: disable TIPC bearer p19p2 for MCH 1. Updating/rebooting switch card in slot #14. Please wait... Note: The switch status may be unavailable for a few minutes while it performs its upgrade procedures. CPU local tftp is enabled. Running SWITCH slot 14 software is now up-to-date. MCH upgrade post-step: enable TIPC bearer p19p2 for MCH 1. Press <return> to continue.
Press ENTER.
Software Revisions 1 - Pre Upgrade Check 2 - Express Upgrade 3 - CPU Versions 4 - Switch Versions 5 - IO Versions 6 - Express Rollback 7 - Servicepacks 8 - DSC DB 9 - SS7 DB Apps b - Back l - Logout Enter Selection:
Type "4" and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- MCH (current) dsc_8000_17_0_0_nb20181005 (Servicepack) [none applied] RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE------RELEASE-VERSION----PACK-----IMAGE------------CARD STATUS----- -------------------------------------------------------------------------------- -- Chassis 1 -- Slot 1 MCH * 18.1.0 (nb20190830) SP: Slot 14 MCH 17.0.0 (nb20181005) SP: (p=servicepack is partially applied) Status legend: A - Active, S - Standby, ? - Unknown Select MCH slot number (1 14) to begin upgrade of ISM and SWITCH functions on that MCH. VERSION field modifiers (investigate & update): '***' - a mismatch between the two switches within the MCH. '*!!' - one of the two switches within the MCH is unreachable. Enter slot # or ENTER to cancel:
Type "1" and press ENTER.
Note: flex_slot.conf file doesn't exist ... This is ok if the SDA is not configured on the system. Software Update for Switch Card in Slot #1 Determining running and current software version. Please wait... Running on SWITCH (slot1_0): -Load: dsc_8000_18_1_0_nb20190830 Current SWITCH version (on MGMT CPU): -Load: dsc_8000_17_0_0_nb20181005 -Servicepack: [none applied] 'u' - Update version (update slot1_0 to match the current load): -Load: dsc_8000_17_0_0_nb20181005 Select action to take, or any other key to cancel:
Type "u" and press ENTER.
avail_switch_current_load is dsc_8000_17_0_0_nb20181005 avail_ism_current_load is Running SWITCH software is out-of-date! You have opted to update/reboot slot #1, thereby loading the current software: -Load: dsc_8000_17_0_0_nb20181005 -Servicepack: [none applied] MCH upgrade pre-step: disable TIPC bearer p19p1 for MCH 0. Updating/rebooting switch card in slot #1. Please wait... Note: The switch status may be unavailable for a few minutes while it performs its upgrade procedures. CPU local tftp is enabled. Socket error Event: 32 Error: 10053. Connection closing...Socket close. Connection closed by foreign host
- Log otto the CPU after rebooting and verify the Ethernet (MCH) Switches to ensure the rollback was successful and the Ethernet (MCH) Switches are properly running on previous software (see To verify the Ethernet (MCH) Switches have been properly rolled back to previous software).
To verify the Ethernet (MCH) Switches have been properly rolled back to previous software version
Click to read more...
- At the Linux prompt, enter startmenu, and press ENTER.
- Select System, and press ENTER.
- Select Software Revisions, and press ENTER.
Select Switch Versions, and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- MCH (current) dsc_8000_17_0_0_nb20181005 (Servicepack) [none applied] RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE------RELEASE-VERSION----PACK-----IMAGE------------CARD STATUS----- -------------------------------------------------------------------------------- -- Chassis 1 -- Slot 1 MCH 17.0.0 (nb20181005) SP: Slot 14 MCH 17.0.0 (nb20181005) SP: (p=servicepack is partially applied) Status legend: A - Active, S - Standby, ? - Unknown Select MCH slot number (1 14) to begin upgrade of ISM and SWITCH functions on that MCH. VERSION field modifiers (investigate & update): '***' - a mismatch between the two switches within the MCH. '*!!' - one of the two switches within the MCH is unreachable. Enter slot # or ENTER to cancel:
To roll back IO(s) to a previous software version
Click to read more...
- At the Linux prompt, enter startmenu, and press ENTER.
- Select System, and press ENTER.
- Select Software Revisions, and press ENTER.
Select IO Versions, and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- IO (current) AMC348 dsc_8000_18_1_0_nb20190830 OS: rel_12_00_p04.x511.img (Servicepack) [none applied] IO (prev) AMC348 dsc_8000_17_0_0_nb20181005 OS: rel_11_00_p05.x511.img (Servicepack) RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE----------RELEASE-VERSION------PACK-----IMAGE------- -------------------------------------------------------------------------------- Slot 8 IO AMC348 * 18.1.0 (nb20190830) SP: OS: rel_12_00_p04.x511.img (p=servicepack is partially applied) Select IO slot number (8) to begin upgrade or decommissioning of individual card(s). Enter slot # or ENTER to cancel:
Type “8” and press ENTER.
Note: flex_slot.conf file doesn't exist ... This is ok if the SDA is not configured on the system. Software Update for IO Card in Slot #8 Determining running and current software version. Please wait... Running on IO (slot8_0): -Load: dsc_8000_17_0_0_nb20181005 -OS: rel_11_00_p05.x511.img Current IO version (on MGMT CPU): -Load: dsc_8000_18_1_0_nb20190830 -OS: rel_12_00_p04.x511.img -Servicepack: [none applied] 'u' - Update version (update slot8_0 to match the current load): -Load: dsc_8000_18_1_0_nb20190830 -OS: rel_12_00_p04.x511.img 'd' - Decommission this IO card to prepare it for removal. Select action to take, or any other key to cancel:
Type "u" and press ENTER.
avail_switch_current_load is dsc_8000_18_1_0_nb20190830 avail_ism_current_load is Running IO software is out-of-date! You have opted to update/reboot slot #8, thereby loading the current software: -Load: dsc_8000_18_1_0_nb20190830 -OS: rel_12_00_p04.x511.img -Servicepack: [none applied] Pushing image to the IO card in slot #8 Executing verify_io_image.sh script on IO board in slot #8 DO NOT INTERRUPT!! THIS MAY TAKE A FEW MINUTES... Done: flashed Nexus image to IO board kernel0 and kernel1 Rebooting IO card in slot #8. Press <return> to continue.
- Repeat step 4 to step 7 for the remaining IO cards.
- Verify the Ethernet IO cards to ensure the rollback was successful and IO cards are properly running on previous software (see To verify the IO cards have been properly rolled back to previous software version).
To verify the IO cards have been properly rolled back to previous software version
Click to read more...
- At the Linux prompt, enter startmenu, and press ENTER.
- Select System, and press ENTER.
- Select Software Revisions, and press ENTER.
Select IO Versions, and press ENTER.
AVAILABLE SOFTWARE VERSIONS -------------------------------------------------------------------------------- IO (current) AMC348 dsc_8000_17_0_0_nb20181005 OS: rel_11_00_p05.x511.img (Servicepack) [none applied] RUNNING SOFTWARE VERSIONS (*=update required, ?=update unknown) CARD BUILD SERVICE O/S -SLOT----TYPE----------RELEASE-VERSION------PACK-----IMAGE------- -------------------------------------------------------------------------------- Slot 8 IO AMC348 17.0.0 (nb20181005) SP: OS: rel_11_00_p05.x511.img (p=servicepack is partially applied) Select IO slot number (8) to begin upgrade or decommissioning of individual card(s). Enter slot # or ENTER to cancel: