Cisco ONS 15454 Installation and Operations Guide, Release 3.1
Chapter 2, Software Installation

Table Of Contents

Software Installation

2.1 Installation Overview

2.2 Computer Requirements

2.3 Running the CTC Setup Wizard

2.4 Connecting PCs to the ONS 15454

2.4.1 Direct Connections to the ONS 15454

2.4.2 Network Connections

2.4.3 Remote Access to the ONS 15454

2.4.4 TL1 Terminal Access to the ONS 15454

2.5 Logging into the ONS 15454

2.5.1 Creating Login Node Groups

2.5.2 Accessing ONS 15454s Behind Firewalls

2.6 Working with the CTC Window

2.6.1 Node View

2.6.2 Network View

2.6.3 Card View

2.7 CTC Navigation

2.8 Viewing CTC Table Data

2.9 Printing and Exporting CTC Data

2.10 Displaying CTC Data in Other Applications


Software Installation


Cisco Transport Controller (CTC), the Cisco ONS 15454's software interface, is stored on the TCC+ card and download to your workstation each time you log into the ONS 15454. This chapter:

Describes how Cisco Transport Controller (CTC) software is installed on PCs and Solaris workstations

Tells you how to connect PCs and Solaris workstations to the Cisco ONS 15454, including direct connections, LAN connections, remote connections, and firewall-compliant connections

Describes the CTC graphic user interface, including the three main CTC views, network, node, and card

Explains how to create domains to manage multiple nodes, change the network view background color and image (map), and add a node to the network map

Describes the different ways you can invoke commands within CTC

Explains how to print and export CTC data

2.1 Installation Overview

ONS 15454 provisioning and administration is performed using the Cisco Transport Controller software. CTC is a Java application that is installed in two locations:

ONS 15454 Timing Communications and Control card (TCC+)

PCs and Solaris workstations that connect to the ONS 15454

CTC software is pre-installed on the TCC+. The only time you install software on the TCC+ is when you upgrade from one CTC release to another. To upgrade CTC on the TCC+, you must follow the upgrade procedures specific to the software release. These procedures can be downloaded from the Cisco website (www.cisco.com).

For PCs and Solaris workstations, CTC is downloaded from the TCC+ and installed on your computer automatically after you connect to the ONS 15454. To connect to an ONS 15454, you enter the ONS 15454 IP address in the URL field of a web browser, such as Netscape Navigator or Microsoft® Internet Explorer. After connecting to an ONS 15454, the following installation occurs automatically:

1. A CTC launcher applet is downloaded from the TCC+ to your computer's Temp directory. (If these files are deleted, they are reinstalled the next time you connect to the ONS 15454.)

2. The launcher determines whether your computer has a CTC release matching the release on the ONS 15454 TCC+.

3. If the computer does not have CTC installed, or if the installed release is older than the TCC+ version, the launcher downloads the CTC program files from the TCC+.

4. The launcher starts CTC. The CTC session is separate from the web browser session, so the web browser is no longer needed. If you log into an ONS 15454 that is connected to ONS 15454s with older versions of CTC, or to Cisco ONS 15327s, CTC "element" files are downloaded automatically to enable you to interact with those nodes. You cannot interact with nodes on the network that have a software version later than the node that you are logged into. Therefore, always log into nodes having the latest software release.

Each ONS 15454 can handle up to four network-level CTC sessions (the login node and its DCC-connected nodes) and one node-level session (login node only) at one time. CTC performance may vary, depending upon the volume of activity in each session.


Note You can also use TL1 commands to communicate with the Cisco ONS 15454 through VT100 terminals and VT100 emulation software, or you can Telnet to an ONS 15454 using TL1 port 3083. See the Cisco ONS 15454 TL1 Command Guide for a comprehensive list of TL1 commands.


2.2 Computer Requirements

To use CTC in ONS 15454 Release 3.1, your computer must have a web browser with the correct Java Runtime Environment (JRE) installed. The correct JRE for each CTC software release is included on the Cisco ONS 15454 ONS 15454 software CD. If you are running multiple CTC software releases on a network, the JRE installed on the computer must be compatible with the different software releases. Table 2-1 shows JRE compatibility with ONS software releases.

Table 2-1 JRE Compatibility

ONS Software Release
JRE 1.2.2 Compatible
JRE 1.3 Compatible

ONS 15327 Release 1.0

Yes

No

ONS 15327 Release 1.0.1

Yes

Yes

ONS 15454 Release 2.2.1 and earlier

Yes

No

ONS 15454 Release 2.2.2

Yes

Yes

ONS 15454 Release 3.0

Yes

Yes

ONS 15454 Release 3.1

Yes

Yes


Requirements for PCs and Solaris workstations are provided in Table 2-2. A modified java.policy file must also be installed. In addition to Netscape Communicator and the JRE, also included on the ONS 15454 software CD and the ONS 15454 documentation CD are the Java plug-in and modified java.policy file.

Table 2-2 Computer Requirements for CTC

Area
Requirements
Notes

Processor

Pentium II 300 MHz, UltraSPARC, or equivalent

300 Mhz is the recommended processor speed. You can use computers with less processor speed; however, you may experience longer response times and slower performance.

RAM

128 MB

 

Hard drive

2 GB

CTC application files are downloaded from the TCC+ to your computer's Temp directory. These files occupy 3-5 MB of hard drive space.

Operating System

PC: Windows 95, Windows 98, Windows NT 4.0, or Windows 2000

Workstation: Solaris 2.6 or 2.7

 

