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 all procedures before you begin the upgrade.

Caution This upgrade is supported only for Software Releases 5.x or 6.x upgrading to Release 6.2.

Document Procedures

Procedures in this document 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 15310-CL, you might want to check off each procedure on your printed copy of this document as you complete it.

Each non-trouble procedure (NTP) is a list of steps designed to accomplish a specific procedure. Follow the steps until the procedure is complete. If you need more detailed instructions, refer to the detail-level procedure (DLP) specified in the procedure steps. Throughout this guide, NTPs are referred to as "procedures" and DLPs are termed "tasks." Every reference to a procedure includes its NTP number, and every reference to a task includes its DLP number.

The DLP (task) supplies additional task details to support the NTP. The DLP lists numbered steps that lead you through completion of a task. Some steps require that equipment indications be checked for verification. When the proper response is not obtained, a trouble clearing reference is provided. This section lists the document procedures (NTPs). Turn to a procedure for applicable tasks (DLPs).

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

Step 4 If you have multiple ONS 15310-CL 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 15310-CL Reference Manual for LAN-connection suggestions.

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. (Cisco recommends that you use the IP address of the node and the date, for example 1010120192061103.db.)

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

Step 8 (Optional) Cisco recommends that you manually log critical information by either writing it down or printing screens where applicable. 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 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 superuser.

Inventory; do a print screen from the inventory window.

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

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

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

Note You can only activate one node at a time; however, you can begin activation of the next node as soon as the controller cards for the current node have rebooted successfully.

Step 4 (Optional) If you wish to ensure that a software revert to the previous software release will no longer be possible, complete the "DLP-U214 Download Release 6.2 Software" task for all nodes, or groups of nodes you are upgrading a second time.

Caution If you download the Release 6.2 software a second time following activation you will never be able to revert to the previous software version.

Note The CTX-CL card has two flash RAMs. An upgrade downloads the software to the backup RAM on the CTX-CL card. 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 From the View menu, choose Go to Network View.

Step 2 Verify that the alarm filter is not on:

a. Click the Alarms tab.

b. Click the Filter tool at the lower-right side of the bottom toolbar. Alarm filtering is enabled if the tool is depressed (selected) and disabled if the tool is raised (not selected).

Step 3 On the Alarms tab, check all nodes 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 4 Return to node view and click the Maintenance > Software tabs.

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

Step 6 Browse to locate the software files on the ONS 15310-CL software CD or on your hard drive, if you are working from a local copy.

Step 7 Open the "Cisco15310-CL" folder.

Step 8 Choose the file with the ".pkg" extension and click Open.

Step 9 In the list of compatible nodes, select the check boxes for all nodes you are downloading the software to.

Note Cisco advises that you limit concurrent software downloads on an SDCC to 8 nodes at once, using the central node to complete the download.

Note If you attempt more than eight concurrent software downloads at once, the downloads in excess of eight will be placed in a queue.

Note Cisco recommends you run the optional Cache Loader pre-caching utility in Step 13 or the activation task. If you do not plan to run the pre-caching utility, Cisco recommends that the first node you activate be a LAN-connected node. This ensures that the new CTC JAR files download to your workstation as quickly as possible.

Step 1 Record the IP address of the node. The IP address is on the upper left corner of the CTC window.

Step 2 Verify that the alarm filter is not on:

a. Click the Alarms tab.

b. Click the Filter tool at the lower-right side of the bottom toolbar.

Alarm filtering is enabled if the tool is depressed (selected) and disabled if the tool is raised (not selected).

Step 3 On the Alarms tab, check all nodes for existing alarms. Resolve any outstanding alarms before proceeding.

Step 4 Click the Maintenance > Software tabs.

Step 5 Verify that the protect version is 6.2 (the release you are upgrading to).

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

Note When you click Yes, CTC will lose connection to the node and will display the network view.

Step 8 After activating the node, the software upgrade reboot occurs as follows:

•Each card in the node resets, beginning with the expansion card. The CTX-CL card will then reset and come back up. When the CTX-CL is finished, the Ethernet card comes back up, followed by reset of the Electrical and optical ports. The whole process can take up to 8 minutes, This process is service affecting, so Cisco recommends that you activate the new load during a maintenance window. Time-division multiplexing (TDM) traffic can endure a hit of up to 50 ms. Expect Ethernet traffic to remain down from the time the expansion card resets, until all cards have finished resetting and come back up (this will take 3 to 8 minutes).

