Cisco ONS 15454 Software Upgrade Guide, Release 3.4
Chapter 2, Upgrading Release 3.x to 3.4 Using the TCC+ Card

Table Of Contents

Upgrading Release 3.x to 3.4.x Using the TCC+ Card

Before You Begin

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade

DLP-452 Verify CTC Workstation

DLP-453 Verify IP Addresses

DLP-454 Verify LAN Connections

DLP-455 Verify Common Control Cards

NTP-405 Back Up the Database

DLP-456 Back Up Software

DLP-457 Perform a Manual Backup

NTP-406 Upgrade the Software

DLP-458 Download the Release 3.4.x Software

DLP-459 Perform a BLSR Lockout

DLP-U19 Activate the New Load

DLP-461 Delete Cached JAR Files

DLP-462 Remove the BLSR Lockout

DLP-463 Set the Date and Time

DLP-464 Upgrade Spare TCC+ Units

NTP-407 Revert to Previous Load

DLP-465 Perform a BLSR Lockout

DLP-466 Revert to Protect Load

DLP-467 Remove the BLSR Lockout

DLP-468 Manually Restore the Database


Upgrading Release 3.x to 3.4.x Using the TCC+ Card


This chapter explains how to upgrade Cisco ONS 15454's Cisco Transport Controller (CTC) software from Release 3.x to Release 3.4.x using the Timing, Communications, and Control + (TCC+) card.

Before You Begin

Before beginning, write down the following information about your site; the data will be useful during and after the upgrade: Date, Street Address, Site Phone Number, and Dial Up Number.


Caution Read each procedure before you begin the upgrade.


Caution This chapter is only supported for Release 3.x. If you wish to upgrade from Releases 2.2.0 - 2.2.2, use the procedures in Chapter 1, "Upgrading Release 2.2.x to 3.4.x Using the TCC+ Card". If you wish to upgrade from a release prior to Release 2.2.0, you must call the Technical Assistance Center (TAC) at 877 323-7368 for assistance.


Note Procedures in this chapter are to be performed in consecutive order unless otherwise noted. In general, you are not done with a procedure until you have completed it for each node you are upgrading, and you are not done with the upgrade until you have completed each procedure that applies to your network. If you are new to upgrading the ONS 15454, you may wish to check off each procedure on your printed copy of this chapter as you complete it.


This section lists the chapter procedures (NTPs). Turn to a procedure for applicable tasks (DLPs).

1. NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade—This section contains critical information and tasks that you must read and complete before beginning the upgrade process.

2. NTP-405 Back Up the Database—Complete the database backup to ensure that you have preserved your node and network provisioning in the event that you need to restore them.

3. NTP-406 Upgrade the Software—You must complete this entire procedure before the upgrade is finished.

4. NTP-407 Revert to Previous Load—Complete this procedure only if you need to return to the software load you were running before activating the Release 3.4.x software.

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade

Purpose

This procedure steps you through the critical information checks and tasks you must complete before beginning an upgrade.

Tools/Equipment

ONS 15454s to upgrade; PC or UNIX workstation; Cisco ONS 15454 Release 3.4.x software.

Prerequisite Procedures

None

Required/As Needed

Required

Onsite/Remote

Onsite or remote



Step 1 Read the appropriate release notes.

Step 2 Complete the "DLP-452 Verify CTC Workstation" task.

Step 3 Complete the "DLP-453 Verify IP Addresses" task.

Step 4 Complete the "DLP-454 Verify LAN Connections" task.

Step 5 Complete the "DLP-455 Verify Common Control Cards" task.

Step 6 When you have completed the tasks for this section, proceed with the "NTP-405 Back Up the Database" procedure.


DLP-452 Verify CTC Workstation

Purpose

Before upgrading the workstation to run CTC Release 3.4.x, verify all PC or UNIX workstation hardware and software requirements.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

None

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Ensure that your Windows or Unix workstation is either of the following:

IBM-compatible PC with a Pentium or higher processor, CD-ROM drive, and 128 MB RAM running Windows 95, Windows 98, Windows 2000, Windows NT (w/SP-4 or higher) or Windows XP