Web browser

PC: Netscape Navigator 4.51 or higher, or Netscape Communicator 4.61 or higher, or Internet Explorer 4.0 (service pack 2) or higher

Workstation: Netscape Navigator 4.73 or higher

Netscape Communicator 4.73 (Windows) and 4.76 (Solaris) are installed by the CTC Setup Wizard included on the Cisco ONS 15454 software and documentation CDs.

Java Runtime Environment

JRE 1.2.2_05 with Java Plugin 1.2.2 minimum

JRE 1.3.0_C (PC) recommended

JRE 1.3.0_01 (Solaris) recommended

Use JRE 1.2.2_05 if you connect to ONS 15454s running CTC Release 2.2.1 or earlier.

Use JRE 1.3.0 if all ONS 15454s that you connect to are running Release 2.2.2 or later. JRE 1.3.0 is installed by the CTC Setup Wizard included on the Cisco ONS 15454 software and documentation CDs.

Java.policy file

A java.policy file modified for CTC must be installed

A modified java.policy file is installed by the CTC Setup Wizard included on the Cisco ONS 15454 software and documentation CDs.

Cable

User-supplied Category 5 straight-through cable with RJ-45 connectors on each end to connect the computer to the ONS 15454 directly or though a LAN.

 


Note On PCs, the mouse pointer scheme should be set to Windows Standard (Windows 95/98) or None (Windows NT or Windows 2000). To check the settings, choose Settings and then Control Panel from the Windows Start menu. Double-click the Mouse option. From the Pointers tab of the Mouse Properties dialog box, select the Windows Standard (or "none" for NT or Windows 2000) mouse scheme. Click OK.


2.3 Running the CTC Setup Wizard

The ONS 15454 provides a setup wizard that installs the files needed to run CTC on PCs and Solaris workstations. You can run the setup wizard from the Cisco ONS 15454 software CD or from the Cisco ONS 15454 documentation CD. The wizard will install:

Netscape Communicator 4.73 (Windows) or 4.76 (Solaris)

JRE 1.3 (Windows) or JRE 1.3.0.01 (Solaris)

Cisco ONS 15454 online documentation

Modified java.policy file

For Solaris workstations, the JRE may require patches to run properly. You can find the patch tar file in the Jre/Solaris directory on the CD. For information about installing the patches, see the Jre/Solaris/Solaris.txt file on the CD. After installing the patches, if necessary, perform the "Set Up the Environment Variable (Solaris installations only)" procedure and the "Reference the JRE (Solaris installations only)" procedure to set up JRE on the workstation.

Procedure: Run the CTC Setup Wizard


Step 1 Insert the Cisco ONS 15454 Release 3.1 software or documentation CD into your computer CD drive. If the CD directory does not automatically open, open it.

Step 2 Double-click setup.exe (Windows) or setup.bat (Solaris).

Step 3 Follow the on-screen instructions. You can choose to install all components, or select the Custom option to install selected components.


Procedure: Set Up the Environment Variable (Solaris installations only)

Perform one of the following edit procedures. (JRE indicates the destination directory you selected for the JRE.)

If you are using csh, edit the .cshrc file in your home directory by adding:

setenv NPX_PLUGIN_PATH [JRE]/j2rel1_3_0_01/plugin/sparc/ns4

If you are using ksh, edit the .kshrc file in your home directory by adding:

export NPX_PLUGIN_PATH = [JRE]/j2rel1_3_0_01/plugin/sparc/ns4


Procedure: Reference the JRE (Solaris installations only)


Step 1 Run the Control Panel by typing:

[JRE]/j2rel1_3_0_01/bin/ControlPanel

Step 2 Click the Advanced tab.

Step 3 From the combo box, select [JRE]/j2rel1_3_0_01. If the JRE is not found, select other and enter the following in the Path text box:

[JRE]/j2rel1_3_0_01

Step 4 Click Apply.


2.4 Connecting PCs to the ONS 15454

You can connect a PC to the ONS 15454 using the RJ-45 LAN port on the TCC+ or the LAN 1 pins on the ONS 15454 backplane. For a list of LAN pin assignments, see Table 1-2 on page 1-34. Each ONS 15454 must have a unique IP address that you use to access the ONS 15454. The address is displayed on the front panel LCD. The initial IP address, 192.1.0.2, is the default address for ONS 15454 access and configuration. Each computer used to communicate with the ONS 15454 should have only one IP address.


Note Do not use dual network interface cards (NIC) or an enabled NIC card and dial-up adapter at the same time; this hampers communication between CTC and ONS 15454s.


2.4.1 Direct Connections to the ONS 15454

A direct PC to ONS 15454 connection means your computer is physically connected to the ONS 15454. This is most commonly done by connecting a CAT-5 straight-through cable from your PC NIC card to the RJ-45 port on the TCC+. However, direct connections include connections to switches or hubs to which the ONS 15454 is physically connected. To connect to the ONS 15454 with a direction connection, you must:

Set up Windows on your PC for direct connections

Attach cables from the PC to the ONS 15454

Test your connection

Procedure: Creating a Direct Connection to an ONS 15454


Step 1 Attach a CAT-5 cable from the PC NIC card to one of the following:

RJ-45 jack on the ONS 15454 TCC+ card

RJ-45 jack on a hub or switch to which the ONS 15454 is physically connected

Step 2 Use the steps in Table 2-3 to set up Windows for direct connections to an ONS 15454 when:

DHCP (Dynamic Host Configuration Protocol) is not enabled on the ONS 15454 or the ONS 15454 is not connected to a DHCP server. If DHCP is enabled, go to Step 2. (For information about DHCP, see the "Setting Up Network Information" section on page 3-2.)

The ONS 15454 is not connected to a LAN.

Table 2-3 Setting Up Windows 95/98, Windows NT, and Windows 2000 PCs for Direct ONS 15454 Connections

Windows 95/98
Windows NT
Windows 2000

1. From the Windows Start menu, choose Settings > Control Panel.

2. On the Control Panel dialog box, click the Network icon.

3. In the Network dialog box select TCP/IP for your PC Ethernet card, then click Properties.

4. On the TCP/IP Properties dialog box, click the DNS Configuration tab and choose Disable DNS.

5. Click the WINS Configuration tab and choose Disable WINS Resolution.

6. Click the IP Address tab.

7. In the IP Address window, click Specify an IP address.

8. In the IP Address field, enter an IP address that is identical to the ONS 15454 IP address except for the last three digits. The last three digits must be between 1 and 254.

9. In the Subnet Mask field, type 255.255.255.0.

10. Click OK.

11. On the TCP/IP dialog box, click the Gateway tab.

12. In the New Gateway field, type the ONS 15454 IP address. Click Add.

13. Verify that the IP address displays in the Installed Gateways field, then click OK.

14. When the prompt to restart your PC displays, click Yes.

1. From the Windows Start menu, choose Settings > Control Panel.

2. On the Control Panel dialog box, click the Network icon.

3. In the Network dialog box click the Protocols tab, choose TCP/IP Protocol, then click Properties.

4. Click the IP Address tab.

5. In the IP Address window, click Specify an IP address.

6. In the IP Address field, enter an IP address that is identical to the ONS 15454 IP address except for the last three digits. The last three digits must be between 1 and 254.

7. In the Subnet Mask field, type 255.255.255.0.

8. Click OK.

9. On the TCP/IP Properties dialog box, type the ONS 15454 IP address in the Default Gateway field.

10. Click Apply.

11. In some cases, Windows NT will prompt you to reboot your PC. If you receive this prompt, click Yes.

1. From the Windows Start menu, choose Settings > Network and Dial-up Connections > Local Area Connection.

2. On the Local Area Connection Status dialog box, click Properties.

3. On the General tab, choose TCP/IP Protocol, then click Properties.

4. Click Use the following IP address.

5. In the IP Address field, enter an IP address that is identical to the ONS 15454 IP address except for the last three digits. The last three digits must be between 1 and 254.

6. In the Subnet Mask field, type 255.255.255.0.

7. In the Default Gateway field, type the ONS 15454 IP address.

8. Click OK.


Step 3 Test the connection:

a. Start Netscape Navigator or Internet Explorer.

b. Enter the Cisco ONS 15454 IP address in the web address (URL) field. If the connection is established, a Java Console window, CTC caching messages, and the Cisco Transport Controller Login dialog box display. If this occurs, go to Step 2 of the "Log into the ONS 15454" procedure to complete the login. If the Login dialog box does not appear, complete Steps c and d.

c. From the Windows Start menu, choose the MS-DOS or command prompt.

d. At the prompt, type:

ping [ONS 15454 IP address]

For example, you would type "ping 192.1.0.2" to connect to an ONS 15454 with default IP address 192.1.0.2. If your computer is connected to the ONS 15454, a "reply from [IP address]" message displays.

If your PC is not connected, a Request timed out message displays. If this occurs, check that the cables connecting the PC to the ONS 15454 are securely attached. Check the Link Status LED on the PC NIC card. Repeat the procedures provided in Table 2-3 while verifying IP and submask information.


2.4.2 Network Connections

When connecting the PC to the ONS 15454 through a LAN, the PC's IP address must be configured to be on the same subnet as the ONS 15454's LAN interface. The ONS 15454 IP address and netmask are visible on the LCD panel. If needed, change the IP address configuration on the PC or use the LCD panel on the ONS 15454.

Procedure: Access the ONS 15454 from a LAN


Step 1 Change the ONS 15454 IP address to an IP address that exists on the LAN. (See the "Change IP Address, Default Router, and Network Mask Using the LCD" procedure on page 3-4 for instructions.)

Step 2 Ensure that the ONS 15454 is physically connected to the LAN (typically using a cross-over cable to a hub or switch).

Step 3 If you changed the PC network settings for direct access to the ONS 15454, change the settings back to the LAN access settings. Usually this means setting the IP Address on the TCP/IP dialog box back to "Obtain an IP address automatically" (Windows 95/98) or "Obtain an IP address from a DHCP server" (Windows NT/2000). If your LAN requires that DNS or WINS be enabled, change the setting on the DNS Configuration or WINS Configuration tab of the TCP/IP dialog box.

Step 4 If your computer is connected to a proxy server, disable proxy service or add the ONS 15454 nodes as exceptions.

Step 5 Start your web browser and type the ONS 15454 IP address in the URL field.

Procedure: Disable Proxy Service Using Internet Explorer (Windows)

Complete these steps if your computer is connected to a proxy server and your browser is Internet Explorer.


Step 1 From the Start menu, select Settings > Control Panel.

Step 2 In the Control Panel window, choose Internet Options.

Step 3 From the Internet Properties dialog box, click Connections > LAN Settings.

Step 4 On the LAN Settings dialog box, either:

Deselect Use a proxy server to disable the service

or

