Table Of Contents
Upgrading Cisco ONS 15454 Release 2.2.x to 2.3.4 Using the TCC Card
This document explains how to upgrade Cisco ONS 15454's Cisco Transport Controller (CTC) software from Release 2.2.x to Release 2.3.4 using the Timing, Communications, and Control (TCC) card.
Before beginning, write down the following information about your site; the data will be useful during and after the upgrade: Date, Node Name, Node Location, Street Address, Site Phone Number, Node IP Address, Subnet Mask, Dial Up Number, and Node ID.
Caution Read each procedure before you begin the upgrade.
Note After you upgrade to Release 2.3.4 you will no longer be able to upgrade to any post-2.3.4 release earlier than 3.2.1. Cisco recommends that you plan your upgrades accordingly.
This section contains critical information that you must read before the upgrade process.
Read the Release Notes for Cisco ONS 15454 Release 2.3.4 before you begin this upgrade procedure.
Caution Use this document with the TCC card only. To upgrade using the TCC+ card, see Upgrading Cisco ONS 15454 Release 2.2.x to 2.3.4 Using the TCC+ Card.
Note Upgrading to a new CTC release can create limitations to your ability to use the Cisco Transport Manager (CTM). If you are using CTM, before you choose to upgrade to a new CTC release you should check the latest CTM Release Notes for any possible compatibility issues. The CTM Release Notes can be found at:
CTC Workstation Requirements
Before upgrading the workstation to run CTC Release 2.3.4, verify all hardware and software requirements.
•A Windows or Unix workstation:
–IBM-compatible PC with a 486 or higher processor, CD ROM drive, and 128 MB RAM running Windows 95, Windows 98, Windows 2000, or Windows NT
–UNIX workstation running Solaris
•Direct connection to the ONS 15454 using 10baseT Ethernet Network Interface Card (NIC) and Ethernet Cable (use the CAT 5 10baseT Patch cable to connect to the TCC)
•Browser software (select one):
–Netscape Navigator 4.08 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
•Java Policy File and Java Runtime Environment file (included on the ONS 15454 software CD)
IP Address Caveat
Disable all other Ethernet devices (such as a dial-up adapter) on the workstation that runs CTC.
If you have multiple IP addresses on your workstation, you must remove them; you cannot install CTC Release 2.3.4 if multiple IP addresses are running.
If you have multiple ONS 15454 nodes configured in the same IP subnet, only one can be connected to a router. Otherwise, the remaining nodes might be unreachable. Refer to the Cisco ONS 15454 User Documentation, Release 2.2.1 for LAN-connection suggestions.
Valid Craft Port
The front-panel Ethernet interface is changed in Release 2.0.
The permanent wire-wrap LAN connection on the backplane will communicate with the node if either TCC (A or B) is active or if the front-panel TCC connection is used.
When using Release 2.2.0 or greater you can connect through either of the TCC RJ-45 ports regardless of which one is active.
Memory Chip Verification
Hyundai DRAM chips could potentially cause failure of software downloads to the TCC. This failure is related to a specific DRAM chip that was introduced in manufacturing between 9/29/1999 and 11/1/1999. The affected TCC modules are exclusive to the serial number ranges of 31550 and 45500 and FAA04280001 through FAA0430A4BA. There are other cards within this range of serial numbers that do not contain the specified component and are not affected by this issue. Any TCCs in the specified serial number ranges should be inspected for the failing component using the following procedure.
Note Do not screen in-service nodes; this procedure is potentially traffic-affecting. For all in-service nodes, screen for Hyundai DRAM during a maintenance window.
Step 1 From the CTC node view, right-click the standby TCC card and choose Reset.
Step 2 While the standby TCC card reboots, physically remove it from the shelf.
Step 3 Turn the TCC card over.
Step 4 Look in the lower left-hand quarter of the card and locate the U30 and U35 memory chips. Look for HYxxxxxxxxx or NEC Japan.
Step 5 If you have the HY type chips, replace the TCC with a TCC that does not have the HYxxxxxxxxx chips. Allow the card to boot up and come back online.
Step 6 From the CTC node view, right-click the active TCC card and choose Reset.
Step 7 While the active TCC card reboots, physically remove the card from the shelf.
Step 8 Repeat Steps 3 through 5 for the active TCC.
Step 9 If you encounter any of these defective cards, call the Technical Assistance Center (TAC) at 1 877 323-7368 and obtain an RMA number for each.
Make sure all active telnet sessions to any node in the network are closed.
A new superuser, CISCO15, was added to Release 2.2.0.
If any of your nodes has an AIP board with the part number 67-11-00015 or 67-11-00002, the board must be replaced. Perform the following steps to ensure that all of your AIP boards are good.
Step 1 Look at the back of your ONS 15454 node and locate the green board with "AIP" stamped into the right hand side (the writing will be sideways as you face the board).
Step 2 Locate the sticker with the part number. The number should be preceded by "P/N" on the sticker.
Note If there is no sticker with a part number, the number may be stamped into the board itself. If you cannot find the part number, you must contact the Technical Assistance Center (TAC) at 877 323-7368 for assistance.
Step 3 If the part number is any number other than 67-11-00015 or 67-11-00002, go to the next node and start from Step 1 again.
Step 4 If the part number is 67-11-00015 or 67-11-00002, contact the TAC at 877 323-7368 to request a Return Materials Authorization (RMA).
Step 5 Repeat Steps 1 - 4 for every node.
You have completed the AIP verification. Before you upgrade your CTC software you must now back up the database for each node you will upgrade.
Back Up the Database
Before upgrading from Release 2.2.x to Release 2.3.4 software, you must back up the current database for all nodes in the network.
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. The File Received dialog box appears.
Step 6 Click OK.
Cisco recommends that you manually log critical information by either writing it down or printing screens where applicable. This step is optional after you have backed up the database. Use the following table to determine the information you should log; complete the table (or your own version) for every node in the network.
Upgrade the Software
After backing up the database and logging all of the required information, insert the Release 2.3.4 software CD into the workstation and begin the upgrade process. You must upload and activate the software.
Caution Do not perform maintenance or provisioning activities during the upgrade process.
There are two flash RAMs on the TCC card. An upgrade uploads the software to the backup RAM on both the backup and active TCCs. This procedure does not affect traffic because the active software continues to run at the primary RAM location; therefore, you can upload the software at any time.
To upgrade from Release 2.2.x to 2.3.4 using TCC cards, you must run the vfix.exe utility to patch the running software. The script must always be run prior to activation when a TCC is running Release 2.2, 2.2.1, or 2.2.2. This does not apply to TCC+ cards or software reverts.
Run the Script
The vfix.exe utility runs on any win32 based PC. The utility requires IP connectivity from the PC to the ONS 15454 that will receive the patch.
This procedure is only necessary with upgrades for TCC. If you are upgrading with TCC+s, you can skip this procedure and continue with the "Upload" section.
Running the script takes approximately 2 to 3 minutes.
Caution Do not run the script on more than one node and one workstation at the same time.
Step 1 Using CTC Release 2.2.x, log into the farthest node from the node connected to the workstation.
Step 2 Check the ONS 15454 for existing alarms. Resolve any outstanding alarms before proceeding.
Step 3 Close all active telnet connections to the ONS 15454.
Step 4 Run the script:
In a command window, from the CD software "Cisco15454" directory, run vfix.exe using the IP address (or node name) of the node you are running the script on.EXAMPLE G:\Cisco15454> vfix 172.16.17.18
This step takes approximately 5-10 seconds. When the script has completed successfully, a "Successfully applied TCC compatibility patch" message appears.
Step 5 Close CTC and then reconnect to the same node you were previously connected to (farthest from the node you ran the script on).
Step 6 Repeat Steps 1-5 for each node you are upgrading.
Note Rerun the script if at any time the active/standby TCC reboots before the Release 2.3.4 load is activated.
Caution Because of bandwidth considerations, do not upload software to more than three nodes with one workstation at the same time.
Step 1 Check all nodes in the ring for existing alarms. Resolve any outstanding alarms before proceeding.
Step 2 Ensure that no outstanding alarms are being declared against any synchronization facility. Clear any minor, major, or critical alarms on synchronization facilities before proceeding.
Note Information alarms are blue in color; you can disregard these.
Note During the software upgrade process, an alarm indicates that the software upgrade is taking place. This is normal and clears when the upgrade is complete.
Step 3 Using CTC Release 2.2.x, log into the node that is farthest from your workstation.
Step 4 From the CTC node view, click the Maintenance > Software tabs.
Step 5 Click Upgrade. The Software Upgrade dialog box opens.
Step 6 Click Open to locate the software files in the CD drive. The File Upload dialog box opens.
Step 7 From the CD drive directory, open the ONS 15454 folder.
Step 8 Select the file with the ".pkg" extension and click Open. The Software Upgrade dialog box opens.
Step 9 Click Upgrade.
Note CTC will display the node view and a pop-up status window so you can monitor the file transfer. A message indicating that your files transferred successfully will appear after the software has finished loading. The upgrade process can take 30 minutes or more.
Caution Do not close CTC during the upgrade. Closing CTC will abort the upgrade process.
Before You Activate
BLSR Nodes Only
If the node is in a bidirectional line switched ring (BLSR) configuration, you must complete the following steps before activating the new load.
Step 1 Perform a ring lockout to prevent switches from occurring during the upgrade.
a. Click the Maintenance > Ring tabs.
b. Right-click on one of the trunk cards (OC12 or OC48) and choose Ring Lockout from the pull-down menu.
c. Click Apply to activate the command. Leave the node in this state until the software is activated.
Note A Default K alarm or alarms on the protect STS timeslots can occur during this lockout period. Ignore these alarms if they occur.
Step 2 Repeat Step 1 at every node in the BLSR.
Step 3 Using CTC, reset each BLSR trunk card (OC12/OC48) one at a time.
Note If a card does not reset, do not continue with the activation process. Physically reseat the card if necessary. If you need to reseat the card or cards, make sure you first release all lockouts on protection switches. Once the card is rebooted and active, issue the lockouts again.
Step 4 Repeat Step 3 at every node in the BLSR.
Perform the following steps for all nodes in the network. Begin with the farthest node out and work in towards the node hosting CTC (your workstation).
Step 1 From the CTC node view, right-click the STBY TCC and choose Reset from the pop-up menu.
Step 2 Before activating the new load, wait for the standby TCC to come back up. If the card is visible, wait for the green SYNC LED on the standby TCC to light up. If the card is not visible, wait two or three minutes after the standby TCC's reset alarm clears before activating the new load.
Step 3 Make sure all cards that are part of a protection group (1:1 and 1:N) are active on the working card of that protection group and that no protection switches are occurring. In other words, make sure protect cards are in standby before proceeding.
Step 4 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 to a folder on your hard drive.
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.
Activate the New Load
Log in and activate each node beginning with the farthest node in the network and ending with your workstation node.
Caution Temporary traffic interruption is possible during software activation.
Step 1 Log into the node farthest from the node you are connected to.
Step 2 Verify that the node has no active alarms.
Step 3 From the CTC node view, click the Maintenance > Software tabs.
Step 4 Verify that the protect software displays 2.3.4.
Step 5 Click Activate. The Activate dialog box appears with a warning message.
Step 6 Click Yes to proceed with the activation.
Step 7 After activating the node, wait until the software upgrade finishes at that node before continuing.
Activation proceeds from the node through each card installed, 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. Then the XC or XCVT and AIC reboot; next, the line cards boot from left to right one by one. The whole process takes approximately 30 minutes. This process is traffic affecting, so Cisco recommends that you activate the new load during a maintenance window. TDM traffic may endure a 50 ms or less hit, and Ethernet traffic will take about a 3 to 4 minute hit due to STP recalculation. After all cards have booted, the active XCVT boots again to ensure that all circuits are updated correctly. Once the active XCVT finishes this final reboot and all alarms clear you can safely proceed to the next step.
Step 8 Shut down and restart your Netscape or Internet Explorer browser.
Step 9 Reconnect to CTC using the IP address from Step 2. The new CTC applet for Release 2.3.4 uploads. This applet gives you network visibility while you are upgrading.
Note Only activate one node at a time.
Step 10 Log into each of the remaining nodes and activate them one at a time. Make sure each node is finished and clear of alarms for ten minutes before activating the next node.
Step 11 After each node is finished, you must log out of your CTC session in Netscape to download the new Java plug-ins from the ONS 15454 node.
Step 12 After activating the last node (the node connected to your workstation) wait for the system to reboot.
Note Be patient. The system might take several minutes to reboot.
Release the span lockouts on all BLSR nodes after the new software load is activated on all nodes.
Step 1 In CTC node view, click the Maintenance > Ring tabs.
Step 2 Select the direction where the lockout is active.
Step 3 Select Clear.
Step 4 Click Apply to activate the command.
Step 5 You might need to invoke the ring map table and accept it to clear Default K byte or Node ID mismatch alarms. Go to the Ring tab and click the Ring Map button. Accept the ring map.
The upgrade procedure can cause the Date setting to change.
Step 1 In CTC node view, click the Provisioning > General tabs.
Step 2 Set the correct date and click Apply.
Step 3 Repeat Steps 1 and 2 for each remaining node.
Spare TCC Units
All spare TCC units should be upgraded to CTC Release 2.3.4 software.
Step 1 Determine the standby TCC; the yellow STBY LED is illuminated.
Step 2 Physically remove the standby TCC.
Step 3 Insert the spare TCC in the unoccupied TCC slot and allow it to boot up.
The TCC automatically upgrades to the software version on the active TCC. This automatic upgrade can take about 30 minutes and LEDs flash during this process. The TCC that you removed can be used as the spare.
XC to XCVT Upgrade
This procedure explains how to replace dual XC cards with dual XCVT cards without affecting traffic.
The procedure requires that the ONS 15454 is running CTC Release 2.2.0 or later. The node also needs two XC cards installed and two XCVT cards available.
Step 1 Determine the standby XC card. The ACT/STBY LED of the standby XC card is yellow and the ACT/STBY LED of the active card is green.
You can also put the mouse cursor over the card graphic in CTC to reveal a tooltip displaying Active/Standby status.
Step 2 Unlatch the top and bottom ejector levers of the STANDBY XC card. Remove the card from the slot and put it away.
Step 3 Insert the first XCVT into the empty slot and latch the ejectors.
The red FAIL LED on the card illuminates, blinks for several seconds, then turns off. The ACT/STBY LED turns yellow and stays on.
Step 4 In CTC node view click the Maintenance > XC Cards tabs.
Step 5 Choose Manual from the menu for the Slot X on the active XC card.
Step 6 Click Apply.
A minor alarm appears on the manually-switched slot.
Step 7 On the same slot, choose Clear from the pull-down menu to remove the manual operation.
Step 8 Click Apply.
The XCVT should now be active as indicated by the green ACT/STBY LED.
Step 9 Remove the second XC card after verifying that it is the standby card.
Step 10 Replace the second XC card with the second XCVT card and allow it to boot up.
Restore the Previous Software and Database
Unexpected catastrophic events during the upgrade might require you to terminate the upgrade process and return to the previous software load and database. The TCC requires two procedures to restore the previous software and database. You should have saved a copy of the database in the "Back Up the Database" section.
Caution This process is traffic affecting and should be performed during a service window.
Manually Restore the Software Load
Step 1 Record the IP address of the node you connected to CTC on.
Step 2 From the node view, right-click the standby TCC and choose Reset. An "Are You Sure" dialog box appears asking you to confirm the choice.
Step 3 Click Yes. The standby TCC reboots.
Step 4 Wait for the TCC to finish rebooting (this will take approximately 4 minutes).
Step 5 From the node view, click the Maintenance > Software tabs.
Step 6 Verify that the protect software displays 2.2.x (the release you were upgrading from).
Step 7 Click Revert. A dialog box asks you to confirm that you wish to revert.
Note On the TCC+, revert activates the protect software and restores the database from the previous load; however, on the TCC, revert only activates the protect software. This is why you must also manually restore the database when restoring with TCC cards.
Step 8 Click OK. This begins the revert and drops the connection to the node.
Step 9 After restoring the software, wait until the downgrade finishes at that node before continuing.
Note Be patient. The system reboot might take up to 30 minutes to complete.
Step 10 Shut down your Netscape or Internet Explorer browser.
Step 11 Wait one minute before restoring another node.
Step 12 After reverting all of the nodes in the network, restart the browser and log back into the last node that was reverted with the IP address that you recorded in Step 1. This uploads the appropriate CTC applet for Release 2.2.x to your workstation.
Manually Restore the Database
Step 1 From the CTC node view, click the Maintenance > Database tabs.
Step 2 Click Backup. The "Open..." dialog box opens.
Step 3 Select the previously-saved file and choose Open.
The database will be restored and the TCCs will reboot.
Step 4 Once the TCCs have rebooted, log back into CTC and verify that the database is restored.
Wait one minute before restoring the next node.
This document is to be used in conjunction with the Release Notes for Cisco ONS 15454 Release 2.3.4 publication.
CCIP, CCSP, the Cisco Arrow logo, the Cisco Powered Network mark, the Cisco Systems Verified logo, Cisco Unity, Follow Me Browsing, FormShare, iQ Net Readiness Scorecard, Networking Academy, and ScriptShare are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, The Fastest Way to Increase Your Internet Quotient, and iQuick Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherSwitch, Fast Step, GigaStack, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, LightStream, MGX, MICA, the Networkers logo, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, RateMUX, Registrar, SlideCast, SMARTnet, StrataView Plus, Stratm, SwitchProbe, TeleRouter, TransPath, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other countries.
All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0303R)
Copyright © 2003, Cisco Systems, Inc.
All rights reserved.