UNIX workstation running Solaris

Step 2 Ensure that your web browser software is one of:

Netscape Navigator 4.73 or higher (Netscape Navigator is included on the ONS 15454 software CD shipped with the node.)

Netscape Communicator 4.61 or higher

Internet Explorer 4.0 Service Pack 2 or higher

Step 3 Ensure that you have Java Policy and Java Runtime Environment (JRE), Release 1.3.1_02 (JRE 1.3.1.02 is included on the ONS 15454 software CD).


Note When you upgrade to JRE 1.3.1.02, you will no longer be able to log into an ONS 15454 running Release 2.2.1 or prior, or an ONS 15327 running release 1.0.0. If you must later revert to a release that requires a previous version of the JRE, you will have to reinstall Java and delete the jar files from your workstation's user "temp" directory after reverting all of the nodes in the network. If you are currently running a release that is also compatible with JRE 1.3.1.02, the extra steps are not necessary.


Step 4 Once you have verified that your workstation meets CTC Release 3.4.x requirements, proceed to the "DLP-453 Verify IP Addresses" task.


DLP-453 Verify IP Addresses

Purpose

Use this task to ensure that there are no IP address conflicts with CTC.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-452 Verify CTC Workstation

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Disable all other Ethernet devices (such as a dial-up adapter) on the workstation that runs CTC.

Step 2 If you have multiple IP addresses on your workstation, you should remove them; you cannot install CTC Release 3.4.x if multiple IP addresses are configured.

Step 3 You have completed the IP address check procedure. Now perform the "DLP-454 Verify LAN Connections" task.


DLP-454 Verify LAN Connections

Purpose

Use this task to ensure LAN connections are correct.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-453 Verify IP Addresses

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 If you have multiple ONS 15454 nodes configured in the same IP subnet, ensure that only one is connected to a router. Otherwise, the remaining nodes might be unreachable. Refer to the Cisco ONS 15454 Reference Guide for LAN-connection suggestions.

Step 2 After verifying that your LAN is properly configured, proceed to the "DLP-455 Verify Common Control Cards" task.


DLP-455 Verify Common Control Cards

Purpose

You must now use CTC to check for duplex common control cards. The node must have two TCC+ cards and two cross-connect cards (two XCs, two XCVTs, or two XC10Gs).

Tools/Equipment

PC or UNIX workstation with CTC installed

Prerequisite Procedures

DLP-454 Verify LAN Connections

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Log into the node.

Step 2 Ensure that Slots 7, 8, 10, and 11 have cards installed. Release 3.x does not support simplex operation.

Step 3 Repeat Steps 1 and 2 at every node in the network.

Step 4 You have completed the verification of duplex common control cards. Proceed to the "NTP-405 Back Up the Database" procedure.


NTP-405 Back Up the Database

Purpose

Use this procedure to preserve all configuration data for your network before performing the upgrade.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Complete the "DLP-456 Back Up Software" task.

Step 2 Complete the "DLP-457 Perform a Manual Backup" task.

Step 3 Once you have backed up the database, proceed to the "NTP-406 Upgrade the Software" procedure.


DLP-456 Back Up Software

Purpose

Before upgrading from Release 3.x to Release 3.4.x software, you must back up the current database for all nodes in the network.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Log into CTC.

Step 2 From the node view, click the Maintenance > Database tabs.

Step 3 Click Backup.

Step 4 Save the database on the workstation's hard drive or on network storage. Use an appropriate file name with the file extension .db (for example, myDatabase.db).

Step 5 Click Save. A message appears indicating that the backup is complete.

Step 6 Click OK.

Step 7 Repeat Steps 1 - 6 for each node in the network.

Step 8 You have completed the software backup. Proceed to the "DLP-457 Perform a Manual Backup" task.


DLP-457 Perform a Manual Backup

Purpose

Cisco recommends that you manually log critical information by either writing it down or printing screens where applicable. This task is optional after you have backed up the database.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-456 Back Up Software

Required/As Needed

Recommended

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Use the following table to determine the information you should log; complete the table (or your own version) for every node in the network.