Leave Use a proxy server selected and click Advanced. On the Proxy Setting dialog box under Exceptions, enter the IP addresses of ONS 15454 nodes that you will access. Separate each address with a semicolon. You can insert an asterisk for the host number to include all the ONS 15454s on your network. Click OK to close each open dialog box.


Procedure: Disable Proxy Service Using Netscape (Windows and Solaris)

Complete these steps if your computer is connected to a proxy server and your browser is Netscape Navigator.


Step 1 Open Netscape.

Step 2 From the Edit menu, choose Preferences.

Step 3 In the Preferences dialog box under Category, choose Advanced > Proxies.

Step 4 On the right side of the Preferences dialog box under Proxies, either:

Choose Direct connection to the Internet to bypass the proxy server

or

Choose Manual proxy configuration to add exceptions to the proxy server, then click View. On the Manual Proxy Configuration dialog box under Exceptions, enter the IP addresses of the ONS 15454 nodes that you will access. Separate each address with a comma. Click OK to close each open dialog box.


2.4.3 Remote Access to the ONS 15454

You can use LAN modems to access ONS 15454s from remote sites. The LAN modem must be connected to the RJ-45 port on a TCC+ card or to the LAN pins on the ONS 15454 backplane. The LAN modem must be properly configured for use with the ONS 15454. When the modem is installed, dial-up access to the ONS 15454 is available using a PC or Solaris workstation modem.

2.4.4 TL1 Terminal Access to the ONS 15454

You can communicate with the ONS 15454 using TL1. To connect a TL1 terminal (or a PC running terminal emulation software) to the ONS 15454, you can:

Use the DB-9 plug on the front panel of the TCC+ card or the CRAFT pins on the backplane. (For a list of CRAFT pin assignments, see Table 1-3 on page 1-35.)

Telnet to port 3083 with a LAN connection.

Start a TL1 session from CTC by selecting Open TL1 Session from the CTC Tools menu and selecting the node where you want to hold the TL1 session in the Select Node dialog box.

For information about using TL1 commands with the ONS 15454, see the Cisco ONS 15454 TL1 Command Guide.

2.5 Logging into the ONS 15454

After you set up the physical connections between the PC and ONS 15454 and change your PC network settings, you can log into CTC.


Note If you encounter errors while logging in, refer to the Cisco ONS 15454 Troubleshooting and Maintenance Guide for possible causes.


Procedure: Log into the ONS 15454


Step 1 From the PC connected to the ONS 15454, start Netscape or Internet Explorer.

Step 2 In the Netscape or Internet Explorer Web address (URL) field, enter the ONS 15454 IP address. For initial setup, this is the default address, 192.1.0.2. Press Enter.


Note If you are logging into ONS 15454 or ONS 15327 networks running different releases of CTC software, log into the node running the most recent release. If you log into a node with an older release, nodes running later releases display as grey icons on the network map, and the IP address will display instead of the node name. To check the software version of a node, select About CTC from the CTC Help menu.


A Java Console window displays the CTC file download status. The web browser displays information about your Java and system environments. If this is the first login, CTC caching messages display while CTC files are downloaded to your computer; then the CTC Login dialog box displays ( Figure 2-1).

Figure 2-1 Logging into the ONS 15454

Step 3 Type a user name and password (both are case sensitive). For initial setup, type the user name "CISCO15" and click Login (no password is required).


Note The CISCO15 user is provided with every ONS 15454. CISCO15 has superuser privileges, so you can create other users. CISCO15 is delivered without a password. To create one, click the Provisioning > Security tabs after you log in and change the CISCO15 password. (You cannot delete the CISCO15 user.) For more information about ONS 15454 security, see the "Creating Users and Setting Security" section on page 3-6.


Step 4 Set the following login options, as needed:

Node Name—Displays the IP address entered in the web browser and a pull-down menu of previously-entered ONS 15454 IP addresses. You can select any ONS 15454 (or ONS 15327) on the list for the login, or you can enter the IP address (or node name) of any new node where you want to log in.

Additional Nodes—Displays a list of login node groups that were created. Login node groups allow you to display ONS 15454s and/or ONS 15327s that are not connected by the SONET Data Communications Channel (DCC) to the ONS 15454 in the Node Name field. (For instructions, see the "Creating Login Node Groups" section.)


Note Topology hosts that were created in previous ONS 15454 releases by modifying the cms.ini file are displayed as a "Topology Host" group under Additional Nodes.


Exclude Dynamically Discovered Nodes—Check this box to view only the ONS 15454 (and login node group members, if any) entered in the Node Name field. Nodes linked to the Node Name ONS 15454 through the DCC are not displayed.

Step 5 Click Login.

If login is successful, the CTC window displays. From here, you can navigate to other CTC views to provision and manage the ONS 15454.


2.5.1 Creating Login Node Groups

When you log into an ONS 15454 node, only ONS 15454s optically connected (i.e., with DCC connections) to the node will display in network view. However, you can create a login node group to view and manage ONS 15454s that only have an IP connection. For example, logging into Node 1 in Figure 2-2 displays Node 2 and Node 3 because they are optically connected to Node 1. Nodes 4, 5, and 6 do not display because DCC connections do not exist. To view all six nodes at once, you create a login node group with the IP addresses of Nodes 1, 4, and 5. Those nodes, and all nodes optically connected to them, display when you log into any node in the group.

Figure 2-2 A login node group

Procedure: Create a Login Node Group


Step 1 From the CTC Edit menu, choose Preferences.

Step 2 Click the Login Node Group tab and click Create Group.

Step 3 Enter a name for the group in the Create Login Group Name dialog box. Click OK.