After the common control cards finish resetting and all associated alarms clear, you can safely proceed to the next step. (If you are upgrading remotely and cannot see the nodes, wait for 5 minutes for the process to complete, then check to ensure that related alarms have cleared before proceeding.)

Caution The upgrade process is service affecting, so Cisco recommends that you activate the new load during a maintenance window. Time-division multiplexing (TDM) traffic can endure a hit of up to 50 ms. Ethernet traffic may remain down from the time the 15310-CL-CTX cards switch to the time all Ethernet cards have finished resetting.

Note You must ensure that CTC is closed before clicking the "Delete CTC Cache" button. CTC behavior will be unreliable if the button is clicked while the software is still running.

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

Step 12 Close your browser and then reopen it.

Step 13 (Optional) Run the Cache Loader pre-caching utility, which can improve your speed logging back into CTC after an upgrade. Perform the following steps to run the Cache Loader.

a. Load the Release 6.2 CD into your CD-ROM drive. If the directory of the CD does not open automatically, open it.

g. When the utility finishes, click OK, and then in the wizard, click Finish.

Step 14 Reconnect to CTC using the IP address from Step 1. The new CTC applet for Software R6.2 uploads. During this logon, type the user name CISCO15. A password is not required.

Note Steps 9 through 14 are only necessary after upgrading the first node in a network because cached files only need to be removed from your workstation once. 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 15 Return to your originating procedure (NTP).

DLP-U216 Delete Cached JAR Files

Purpose

This task manually deletes cached JAR files from your browser and hard drive. 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.

NTP-116 Install Public-Key Security Certificate

This procedure installs the ITU Recommendation X.509 public-key security certificate. The public-key certificate is required to run Software R4.1 or later.

Tools/Equipment

None

Prerequisite Procedures

This procedure is performed when logging into CTC. You cannot perform it at any other time.

Required/As Needed

This procedure is required to run ONS 15310-CL software.

Onsite/Remote

Onsite or remote

Security Level

Provisioning or higher

Step 1 Log into CTC.

Step 2 If the Java Plug-in Security Warning dialog box appears, choose one of the following options:

•Grant This Session—Installs the public-key certificate to your PC only for the current session. After the session is ended, the certificate is deleted. This dialog box will appear the next time you log into the ONS 15310-CL.

•Deny—Denies permission to install the certificate. If you choose this option, you cannot log into the ONS 15310-CL.

•Grant always—Installs the public-key certificate and does not delete it after the session is over. Cisco recommends this option.

•View Certificate—Allows you to view the public-key security certificate.

After you complete the security certificate dialog boxes, the web browser displays information about your Java and system environments. If this is the first login, a CTC downloading message appears while CTC files are downloaded to your computer. The first time you connect to an ONS ONS 15310-CL, this process can take several minutes. After the download, the CTC Login dialog box appears.

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 to Software R6.2, you should have backed up the existing database at all nodes in the network (this is part of the "NTP-U138 Back Up the Software 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 Log into the node. For detailed instructions, refer to the Cisco ONS 15310-CL Procedure Guide. If you are already logged in, continue with Step 2.

Note To perform a supported (non-service-affecting) revert from Software R6.2, the release you want to revert to must have been working at the time you activated to Software R6.2 on that node. Also, a supported revert automatically restores the node configuration at the time of the previous activation. Thus, any configuration changes made after activation will be lost when you revert the software. The exception to this is when you have downloaded Release 6.2 a second time, to ensure that no actual revert to a previous load can take place. In this latter case, the revert will occur, but will not be traffic affecting and will not change you database.

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

Step 2 Verify that the protect software displays 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 Yes. This begins the revert. CTC drops the connection to the node and takes you to the network view, displaying a confirmation dialog box.

Step 5 Click OK and wait until the software revert finishes before continuing.

Note The system reboot might take up to 4 minutes to complete.

Step 6 Wait one minute before reverting another node.

Step 7 After reverting all of the nodes in the network, close and restart your Netscape or Internet Explorer browser and log back into the last node that was reverted. This uploads the appropriate CTC applet to your workstation.

Note It might also be necessary to delete cached 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-U216 Delete Cached JAR Files" task.

Step 8 Return to your originating procedure (NTP).

DLP-U184 Manually Restore the Database

Purpose

This task manually restores the database. If you were unable to perform a revert successfully and need to restore the database, perform this task.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

Subscribe to the What's New in Cisco Product Documentationas a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.