Table 2-1 Manually Recorded Data 

Item
Record data here (if applicable)

IP address of the node

 

Node name

 

Timing settings

 

DCC connections; list all optical ports that have DCCs activated

 

User IDs (List all, including at least one super user)

 

Inventory; do a print screen from the inventory window

 

Active TCC+

Slot 7 or Slot 11 (circle one)

Active XC/XCVT/XC10G

Slot 8 or Slot 10 (circle one)

Network information; do a print screen from the Provisioning tab in the network view.

 

Current configuration: BLSR, linear, etc. (do print screens as needed)

 

List all protection groups in the system; do a print screen from the protection group window

 

List alarms; do a print screen from the alarm window

 

List circuits; do a print screen from the circuit window

 

Step 2 Once you have backed up all databases and recorded all necessary information using the checklist, you can begin the "NTP-406 Upgrade the Software" procedure.


NTP-406 Upgrade the Software

Purpose

Use this procedure to upgrade your CTC software.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-405 Back Up the Database

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Insert the Release 3.4.x software CD into the workstation CD-ROM (or otherwise acquire access to the software) to begin the upgrade process.


Note Inserting the software CD activates the CTC Setup Wizard. You can use the setup wizard to install components or click Cancel to continue with the upgrade.



Caution A traffic interruption of less than 60 ms on each circuit is possible during the activation task, with Ethernet traffic disruption possibly lasting up to several minutes on each circuit.


Caution Do not perform maintenance or provisioning activities during the activation task.

Step 2 Complete the DLP-458 Download the Release 3.4.x Software (all nodes).

Step 3 Complete the DLP-459 Perform a BLSR Lockout (BLSR nodes only).

Step 4 Complete the DLP-U19 Activate the New Load (all nodes).

Step 5 Complete the DLP-461 Delete Cached JAR Files.

Step 6 Complete the DLP-462 Remove the BLSR Lockout (BLSR nodes only).

Step 7 Complete the DLP-463 Set the Date and Time (any nodes not using SNTP).

Step 8 Complete the DLP-464 Upgrade Spare TCC+ Units (as needed for upgrading spare TCC+ cards).

Step 9 To upgrade the software successfully, you must read and perform each of the tasks that applies to your network in the proper order. Begin with the "DLP-458 Download the Release 3.4.x Software" task.


DLP-458 Download the Release 3.4.x Software

Purpose

Download the Release 3.4.x software to the ONS 15454 nodes prior to activation.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-405 Back Up the Database

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note There are two flash RAMs on the TCC+ card. An upgrade downloads the software to the backup RAM on both the backup and active TCC+ cards. The download task does not affect traffic because the active software continues to run at the primary RAM location; therefore, you can download the software at any time.



Step 1 Check all nodes in the ring for existing alarms. Resolve any outstanding alarms before proceeding.


Note During the software download process, the SWFTDWN alarm indicates that the software download is taking place. The alarm is normal and clears when the download is complete.


Step 2 From the CTC network view, click the Maintenance > Software tabs.

Step 3 Click Download. The Download Selection dialog box opens.

Step 4 Browse to locate the software files on the ONS 15454 System Software CD (or on your hard drive, if you are working from a local copy).

Step 5 Open the "Cisco15454" folder.

Step 6 Select the file with the ".pkg" extension and click Open.

Step 7 In the list of compatible nodes, select the checkboxes for all nodes you are downloading the software to.


Note Cisco advises that you limit concurrent software downloads to 3 nodes at once.


Step 8 Click OK. The Download Status column monitors the progress of the download.


Note The software download process can take 30 minutes or more per node.


Step 9 Once you have successfully downloaded the CTC Release 3.4.x software to each node you are upgrading, perform the "DLP-459 Perform a BLSR Lockout" task. If none of your nodes participate in a BLSR, you can skip the BLSR lockout and begin the "DLP-U19 Activate the New Load" task.


DLP-459 Perform a BLSR Lockout

Purpose