Step 4 Under Members, type the IP address (or node name) of a node you want to add to the group. Click Add. Repeat this step for each node you want to add to the group.

Step 5 Click OK.

The next time you log into an ONS 15454, the login node group will be available in the Additional Nodes list of the Login dialog box. You can create as many login groups as you need. The groups are stored in the CTC preferences file and are not visible to other users.


2.5.2 Accessing ONS 15454s Behind Firewalls

If an ONS 15454 or CTC computer resides behind a firewall that uses port filtering, you must receive an Internet Inter-ORB Protocol (IIOP) port from your network administrator and enable the IIOP port on the ONS 15454 and/or CTC computer, depending on whether one or both devices reside behind firewalls.

If the ONS 15454 is in a protected network and the CTC computer is in an external network, as shown in Figure 2-3, enable the IIOP listener port specified by the firewall administrator on the ONS 15454. The ONS 15454 sends the port number to the CTC computer during the initial contact between the devices using Hyper-Text Transfer Protocol (HTTP). After the CTC computer obtains the ONS 15454 IIOP port, the computer opens a direct session with the node using the specified IIOP port.

Figure 2-3 ONS 15454s residing behind a firewall

If the CTC computer and the ONS 15454 both reside behind firewalls ( Figure 2-4), set the IIOP port on the CTC computer and on the ONS 15454. Each firewall can use a different IIOP port. For example, if the CTC computer firewall uses IIOP port 4000, and the ONS 15454 firewall uses IIOP port 5000, 4000 is the IIOP port set on the CTC computer and 5000 is the IIOP port set on the ONS 15454.

Figure 2-4 A CTC computer and ONS 15454s residing behind firewalls

Procedure: Set the IIOP Listener Port on the ONS 15454


Step 1 Log into the ONS 15454 node from a CTC computer that is behind the firewall.

Step 2 In node view, select the Provisioning > Network tabs.

Step 3 On the General subtab under TCC+ CORBA (IIOP) Listener Port, select a listener port option:

Default - Variable—Used to connect to ONS 15454s on the same side of the firewall or if no firewall is used

Standard Constant—Uses port 683, the CORBA default port number

Other Constant—Allows you to set an IIOP port specified by your firewall administrator

Step 4 Click OK to apply the change.

Step 5 When the Change Network Configuration? message displays, click Yes.

Both ONS 15454 TCC+s will reboot, one at a time.


Procedure: Set the IIOP Listener Port on CTC


Step 1 From the CTC Edit menu, select Preferences.

Step 2 On the Preferences dialog box, select the Firewall tab.

Step 3 Under CTC CORBA (IIOP) Listener Port, set the listener port option:

Default - Variable—Used to connect to ONS 15454s from within a firewall or if no firewall is used

Standard Constant—Uses port 683, the CORBA default port number

Other Constant—Allows you to specify an IIOP port defined by your administrator

Step 4 Click OK to apply the change and close the dialog box.


2.6 Working with the CTC Window

The CTC window (screen) displays after you log into an ONS 15454 ( Figure 2-5). The window includes a menu bar, toolbar, and a top and bottom pane. The top pane displays status information about the selected objects and a graphic of the current view. The bottom pane displays tabs and subtabs, which you use to view ONS 15454 information and perform ONS 15454 provisioning and maintenance. From this window you can display three ONS 15454 views: network, node, and card.

Figure 2-5 CTC window elements in the node view (default login view)

2.6.1 Node View

The CTC node view, shown in Figure 2-5, is the first view displayed after you log into an ONS 15454. The login node is the first node displayed, and it is the "home view" for the session. Node view allows you to view and manage one ONS 15454 node. The status area shows the node name, IP address, session boot date and time, number of critical (CR), major (MJ), and minor (MN) alarms, the name of the current logged-in user, and security level of the user.

2.6.1.1 CTC Card Colors

The graphic area of the CTC window depicts the ONS 15454 shelf assembly. The colors of the cards in the graphic reflect the real-time status of the physical card and slot ( Table 2-4).

Table 2-4 Node View Card Colors 

Card Color
Status

Grey

Slot is not provisioned; no card is installed

Violet

Slot is provisioned; no card is installed

White

Slot is provisioned; a functioning card is installed

Yellow

Slot is provisioned; a minor alarm condition exists

Orange

Slot is provisioned; a major alarm condition exists

Red

Slot is provisioned; a critical alarm exists


2.6.1.2 Node View Card Shortcuts

If you move your mouse over cards in the graphic, tooltips display additional information about the card including the card type, card status (active or standby), the number of critical, major, and minor alarms (if any), and the alarm profile used by the card. Right-clicking a card reveals a shortcut menu, which you can use to open, reset, or delete a card. Right-click a slot (grey) to pre-provision a card (i.e., provision a slot before installing the card).

2.6.1.3 Node View Tabs

Use the node view tabs and subtabs, shown in Table 2-5, to provision and manage the ONS 15454.

Table 2-5 Node View Tabs and Subtabs 

Tab
Description
Subtabs

Alarms

Lists current alarms (CR, MJ, MN) for the node and updates them in real-time

none

Conditions

Displays a list of standing conditions on the node.

none

History

Provides a history of node alarms including date, type, and severity of each alarm. The Session subtab displays alarms and events for the current session. The Node subtab displays alarms and events retrieved from a fixed-size log on the node.

Session, Node

Circuits

Create, delete, edit, and map circuits

none

Provisioning

Provision the ONS 15454 node

General, Ether Bridge, Network, Protection, Ring, Security, SNMP, Sonet DCC, Timing, Alarming

Inventory

Provides inventory information (part number, serial number, CLEI codes) for cards installed in the node. Allows you to delete and reset cards.

none

Maintenance

Perform maintenance tasks for the node

Database, Ether Bridge, Protection, Ring, Software, XC cards, Diagnostic, Timing, Audit, Routing Table


2.6.2 Network View

Network view ( Figure 2-6) allows you to view and manage ONS 15454s and ONS 15327s that have DCC connections to the node that you logged into and any login node groups you may have selected. (Nodes with DCC connections to the login node will not display if you selected Exclude Dynamically Discovered Nodes on the Login dialog box.) The graphic area displays a background image with colored ONS 15454 icons. The icon colors indicate the node status ( Table 2-6). Green lines show DCC connections between the nodes. Selecting a node or span in the graphic area displays information about the node and span in the status area.

Figure 2-6 A four-node network displayed in CTC network view

2.6.2.1 CTC Node Colors

The colors of nodes displayed in network view indicate the status of the node

Table 2-6 Node Status 

Color
Alarm Status

Green

No alarms

Yellow

Minor alarms

Orange

Major alarms

Red

Critical alarms

Grey with node name

Node is initializing

Grey with IP address

Node is initializing, or a problem exists with IP routing from node to CTC


2.6.2.2 Network View Tasks

Right-click the network view graphic area or a node, span, or domain (domains are described in the "Creating Domains" section) to display shortcut menus. Table 2-7 lists the actions that are available from the network view.

Table 2-7 Performing Network Management Tasks in Network View 

Action
Procedure

Open a node

Any of the following:

Double-click a node icon

Right-click a node icon, choose Drill Down to Node from the shortcut menu

Click a node and choose Go to Selected Object View from the CTC View menu

From the View menu, choose Other Node. Select a node from the Select Node dialog box

Double-click a node alarm or event in the Alarms or History tabs

Move a node icon

Press the Ctrl key and the left mouse button simultaneously and drag the node icon to a new location.

Reset node icon position

Right-click a node and choose Reset Node Position from the shortcut menu. The node icon moves to the position defined by the longitude and latitude fields on the Provisioning > General tabs in node view.

Provision a circuit

Right-click a node. From the shortcut menu, choose Provision Circuit To and select the node where you want to provision the circuit. For circuit creation procedures, see the "Create an Automatically Routed Circuit" section on page 6-2.

Update circuits with new node

Right-click a node and choose Update Circuits With New Node from the shortcut menu. Use this command when you add a new node and want to pass circuits through it.

Display a link end point

Right-click a span. On the shortcut menu, select Go To [node/slot/port] for the drop port you want to view. CTC displays the card in card view.

Display span properties

Any of the following:

Move mouse over a span; properties display above the span

Click a span; properties display in the upper left corner of the window

Right-click a span; properties display at the top of the shortcut menu

Perform a UPSR protection switch for an entire span

Right-click a network span and click Circuits. See the "Switch UPSR Traffic" section on page 5-32 for UPSR protection switch procedures.

Upgrade a span

Right-click a span and choose Upgrade Span from the shortcut menu.

Note For detailed span upgrade information and instructions, refer to the Cisco ONS 15454 Troubleshooting and Maintenance Guide.


2.6.2.3 Creating Domains

Domains are icons where you can add a group of ONS 15454s or ONS 15327s. Adding domains to the network view map makes networks with many nodes easier to manage. After you create a domain, you can drag and drop ONS 15454 icons into it ( Figure 2-7). The ONS 15454s are hidden until you open the domain. Figure 2-9 shows an example of an opened domain.

Figure 2-7 Adding nodes to a domain

After you add a node to a domain, the span lines leading to nodes within the domain become thicker ( Figure 2-8). The thick lines may represent multiple spans. For example, if the "rio-104" node in Figure 2-8 is connected to two nodes within domain-0, the thick line represents two spans. The thick line is green if all spans it represents are active and grey if any one span it represents is down. The domain icon color reflects the highest alarm severity of any node within it.

Figure 2-8 Outside nodes displayed within the domain

Within the domain, external nodes and domains that are directly connected to nodes inside the domain are displayed in a dimmed color ( Figure 2-9). DCC links with one or two ends inside the domain are also displayed.

Figure 2-9 Nodes inside a domain

You manage ONS 15454s that reside within a domain the same way you manage ONS 15454s on the network map. Table 2-8 shows the domain actions.


Note Domains you create will be seen by all users who log into the network.


Table 2-8 Managing Domains 

Action
Procedure

Create a domain

Right-click the network map and choose Create New Domain from the shortcut menu. When the domain icon appears on the map, type the domain name.

Move a domain

Pressing Ctrl, drag the domain icon to the new location.

Rename a domain

Right-click the domain icon and choose Rename Domain from the shortcut menu. Type the new name in the domain name field.

Add a node to a domain

Drag a node icon to the domain icon. Release the mouse button when the node icon is over the domain icon.

Move a node from a domain to the network map

Right-click a node.

Open a domain

Double-click the domain icon.

Right-click the domain and choose Drill Down to Domain.

Return to network view

Right-click the domain view area and choose Go to Parent View from the shortcut menu.

Preview domain contents

Right-click the domain icon and choose Show Domain Overview. The domain icon shows a small preview of the nodes in the domain. To turn off the domain overview, select Show Domain Overview again.

Remove domain

Right-click the domain icon and choose Remove Domain. Any nodes residing in the domain are returned to the network map.