If any node you are upgrading is in a bidirectional line switched ring (BLSR) configuration, you must perform a span lockout at each node in the ring before activating the software for Release 3.4.x. Perform this task to issue a span lockout on a BLSR using CTC Release 3.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-458 Download the Release 3.4.x Software

Required/As Needed

Required for BLSR

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note During the lockout, BLSR spans will not be protected. Be sure to remove the lockout after activating all nodes in the ring.



Note To prevent ring or span switching, perform the lockout on both the east and west spans of each node.



Step 1 Click the Maintenance > Ring tabs.

Step 2 For each of the BLSR trunk cards (OC-12, OC-48, or OC-192), go to the row in the table for that card and perform the following steps:

a. Click the East Switch column to show the pull-down menu.

b. From the menu options, choose Span Lockout.

c. Click West Switch column to show the pull-down menu.

d. From the menu options, choose Span Lockout.

e. Click Apply to activate the command.

Step 3 Repeat Step 2 at each node in the ring.


Note Ignore any Default K alarm or alarms that occur on the protect STS timeslots during this lockout period.



Note Leave the BLSR in the lockout state until you have finished activating all nodes.


Step 4 You have completed the BLSR lockout. You must now perform the "DLP-U19 Activate the New Load" task.


DLP-U19 Activate the New Load

Purpose

Log into and activate each node in the network.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-459 Perform a BLSR Lockout, if required; otherwise, DLP-458 Download the Release 3.4.x Software

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note Cisco recommends that the first node you activate be a LAN-connected node. This ensures that the new CTC jar files will download to your workstation as quickly as possible.



Note Make sure all cards that are part of a protection group (1+1, 1:1, or 1:N) are active on the working card of that protection group and that no protection switches are occurring. In other words, make sure that the protect cards are in standby before proceeding.



Step 1 To ensure database synchronization, run the memAudit utility:

a. Close all active telnet connections to the ONS 15454.

b. Copy the memAudit.exe from the ONS 15454 software CD or the following Cisco.com web page to a folder on your hard drive:

http://www.cisco.com/pcgi-bin/tablebuild.pl/ons15454

c. In a command window, change the prompt to the folder where the memAudit.exe is located.

d. At the prompt, type the following command:

memAudit <nodename or IP address>


Note Optional parameters exist for the memAudit command. For more information about the memAudit utility, view the memAudit_readme.htm file on the CD or Cisco.com web page.


Step 2 Log into a node.

Step 3 Record the IP address of that node.

Step 4 Verify that the node has no new alarms. If alarms exist, clear them before proceeding.

Step 5 From the CTC node view, click the Maintenance > Software tabs.

Step 6 Verify that the protect version is 3.4.x.

Step 7 Click Activate. The Activate dialog box appears with a warning message.

Step 8 Click Yes to proceed with the activation. The "Activation Successful" message appears when the software is successfully activated.

Step 9 Click OK to begin the node rebooting process.

Step 10 After activating the node, wait until the software upgrade reboot finishes at that node before continuing. A system reboot (SYSBOOT) alarm is raised while activation is in progress. Once all cards have reset, this alarm clears.

Each card in the node reboots, beginning with the standby TCC+. Once the standby TCC+ is fully activated and fully rebooted, it becomes the active TCC+ and the other TCC+ reboots. When the TCC+s are finished, the XC/XCVT, or XC10G, in Slot 8 reboots, and then the XC/XCVT, or XC10G, in Slot 10 reboots. Next, the Ethernet cards reset all at once, then the line cards boot consecutively from left to right. The whole process can take up to 30 minutes, depending on how many cards are installed. This process is service affecting, so Cisco recommends that you activate the new load during a maintenance window. TDM traffic can endure a hit of up to 50 ms. Expect Ethernet traffic to remain down from the time the TCC+s switch to the time all Ethernet cards have finished resetting. Once all the cards finish rebooting and all alarms clear, you can safely proceed to the next step. (If you are upgrading remotely and cannot see the nodes, wait 30 minutes for the process to complete, then check to ensure all alarms have cleared before proceeding.)


Note Steps 10 to 12 are only necessary after upgrading the first node. For the remaining nodes, you will still be disconnected and removed to the network view during the node reboot, but after the reboot is complete, CTC will restore connectivity to the node.