2.6.2.4 Changing the Network View Background Color

You can change the color of the network view background and the domain view background (the area displayed when you open a domain). If you modify background colors, the change is stored in your CTC user profile on the computer. The change does not affect other CTC users.

Procedure: Modify the Network or Domain Background Color


Step 1 Right-click the network view or domain map area and choose Set Background Color from the shortcut menu.

Step 2 On the Choose Color dialog box, select a background color.

Step 3 Click OK.


2.6.2.5 Changing the Network View Background Image

You can replace the background map image displayed in network view with any JPEG or GIF image that is accessible on a local or network drive. If you want to position nodes on the map based on the node coordinates, you will need the longitudes and latitudes for the edges of the map. However, if you will use your mouse to position nodes, coordinates for the image edges are not necessary. The change does not affect other CTC users.


Note You can obtain the longitude and latitude for cities and Zip Codes from the U.S. Census Bureau U.S. Gazetteer website (http://www.census.gov/cgi-bin/gazetteer).


Procedure: Change the Network View Background Image


Caution Before you begin this procedure, verify that the image file you want to use is located on your hard drive and is in JPEG or GIF format. CTC may stop responding if you link to a file that is not JPEG or GIF, or if you provide an incorrect path.


Step 1 In network view, choose Edit > Preferences. (You also right-click the network or domain map and select Set Background Image.)

Step 2 On the General tab of the Preferences dialog box ( Figure 2-10), deselect Use Default Map.

Figure 2-10 Changing the CTC background image

Step 3 Click Browse. Navigate to the graphic file you want to use as a background.

Step 4 Select the file. Click Open.

Step 5 (Optional) Enter the coordinates for the map image edges in the longitude and latitude fields on the Preferences dialog box. CTC uses the map's longitude and latitude to position the node icons based on the node coordinates entered for each node on the Provisioning > General tabs. Coordinates only need to be precise enough to place ONS node icons in approximate positions on the image. You can also drag and drop nodes to position them on the network view map.

Step 6 Click Apply and then click OK.

Figure 2-11 Network view with a custom map image

Step 7 At the network view, use the CTC toolbar Zoom buttons (or right-click the graphic area and select a Zoom command from the shortcut menu) to set the area of the image you can view.


Procedure: Add a Node to the Current Session

During a CTC session, you can add nodes that are not displayed in the session without having to log out of the session. When you add the node, you have the option to add it to the current login node group.


Step 1 From the CTC File menu, click Add Node (or click the Add Node button on the toolbar).

Step 2 On the Add Node dialog box, enter the node name (or IP address).

Step 3 If you want to add the node to the current login group, click Add Node to Current Login Group. Otherwise, leave it unchecked.

Step 4 Click OK.

After a few seconds, the new node will be displayed on the network view map.


2.6.3 Card View

Card view displays information about individual ONS 15454 cards and is the window where you perform card-specific maintenance and provisioning ( Figure 2-12). A graphic of the selected card is shown in the graphic area. The status area displays the node name, slot, number of alarms, card type, equipment type, and either the card status (active or standby) or port status (IS [in service] or OOS [out of service]). The information that is displayed and the actions you can perform depend on the card.


Note CTC displays a card view for all ONS 15454 cards except the TCC+, XC, XCVT, and XC10G cards.


Card view provides access to the following tabs: Alarms, History, Circuits, Provisioning, Maintenance, Performance, and Conditions. (The Performance tab is not displayed for the AIC card.) The subtabs, fields, and information displayed under each tab depend on the card type selected.

Figure 2-12 CTC card view showing an DS3N-12 card

2.7 CTC Navigation

Different navigational methods are available within the CTC window to access views and perform management actions. Commands on the View menu and CTC toolbar allow you to quickly move between network, node, and card views. You can double-click and right-click objects in the graphic area and move the mouse over nodes, cards, and ports to view popup status information. Figure 2-13 shows an example.

Figure 2-13 CTC node view showing popup information

Table 2-9 describes different methods for navigating within the CTC window.

Table 2-9 CTC Window Navigation 

Technique
Description

View menu and Toolbar

You can choose from:

The previous view (available after you navigate to two or more views)

The next view (available after you navigate to previous views)

The parent of the currently-selected view. Network is the parent of node view; node view is the parent of card view.

The currently selected object. For example, selecting a card on the node view graphic displays the card in card view; selecting a node on the network view map displays the node in node view.

The home view (the node you initially logged into)

The network view

The other node (View menu only)

Different zoom levels (toolbar only)

Double-Click

A node in network view to display the node view

A card in node view to display the card view

Right-Click

Network view graphic area—Displays a menu where you can create a new domain, change the position and zoom level of the graphic image, and change the background image and color.

Node in network view—Displays a menu where you can open the node, provision circuits, update circuits with a new node, and reset the node icon position to the longitude and latitude set on the Provisioning > General tabs.

Span in network view—Displays a menu where you can view information about the source and destination ports, the span's protection scheme, and the span's optical or electrical level. You can also display the Circuits on Span dialog box, which displays additional span information and allows you to perform UPSR protection switching.

Card in node view—Displays a menu where you can open, delete, reset, and change cards. The card that is selected determines the commands that are displayed.

Move Mouse Cursor

Over node in network view—Displays a summary of node alarms and provides a warning if the node icon has been moved out of the map range.

Over span in network view—Displays circuit (node, slot, port) and protection information

Over card in node view—Displays card type and card status

Over card port in node view—Displays port number and port status


2.8 Viewing CTC Table Data

Much of the ONS 15454 data that CTC displays, such as alarms, alarm history, circuits, and inventory, is displayed in tables. You can change the way the CTC tables are displayed. For example, you can:

Rearrange or hide table columns

Sort tables by primary and secondary keys in descending or ascending order. (Sorting and hiding is available for all read-only tables.)

Export CTC table data to spreadsheets and database management programs to perform additional data manipulation. To export table data, see the "Printing and Exporting CTC Data" section.

To change the display of a CTC table, left-click or right-click a column header in the table. Right-click a column header to display a shortcut menu that has table column display options ( Figure 2-14).

Figure 2-14 Table shortcut menu that customizes table appearance

Table 2-10 lists the options that you can use to customize information that is displayed in CTC tables.

Table 2-10 Table Display Options 

Task
Click
Right-Click Shortcut Menu

Resize column

Left click while dragging the header separator to the right or left

N/A

Rearrange column order

Left click while dragging the column header to the right or left

N/A

Reset column order

N/A

Choose Reset Columns Order/Visibility

Hide column

N/A

Choose Hide Column

Display a hidden column

N/A

Choose Show Column>[column name]

Display all hidden columns

N/A

Choose Reset Columns Order/Visibility

Sort table (primary)

Click a column header; each click changes sort order (ascending or descending)

Choose Sort Column

Sort table (secondary sorting keys)

Press the Shift key and simultaneously click the column header

Choose Sort Column (incremental)

Reset sorting

N/A

Choose Reset Sorting

View table row count

N/A

Choose Row count; it is the last item on the shortcut menu


2.9 Printing and Exporting CTC Data

You can print CTC windows and table data such as alarms and inventory. You can also export CTC table data for use by other applications such as spreadsheets, word processors, and database management applications. Table 2-11 shows CTC data that can be exported.

Table 2-11 Table Data with Export Capability 

View or Card
Tab
Subtab(s)
Network

Alarms

 
 

History

 
 

Circuits

 
 

Provisioning

Alarm Profiles

 

Maintenance

Software

Node

Alarms

 
 

Conditions

 
 

History

Session/Node

 

Circuits

 
 

Provisioning

Ether Bridge (Spanning Trees/Thresholds)

   

Network (General/Static Routes/OSPF)

   

Ring

   

Alarm Behavior

 

Inventory

 
 

Maintenance

Ether Bridge (Spanning Trees/MAC Table/Trunk Utilization)

   

Ring

   

Software

   

Audit

   

Routing Table

   

Test Access

OC-N Cards

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

Line/Threshold/STS/Alarm Behavior

 

Maintenance

Loopback

 

Performance

 
DS-N Cards

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

Line/Alarm Behavior

AIC Card

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

External Alarms/External Controls

 

Maintenance

External Alarms/External Controls/Virtual Wires

EC1-12

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

Line/Threshold/STS/Alarm Behavior

 

Maintenance

 
 

Performance

 
DS3XM-6

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

Line/Alarm Behavior

 

Maintenance

DS-1/DS-3/Performance

E100T-12/E1000-2/ E100T-12-G/E1000-2-G

Alarms

 
 

Conditions

 
 

History

Session/Card

 

Circuits

 
 

Provisioning

Port/VLAN/Alarm Behavior

 

Performance

Statistics/Utilization/History


Procedure: Print CTC Window and Table Data

Use the following procedure to print CTC windows and table data. Before you start, make sure your PC is connected to a printer.


Step 1 From the CTC File menu, click Print.

Step 2 In the Print dialog ( Figure 2-15) choose an option:

Entire Frame—Prints the entire CTC window

Tabbed View—Prints the lower half of the CTC window

Table Contents—Prints CTC data in table format; this option is only available for CTC table data (see the "Viewing CTC Table Data" section).

Figure 2-15 Selecting CTC data for print

Step 3 Click OK.

Step 4 In the Windows Print dialog, choose a printer and click Print.


Procedure: Export CTC Data


Step 1 From the CTC File menu, click Export.

Step 2 In the Export dialog ( Figure 2-16) choose a format for the data:

As HTML—Saves the data as an HTML file. The file can be viewed with a web browser without running CTC.

As CSV—Saves the CTC table values as text, separated by commas. You can import CSV data into spreadsheets and database management programs.

As TSV—Saves the CTC table values as text, separated by tabs. You can import TSV data into spreadsheets and database management programs.

Figure 2-16 Selecting CTC data for export

Step 3 Click OK.

Step 4 In the Save dialog, enter a file name in one of the following formats:

[filename].htm for HTML files

[filename].csv for CSV files

[filename].tsv for TSV files

Step 5 Navigate to a directory where you want to store the file.

Step 6 Click OK.


2.10 Displaying CTC Data in Other Applications

CTC data exported in HTML format can be viewed with any web browser, such as Netscape Navigator or Microsoft Internet Explorer. To display the data, use the browser's File/Open command to open the CTC data file.

CTC data exported as comma separated values (CSV) or tab separated values (TSV) can be viewed in text editors, word processors, spreadsheets, and database management applications. Although procedures depend on the application, you typically can use File/Open to display the CTC data. Text editors and word processors display the data exactly as it is exported. Spreadsheet and database management applications display the data in cells. You can then format and manage the data using the spreadsheet or database management application tools.

In addition to the CTC exporting, CTC text information can be copied and pasted into other applications using the Windows Copy (Ctrl+C), Cut (Ctrl+X) and Paste (Ctrl+V) commands.