Step 11 In CTC, choose File > Exit.

Step 12 Follow all steps in the "DLP-461 Delete Cached JAR Files" task. When you have performed all of the steps in that task, continue here with the next step (Step 12).

Step 13 Reconnect to CTC using the IP address from Step 2 (if the IP address is still in the browser location bar you can simply hold down the shift key and click the browser Reload/Refresh button). The new CTC applet for Release 3.4.x uploads. Because CTC Release 3.4.x is backwardly compatible with CTC Release 3.x, it affords you network visibility while you are upgrading.


Note Only activate one node at a time.


Step 14 Log into each of the remaining nodes and perform the "DLP-U19 Activate the New Load" task. The activation must be performed for every node that is running software Release 3.x. Allow each node to finish (all alarms cleared for 10 minutes) before activating the next node.

Step 15 You have completed the activation task when you have activated all nodes with the Release 3.4.x software. If you performed a BLSR lockout before you began activation, you must now perform the "DLP-462 Remove the BLSR Lockout" task. Otherwise, go to the "DLP-463 Set the Date and Time" task.


DLP-461 Delete Cached JAR Files

Purpose

When you upgrade or revert to a different CTC software load, you must reload CTC to your browser. Before you can reload CTC you must ensure that previously-cached files are cleared from your browser and hard drive.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-U19 Activate the New Load

Required/As Needed

Required

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 Delete cache files from your browser directory.

In Netscape:

a. Choose Edit > Preferences > Advanced > Cache.

b. Click Clear Memory Cache.

c. Click OK.

d. Click Clear Disk Cache.

e. Click OK twice.

In Microsoft Internet Explorer:

a. Choose Tools > Internet Options > General.

b. Choose Delete Files.

c. Select the Delete all offline content checkbox.

d. Click OK twice.

Step 2 Close your browser.


Note You will not be able to delete cached jar files from your hard drive until you have closed your browser. If you have other applications open that use jar files, you must also close them.


Step 3 Delete cached files from your workstation (Windows systems only).

a. In your Windows start menu, choose Settings > Control Panel > System > Advanced.

b. Click Environment Variables. This will show you a list of user variables and a list of system variables.

c. In the list of user variables, look for the variable "TEMP." The value associated with this variable is the path to your temporary directory where jar files are stored.

d. Open the "TEMP" directory located in the path you just looked up.

e. Select View > Details.

f. Select and delete all files with "jar" in either the name or type field.

Step 4 Reopen your browser. You should now be able to connect to CTC.

Step 5 After deleting cached jar files, you should return to the referring task, either the "DLP-U19 Activate the New Load" task, or the "DLP-466 Revert to Protect Load" task, and continue with the steps there.


DLP-462 Remove the BLSR Lockout

Purpose

Release the span lockouts on all BLSR nodes after the new software load is activated on all nodes. This task restores a BLSR using Release 3.4.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-461 Delete Cached JAR Files; DLP-U19 Activate the New Load

Required/As Needed

Required for BLSR

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 In CTC node view, click the Maintenance > BLSR tabs.

Step 2 For each of the BLSR trunk cards (OC-12, C-48, or OC-192), go to the row in the table for that card and perform the following steps:

a. Click in the West Switch column to show the pull-down menu.

b. From the menu options, choose Clear.

c. Click Apply to activate the command.


Note When removing a lockout, be sure to apply your changes after each time you choose the Clear option. If you try to select Clear for more than one lockout at a time, you risk traffic loss on the first ring switch.


d. In the same row, click in the East Switch column to show the pull-down menu.

e. From the menu options, choose Clear.

f. Click Apply to activate the command.

Step 3 When all BLSR span lockouts are released, you have completed this task and should go to the "DLP-463 Set the Date and Time" task.


DLP-463 Set the Date and Time

Purpose

If you are not using SNTP, the upgrade procedure can cause the Date/Time setting to change. Perform this task to reset the date and time at each node.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-462 Remove the BLSR Lockout, if required; otherwise, DLP-461 Delete Cached JAR Files and DLP-U19 Activate the New Load

Required/As Needed

As needed

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note If you are using SNTP, you do not need this task and can go to the "DLP-464 Upgrade Spare TCC+ Units" task.



Step 1 In CTC node view, click the Provisioning > General tabs.

Step 2 Set the correct date and time, then click Apply.

Step 3 Repeat Steps 1 and 2 for each remaining node.

Step 4 When all nodes have the correct date and time settings, go to the "DLP-464 Upgrade Spare TCC+ Units" task.


DLP-464 Upgrade Spare TCC+ Units

Purpose

Upgrade all spare TCC+ units to Release 3.4.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-462 Remove the BLSR Lockout if required; otherwise, DLP-U19 Activate the New Load and DLP-461 Delete Cached JAR Files

Required/As Needed

Required for all spare TCC+ cards

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 To upgrade a spare TCC+, place it in the standby slot of a node running Release 3.4.x. The card will upgrade automatically from the active TCC+.

The standby TCC+ will copy one or both software releases from the active TCC+, as needed. Each software copy takes about 15 minutes, and the TCC+ will reset after each copy. Thus, for a TCC+ that has no matching software with the active TCC+, you should expect to see two TCC+ resets, lasting about 30 minutes total.


Note During the TCC+ upgrade, the LEDs on the upgrading card will flash alternately between "fail" and "standby."


Step 2 Once you have upgraded all of your spare TCC+ units, you have completed the software upgrade.


Note If you need to upgrade your cross connect cards, please refer to the user documentation for the software you are currently running. This procedure can be performed before or after the software upgrade; however, you must also refer to the user documentation for details on hardware requirements for the XC10G before upgrading to this card type.



NTP-407 Revert to Previous Load

Purpose

Return to the exact software and database provisioning you had before you activated Release 3.4.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade, NTP-405 Back Up the Database, and NTP-406 Upgrade the Software (up to and including the "DLP-U19 Activate the New Load" task, and the "DLP-462 Remove the BLSR Lockout" task, if applicable)

Required/As Needed

As needed

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note The tasks to revert to a previous load are not a part of the upgrade. They are provided here as a convenience to those wishing to perform a revert after an upgrade. If you have performed all necessary procedures up to this point, you have finished the software upgrade.



Note Before you upgraded from Release 3.x to Release 3.4.x software, you should have backed up the existing database at all nodes in the network (this is part of the "NTP-405 Back Up the Database" procedure). Cisco recommends that you record or export all critical information to your hard drive. If you need to revert to the backup database, use the following tasks, in order.



Step 1 Complete the "DLP-465 Perform a BLSR Lockout" task (BLSR only).

Step 2 Complete the "DLP-466 Revert to Protect Load" task.

Step 3 Complete the "DLP-467 Remove the BLSR Lockout" task (BLSR only).


Note The "DLP-468 Manually Restore the Database" task is provided for reference only. Do not complete this task unless an attempt to revert has failed.


Step 4 Once you have completed the necessary steps above, the revert is complete.


DLP-465 Perform a BLSR Lockout

Purpose

If you have a BLSR provisioned, before beginning the revert you must perform a span lockout at each node. Perform this task to issue a span lockout on a BLSR using CTC Release 3.4.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade, NTP-405 Back Up the Database, and NTP-406 Upgrade the Software (up to and including the "DLP-U19 Activate the New Load" task, and the "DLP-462 Remove the BLSR Lockout" task)

Required/As Needed

Required for BLSR only

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 If you have a BLSR provisioned, before beginning the revert you must perform a span lockout at each node. Follow the "DLP-465 Perform a BLSR Lockout" task to perform a span lockout on a BLSR using CTC Release 3.4.x.


Note Leave the BLSR in the lockout state until you have finished reverting all nodes.


Step 2 Once you have performed the BLSR lockout on all BLSR nodes, perform the "DLP-466 Revert to Protect Load" task.


DLP-466 Revert to Protect Load

Purpose

Revert to the software you were running prior to the last activation. This task will also restore your database to the provisioning you had prior to the activation.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

NTP-404 Prepare for Release 3.x to Release 3.4.x Upgrade; NTP-405 Back Up the Database; and NTP-406 Upgrade the Software (up to and including the "DLP-U19 Activate the New Load" task, and the "DLP-462 Remove the BLSR Lockout" task, if applicable); DLP-465 Perform a BLSR Lockout (if required)

Required/As Needed

Required for revert

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Note To perform a supported (non service-affecting) revert from Release 3.4.x, the release you wish to revert to must have been working at the time you activated to Release 3.4.x on that node. Also, a supported revert automatically restores the node configuration to its state at the time of the previous activation. Thus, any configuration changes made after activation will be lost when you revert the software.



Step 1 From the node view, click the Maintenance > Software tabs.

Step 2 Verify that the protect software displays 3.x (the release you upgraded from).

Step 3 Click Revert. Revert activates the protect software and restores the database from the previous load. A dialog box asks you to confirm the choice.

Step 4 Click OK. This begins the revert and drops the connection to the node.

Step 5 After reverting the node, wait until the software revert finishes at that node before continuing.


Note Be patient. The system reboot might take up to 30 minutes to complete.


Step 6 Shut down your Netscape or Internet Explorer browser.

Step 7 Wait one minute before restoring another node.


Note Because you upgraded to JRE 1.3.1.02, you cannot log into an ONS 15454 running Release 2.2.1 or prior (or an ONS 15327 running Release 1.0.0). If you are reverting to a release that required a previous version of JRE, you will need to reinstall Java and delete the jar files from your workstation's system "temp" directory after reverting all of the nodes in the network. If you are reverting to a release that also uses JRE 1.3.1.02, or if you retained your older version of JRE during the upgrade, this will not be an issue.


Step 8 After reverting all of the nodes in the network, restart the browser and log back into the last node that was reverted. This uploads the appropriate CTC applet for Release 3.x to your workstation.


Note It might also be necessary to delete cache files from your browser's directory, or from the "temp" directory on your MS Windows workstation. If you have trouble reconnecting to CTC, see the "DLP-461 Delete Cached JAR Files" task.


Step 9 After reverting all nodes, remove any BLSR lockout using the "DLP-467 Remove the BLSR Lockout" task.


DLP-467 Remove the BLSR Lockout

Purpose

To restore BLSR protection you must clear the span lockouts on all BLSR nodes after reverting the software load and restoring the database on all nodes. Use the following task to restore a BLSR using Release 2.2.x.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-465 Perform a BLSR Lockout, and DLP-466 Revert to Protect Load

Required/As Needed

Required for BLSR

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Step 1 To restore BLSR protection you must clear the span lockouts on all BLSR nodes after reverting the software load and restoring the database on all nodes. Complete the "DLP-462 Remove the BLSR Lockout" task to restore a BLSR using Release 3.x.

You have now completed the software revert procedure. All nodes should be provisioned as they were before the last activation; however, in case of trouble, Cisco provides the "DLP-468 Manually Restore the Database" task to retrieve your databases.


DLP-468 Manually Restore the Database

Purpose

The revert task should have restored your Release 3.x database completely; however, as a precaution, Cisco includes here the steps to restore the pre-upgrade database manually.

Tools/Equipment

PC or UNIX workstation

Prerequisite Procedures

DLP-466 Revert to Protect Load, and DLP-467 Remove the BLSR Lockout (if required)

Required/As Needed

Required for Release 2.2.0 database restoration after a revert; otherwise, as needed

Onsite/Remote

Onsite or remote (but in the presence of the workstation)



Caution Do not perform these steps unless the software revert failed.


Caution This process is service affecting and should be performed during a service window.


Step 1 From the CTC node view, click the Maintenance > Database tabs.

Step 2 Click Backup. The "Open..." dialog box appears.

Step 3 Select the previously-saved file and choose Open.

The database will be restored and the TCC+s will reboot.

Step 4 Once the TCC+s have rebooted, log back into CTC and verify that the database is restored.

Step 5 Wait one minute before restoring the next node.

You have now completed the manual database backup.