Cisco PTC User Guide, 2.1
Topology Manager
Download this chapter
Topology ManagerTopology Manager
give_us_feedback

Table Of Contents

Topology Manager

Accessing the Topology Manager

Topology Management Window Components

Network View

Inconsistency Flagging in the Network View

Management System View

File Menu

Exit

View Menu

Background

Actions Menu

Add Region

Delete Region

Add Device

Delete Device

Resync Region

Show Children

Show Properties

Show Running Configuration File

Show Uploaded Configuration File

Show Difference Between Running and Uploaded Configuration File

Show Inconsistency Report

Show Unsupported Commands Report

Show Unreachable Device Report

Show Soaking Devices

Unsoak Device

Modify Device Login Information

Reregister with Cisco IE2100

Resync Topology

Tools Menu

Refresh View

Auto Refresh View

Show User Information

Search Node

Launch Applications

Job Status Pane

Refresh Button

View Button

Delete Button

Status Pane

Network View

Management System View

CMNM EMS View

Cisco IE2100 Series Appliance View

Adding a Device

Adding a CMNM Device

Adding a Cisco IE2100

Adding a Region

Removing a Device

Removing a Cisco IE2100

Removing a Region

Resynchronizing the Network Topology

Resynchronizing a Specific Region

Searching for a Device in the Network View

Searching for a Device in the Management System View

Rearranging Network Element Icons in the Graph Pane

Printing the Topology Image

Zooming In and Out of the Topology Image

Redisplaying the Cisco PTC Launch Pad


Topology Manager

This chapter describes the Cisco PTC Topology Manager features and how to accomplish a variety of tasks through the Topology Management window.This chapter is organized into the following sections:

•"Accessing the Topology Manager"

•"Topology Management Window Components"

–"Network View"

–"Management System View"

–"File Menu"

–"View Menu"

–"Actions Menu"

–"Tools Menu"

–"Job Status Pane"

•"Network View"

•"Management System View"

•"Adding a Device"

•"Adding a CMNM Device"

•"Adding a Cisco IE2100"

•"Adding a Region"

•"Removing a Device"

•"Removing a Cisco IE2100"

•"Removing a Region"

•"Resynchronizing the Network Topology"

•"Resynchronizing a Specific Region"

•"Searching for a Device in the Network View"

•"Searching for a Device in the Management System View"

•"Rearranging Network Element Icons in the Graph Pane"

•"Printing the Topology Image"

•"Zooming In and Out of the Topology Image"

•"Redisplaying the Cisco PTC Launch Pad".

Accessing the Topology Manager

You obtain access to the Topology Manager by clicking on the Topology button in the Cisco PTC Launch Pad window. The Topology Management window, as shown in Figure 3-1, appears.

Depending upon the type of user you logged in as (system administrator, regional network operator, or non-administrative user) and the permissions granted to that user type, the Topology Management window allows you to:

•discover network element physical and logical configurations

•discover network layer concepts such as virtual zones, virtual gateways, gatekeeper groups, directory gatekeeper groups, Q931 signaling paths, and voice ports

•view the network topology in an H.323- or Element Management System-centric view

•add and delete regions, gateways (GWs), gatekeepers (GKs), and directory gatekeepers (DGKs)

•add Cisco MGC Node Managers (CMNMs)

•add and delete Cisco IE2100 appliances

•obtain device property values

•access external applications (for example, VSPT (Voice Services Provisioning Tool), CMNM, CiscoView, CIC (Cisco Info Center), Carrier Sensitive Route (CSR) Server, and Telnet)

•initiate forced synchronization with the entire network or part (region) of the network. Network synchronization is the process through which Cisco PTC reconciles its management information with the current device configurations on the voice network. This mechanism could be requested when there is reason to believe that Cisco PTC and the underlying network elements have gotten out of sync (for example, after a previous bulk configuration)

•synchronize topological changes between the Cisco PTC and Cisco Voice Routing Center (VRC) applications.

Figure 3-1 Topology Management Window - Expanded Network View

Topology Management Window Components

The Topology Management window contains two tabs (Network View and Management System View). Depending upon which tab you click, the contents of the Topology Management window changes accordingly. See Sections "Network View" and "Management System View" for detailed information.

The left side of the window is the Tree View pane where the network element objects are displayed in a tree-like hierarchical structure. The right side of the window is the Graph pane where graphical icons pertaining to a virtual entity selected in the Tree View pane are displayed. The bottom of the window contains the Job Status pane where status information about jobs and actions submitted from within the Topology Management window are displayed.

Network View

When you click the Network View tab (this is the default view when you invoke the Topology Manager), you have access to and can view the network object, region objects, virtual zone objects, directory gatekeeper group objects, gatekeeper group objects, virtual gateway objects, media gateway objects, and signaling controller objects, in a hierarchical, tree-like display in the Tree View pane.

You navigate through the Tree View pane (that is, you display the children of a particular region or zone object) by double-clicking on a particular region or virtual zone entity. Graphical icons associated with the children of the virtual entity you double-clicked in the Tree View pane, are displayed in the Graph pane. When you double-click on a particular region or zone object icon in the Graph pane, the children of this virtual entity are displayed as icons in a new window.

You can rearrange the icons in the Graph pane by dragging and dropping the icons to new locations within this pane. See the "Rearranging Network Element Icons in the Graph Pane" section for instructions on how to rearrange network element icons in the Graph pane.

Inconsistency Flagging in the Network View

The Network View has the capability of flagging any inconsistencies found in device configurations according to the following protocol:

•the inconsistency flagging propagates up to the region level. For example, when a virtual gateway is flagged as being inconsistent, the virtual zone and the region in which it is contained are also flagged as being inconsistent.

•you can obtain the reason behind an inconsistency flagging of a region by right clicking on the region's icon and then choosing the Show Inconsistency Report menu option

•the Show Inconsistency Report menu option is disabled when a region has no inconsistencies

•the parent attributes pass the reason for an inconsistency to its immediate child. For example, when a region has been flagged as being inconsistent because of a misconfigured virtual gateway, the region signifies that it is inconsistent because of the virtual zone and the virtual zone signifies that it is inconsistent because of the virtual gateway.

Management System View

When you click the Management System View tab, the CMNM Element Management Systems (EMSs) and Cisco IE2100 appliances that Cisco PTC interfaces to are displayed. Two subviews are available:

* CMNM subview—shows all of the CMNM hosts and the signaling controller complexes managed by each CMNM.

* Cisco IE2100 subview—shows all of the Cisco IE2100 appliances and the gateways, gatekeepers, and directory gatekeepers managed by each Cisco IE2100.

You can rearrange the icons in the Graph pane by dragging and dropping the icons to new locations within this pane. See the "Rearranging Network Element Icons in the Graph Pane" section for instructions on how to rearrange network element icons in the Graph pane.

File Menu

This section describes the File menu option.

Exit

This option closes the Topology Management window.

View Menu

The View menu options are used to change the look and feel of the Topology Management window and its components.

Background

This option allows you to alter the Graph pane's properties (for example, change the background color, change the background image, clear the background image, and restore the image).

Set Color

This option sets the colors used in the background image.

Set Image

This option displays a map as the background image. Choices currently include Africa, Asia, North America, South America, Europe, Australia, Russia, and the world. The default background image is a graph.

Clear Image

This option displays the default graph image.

Restore Image

This option displays the previously displayed image.

Actions Menu

The Actions menu provides the following options:

•"Add Region" and "Delete Region"

•"Add Device" and "Delete Device"

•"Resync Region"

•"Show Children"

•"Show Properties"

•"Show Running Configuration File"

•"Show Uploaded Configuration File"

•"Show Difference Between Running and Uploaded Configuration File"

•"Show Inconsistency Report"

•"Show Unsupported Commands Report"

•"Show Unreachable Device Report"

•"Show Soaking Devices"

•"Unsoak Device"

•"Modify Device Login Information"

•"Reregister with Cisco IE2100"

•"Resync Topology".

Note All of the Actions menu options are also available when you right-click on a selected network element or EMS object icon in the Tree View or Graph panes. Options are disabled when they do not apply to a selected object.

Add Region

This option allows you to add a region to the network. Prior to choosing this option, you must first select the Network object in the Tree View pane. An Add Region window appears where you can specify a unique name for the new region. You then click Ok to add the new region, Cancel to cancel the add operation and return to the Topology Management window, or Clear to clear all fields in the
Add Region window. See the "Adding a Region" section for an example of how to add a region to the Cisco PTC network.

Note Upon successfully adding a region through the Topology Manager, you must choose the
Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the added region, unless you previously chose the Tools > Auto Refresh View option, which automatically performs a Refresh View operation whenever a region is added to the network through the Topology Manager.

Delete Region

This option allows you to delete a region that contains no elements. Prior to choosing this option, you must first select the desired region's object in the Tree View pane. A Confirm Delete window is displayed and you must click either the Yes or No button for the operation to continue. See the "Removing a Region" section for an example of how to remove a region from the Cisco PTC network.

Note Upon successfully deleting a region through the Topology Manager, you must choose the
Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the deleted region, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a region is removed from the network through the Topology Manager.

Add Device

This option allows you to add gateways, gatekeepers, and directory gatekeepers to the Cisco PTC network when in Network View mode, and CMNM devices and Cisco IE2100 appliances to the Cisco PTC network when in Management System View mode.

Note Prior to choosing the Add Device option, you must first select the region object in the Tree View pane (while in Network View mode) to which you want the device added. Prior to choosing the Add IE2100 or Add CMNM option, you must first select the appropriate object (IE2100 or CMNM) in the
Tree View pane (while in Management System View mode) to which you want the Cisco IE2100 or CMNM device added.

You can choose to add gateway, gatekeeper, and directory gatekeeper devices in one of the following modes:

•single add—adds one device per operation

•bulk add—adds multiple devices within the same operation

•range add—adds multiple devices with consecutive IP addresses, within the same operation. You specify the IP address of the initial device, then you specify how many devices with consecutive IP addresses you want to add (range). For example, when you want to add five devices that have consecutive IP addresses, instead of entering the IP address for each device (like you would in a Bulk Add operation), you simply provide a starting IP address (for example, 122.110.110.111) and a range (for example, 5). The result is that five devices, whose IP addresses range from 122.110.110.111 through 122.110.110.115, are added under the previously selected region.

Note Upon successfully adding a device through the Topology Manager, you must choose the
Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the added device, unless you previously chose the Tools >Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is added to the network through the Topology Manager.

Adding a Gateway

This option allows you to add a gateway to an existing region in the Cisco PTC network. An Add Device window appears where you can specify the required gateway parameters. You then click Ok to add the new region, Cancel to cancel the add operation and return to the Topology Management window, or Clear to clear all fields in the Add Device window. See the "Adding a Device" section for detailed information on how to add a gateway device to the Cisco PTC network.

Adding a Gatekeeper

This option allows you to add a gatekeeper to an existing region in the Cisco PTC network. An Add Device window appears where you can specify the required gatekeeper parameters. You then click Ok to add the new region, Cancel to cancel the add operation and return to the Topology Management window, or Clear to clear all fields in the Add Device window. See the "Adding a Device" section for detailed information on how to add a gatekeeper device to the Cisco PTC network.

Adding a Directory Gatekeeper

This option allows you to add a directory gatekeeper to an existing region in the Cisco PTC network. An Add Device window appears where you can specify the required directory gatekeeper parameters. You then click Ok to add the new region, Cancel to cancel the add operation and return to the Topology Management window, or Clear to clear all fields in the Add Device window. See the "Adding a Device" section for detailed information on how to add a directory gatekeeper device to the Cisco PTC network.

Adding a CMNM

This option allows you to add a Cisco MGC Node Manager device to the Cisco PTC network. A CMNM is an Element Management System (EMS) for SC2200s/PGW2200s and is built on top of the CEMF (Cisco Element Management Framework) application. Cisco PTC utilizes the CMNM Northbound Application Programming Interface to upload the CMNM device configurations during network discovery and synchronization operations, as well as for flow through provisioning of NAS Paths, IP Links, and nailed trunks.

See the "Adding a CMNM Device" section for detailed information on how to add a CMNM device to the Cisco PTC network.

To obtain access to CMNM documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/index.htm.

To obtain access to CEMF documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cemf/3_2/index.htm.

Adding a Cisco IE2100

This option allows you to add a Cisco IE2100 device to the Cisco PTC network. The Cisco IE2100 is an appliance that is used to download and upload IOS configuration files to and from IOS devices. See the "Adding a Cisco IE2100" section for detailed information on how to add a Cisco IE2100 appliance to the Cisco PTC network.

To obtain access to Cisco IE2100 documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/ie2100/cnfg_reg/rel_1_1/index.htm.

Delete Device

This option allows you to delete a device or EMS. Prior to choosing this option, you must select the device's object in the Tree View pane. A Confirm Delete window is displayed and you must click either the Yes or No button for the operation to continue. See the "Removing a Device" section for an example of how to remove a device from the Cisco PTC network.

Note Upon successfully deleting a device through the Topology Manager, you must choose the
Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the deleted device, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is removed from the network through the Topology Manager.

Resync Region

This option allows you to resynchronize the selected region.

Note Prior to invoking the resynchronization process, if changes have occurred in the SC2200 environment, you must ensure that the CMNM is synchronized with the SC2200. See the "Adding a CMNM Device" section for detailed information on how to ensure the CMNM is synchronized with the SC2200.

During region resynchronization, Cisco PTC does the following:

•synchronizes only with the gateways, gatekeepers, directory gatekeepers, and CMNMs that are part of the selected region and that known to Cisco PTC, as stored in the Managed Information Tree (MIT). Cisco PTC does not attempt to read the Network Information Seed File (NISF) file again.

•uploads the selected region's current gateway, gatekeeper, and directory gatekeeper configuration files through the Cisco IE2100 appliance and the signaling controller configuration files through the CMNM

•reconciles the current device configurations with the Cisco PTC stored data, which may result in:

–the addition, modification, or deletion of device level objects. Depending upon the object type, deletion may mean removing the object from the MIT or changing its state to inactive. Usually, lower level leaf objects, such as ports and trunks, are deleted. Higher level containment object types, such as nodes and cards, are marked inactive.

–the addition, modification, or deletion of virtual entities. A virtual entity is typically not deleted from the MIT, instead, it is changed to an inactive state.

–detecting or unflagging misconfigurations.

Note Depending upon the number of objects in the region, this could be a time and resource consuming operation.

Show Children

This option allows you to display a table of associations pertaining to the entity (region, directory gatekeeper group, virtual zone, virtual gateway, gatekeeper group, or network) upon which this command is invoked (for example, the RLM associations between a gateway and a SC2200, and the gatekeeper to gateway associations at the virtual zone level). When this option is invoked on a gatekeeper, it shows all of the gateways being managed by a particular gatekeeper, as well as, conversely.

Show Properties

This option is operable on any network element. The fields in the properties table that are applicable to the network element are populated with their values and the remainder have "N/A" displayed as their value.

Show Running Configuration File

When applicable, this option uploads the currently running configuration file from the selected device and displays its contents.

Show Uploaded Configuration File

When applicable, this option displays the running configuration file from the last resynchronization or Cold Start of the selected device.

Show Difference Between Running and Uploaded Configuration File

When applicable, this option displays the differences between the currently running configuration file on the selected device and the last configuration file that was uploaded to the selected device.

Show Inconsistency Report

When applicable, this option displays a report describing any inconsistencies found in the network based upon information contained in the uploaded IOS configuration file of the selected device.

Show Unsupported Commands Report

When applicable, this option displays a report that lists any commands that are unsupported by the Cisco N-Agent parser.

Show Unreachable Device Report

This report is at the region level. When applicable, this option displays a report listing all of the unreachable devices that were detected during the initial discovery operation or the last resynchronization operation.

Show Soaking Devices

When applicable, this option displays a list of devices, within the selected region, whose configuration files are being modified (pre-committed changes) by the Cisco VRC application. When a device is in soaking mode, any configuration and/or provisioning changes made through Cisco PTC are only written to the Cisco PTC running configuration file. When you determine the devices within the selected region are no longer in soak mode (the device configuration files are no longer being modified by the Cisco VRC application), you should invoke the Unsoak Device option on the selected region. Cisco PTC then writes the configuration and/or provisioning changes to the Cisco PTC running and start up configuration files for all devices within the region.

Unsoak Device

When applicable, this option sets all of the devices, within the selected region, to unsoak mode. This means Cisco PTC now writes all of the region's device configuration files to the running and start up configuration files, as opposed to just the running configuration files for soaking devices.

Modify Device Login Information

This option allows you to change the AAA/local login and AAA/local enable passwords for either a selected device or region. When you select a region, the passwords are changed for all of the devices within that region.

Reregister with Cisco IE2100

This option allows you to reregister with the Cisco IE2100 when the configuration on the selected device changes (for example, when the device goes from non-AAA mode to AAA enabled mode).

Resync Topology

This option allows you to resynchronize the complete topology. During network synchronization, Cisco PTC does the following:

•synchronizes only with the gateways, gatekeepers, directory gatekeepers, and CMNMs that are known to Cisco PTC, as stored in the Managed Information Tree (MIT). Cisco PTC does not attempt to read the Network Configuration Seed File (NCSF) file again.

•uploads the current gateway, gatekeeper, and directory gatekeeper configuration files through the Cisco IE2100 appliance and the signaling controller configuration files through the CMNM

•reconciles the current device configurations with the Cisco PTC stored data, which may result in:

–the addition, modification, or deletion of device level objects. Depending upon the object type, deletion may mean removing the object from the MIT or changing its state to inactive. Usually, lower level leaf objects, such as ports and trunks, are deleted. Higher level containment types of objects, such as nodes and cards, are marked inactive.

–the addition, modification, or deletion of virtual entities. A virtual entity is typically not deleted from the MIT, instead, it is changed to an inactive state.

–detecting or unflagging misconfigurations.

Note Depending upon the number of objects in the network, this could be a time and resource consuming operation.

Tools Menu

This menu allows you to invoke the following operations:

•"Refresh View"

•"Auto Refresh View"

•"Show User Information"

•"Search Node"

•"Launch Applications"

Refresh View

Redisplays the network elements based upon the contents of the MIT. You can also access this feature by clicking on the Refresh View icon in the Tool bar.

Note Upon adding or removing a device or region, you must choose this option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the
Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device or region is added to or removed from the system through the Topology Manager.

Auto Refresh View

This option allows you to automatically redisplay the network elements in the Tree View pane, based upon the contents of the MIT, whenever a device or Region is successfully added to or removed from the network through the Topology Manager.

When this option is not invoked, a "Network has changed. Refresh View to update network data" message is displayed whenever an add, delete, or resynchronization operation has successfully completed. It is recommended that you invoke the Tools > Refresh View menu option at this time, as this option redisplays the network elements in the Tree View pane based upon the modified contents of the MIT.

Show User Information

This option (also available by clicking on the Show User Information icon in the Tool bar) allows you to obtain the usernames of those currently logged in to Cisco PTC, the time they logged in to Cisco PTC, and the name of the machine they logged in from. Upon choosing this option, the User Information window appears. To obtain an up-to-date list of the logged on Cisco PTC users, click the Refresh button.

You can also communicate with other logged on users through the User Information window. To do so, you must first select a username entry from the User column, type the message in the Type Your Message to User pane, then click the Send button. Incoming messages from other logged in users are displayed in the Message from User pane.

You can clear outgoing and incoming messages by clicking the Clear button in the appropriate panes.

Search Node

This option (also available by clicking on the Search Node icon in the Tool bar) allows you to search for a specific network element.

When you are looking at the Management System View, you can perform a search by using a device's name or IP address, however, the search is limited, as it only works on an expanded tree view. See the "Searching for a Device in the Management System View" section for the details on how to perform a search from within the Management System View.

When you are looking at the Network View, you can perform a search by using a device's name, IP address, or keyword. See the "Searching for a Device in the Network View" section for the details on how to perform a search from within the Network View.

Launch Applications

This option provides you access to the following:

•Voice Services Provisioning Tool (VSPT)

•Cisco MGC Node Manager (CMNM)

•CiscoView application

•Cisco Info Center (CIC) application

•Carrier Sensitive Route (CSR) Server

•Telnet.

Voice Services Provisioning Tool

This option provides access to the Voice Services Provisioning Tool when it is associated with a selected network element. When you choose this option, you are required to specify the hostname or IP address of the machine where VSPT is running. Upon successfully connecting to the machine, you now have access to the VSPT application.

The VSPT application is used to configure and provision the SC2200 complex, including the signaling controller (SC) hosts and Billing and Measurement (BAM) servers. VSPT interfaces to network elements using their native Man Machine Language/Command Line Interface (MML/CLI). The MML/CLI commands are transmitted to the element as batch files using the File Transfer Protocol (FTP). You can establish a Telnet session to a network element from the VSPT for direct input of MML/CLI commands. VSPT can operate on the same UNIX platform as the Cisco MGC Node Manager.

VSPT accepts an MML batch file from a current configuration to allow editing or cloning of the configuration for deployment on another MGC host. VSPT provides a set of software wizards to aid in the adding, modifying, and deleting of the various subcomponents of the configuration.

To obtain access to VSPT documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/dart21/index.htm.

Note Launching VSPT requires an X-emulation client software product, such as those offered by Reflection and Exceed, because VSPT is a non web-based application. However, when using Reflection X over a Virtual Private Network (VPN), VSPT fails to start. As Cisco PTC uses Reflection X by default when it tries to launch VSPT, when it cannot find the Reflection X client software, it displays a File Open window from where you can browse to the location where the Exceed.exe file is located. Upon locating the Exceed.exe file, you must then choose the Open option. VSPT is then launched using the Exceed X-emulation client software.

Cisco MGC Node Manager

This option provides access to the Cisco Media Gateway Controller (MGC) Node Manager (CMNM) application. The CMNM is an Element Management System (EMS) built on top of the CEMF (Cisco Element Management Framework) application. Cisco PTC utilizes the CMNM Northbound Application Programming Interface to upload device configurations during network discovery and synchronization operations, as well as for flow through provisioning of NAS Paths, IP Links, and nailed trunks.

When you choose this option, you are required to specify the hostname or IP address of the machine where CMNM is running. Upon successfully connecting to the machine, you now have access to the CMNM application.

To obtain access to CMNM documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/index.htm.

To obtain access to CEMF documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cemf/3_2/index.htm.

CiscoView

This option provides access to the CiscoView application if it is associated with a selected network element. When you choose this option, you are required to specify the hostname or IP address of the machine where CiscoView is running. Upon successfully connecting to the machine, you now have access to the CiscoView application.

The CiscoView application is a member of the CiscoWorks2000 family. It is a web based device management application that provides dynamic status, monitoring, and configuration information for the broad range of Cisco internetworking products. CiscoView displays a physical view of a device chassis, with color coding of modules and ports for an at-a-glance status. Monitoring capabilities display performance and other statistics. Configuration capabilities allow comprehensive changes to devices, provided requisite security privileges are granted.

To obtain access to CiscoView documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/cw2000_d/4steditn/use_view/index.htm.

Cisco Info Center

This option provides access to the Cisco Info Center application. When you choose this option, you are required to specify the hostname or IP address of the machine where CIC is running, as well as, a valid username and password. Upon successfully logging in, you now have access to the CIC application.

This application is a Service-Level Management system that collects event streams or messages from many different data sources and then provides a consolidated view of the events and status information.

To obtain access to Cisco Info Center documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/info_ctr/index.htm.

Note Launching CIC requires an X-emulation client software product, such as those offered by Reflection and Exceed, because CIC is a non web-based application. However, when using Reflection X over a Virtual Private Network (VPN), CIC fails to start. As Cisco PTC uses Reflection X by default when it tries to launch CIC, when it cannot find the Reflection X client software, it displays a File Open window from where you can browse to the location where the Exceed.exe file is located. Upon locating the Exceed.exe file, you must then choose the Open option. CIC is then launched using the Exceed X-emulation client software.

Carrier Sensitive Route Server

This option provides access to the Carrier Sensitive Route Server. When you choose this option, you are required to specify the hostname or IP address of the machine where CSR is running, as well as, a valid username and password. Upon successfully logging in, you now have access to the CSR server.

CSR provides the capability to affect the routing of calls from the gatekeeper based upon the INGRES carrier and DNIS. The routing can be based upon QOS along with many other carrier related attributes. With CSR, you can provision data specific to carriers that pertain to your network to maximize cost, QOS, and carrier relations.

Telnet

This option (also available by clicking on the Telnet icon in the Tool bar) provides access to the Telnet Session application if it is associated with the selected network element. When you choose this option, you are required to specify the hostname or IP Address of the machine you wish to telnet to. Upon successfully connecting to the machine, you now have a telnet session established.

Job Status Pane

This pane contains job status information about the jobs submitted from the Topology Management window. You can double-click on a job entry and review its contents and results. For failed jobs, you can view a detailed failure report. You can also delete completed jobs.

The Job Status pane contains the following columns and information:

User

The user names of the job submitters are displayed in this column.

Job ID

The job IDs assigned to particular jobs are displayed in this column.

Job Type

The types of jobs (for example, Delete <device-name>, Add <region-name>, Resync <region-name>) are displayed in this column.

Status

The job status (Pending, Completed, or Errored) are displayed in this column.

Create Time

The times the jobs were submitted are displayed in this column.

Complete Time

The times the jobs were completed are displayed in this column.

Refresh Button

You click this button to have the latest list of jobs displayed in this pane.

View Button

You must first select an entry in the Topology Job pane, then you click this button to view the selected job's content and results through the Topology Job Detail window. For failed jobs, details about the cause of the failure are also provided.

Delete Button

You must first select the entries you wish to delete in the Topology Job pane, then you click this button to delete the selected entries.

Status Pane

This pane displays error and status messages.

Network View

The Network View, as shown in Figure 3-1, is displayed when you click on the Network View tab in the Topology Management window. The Network View displays the known network elements (such as regions, virtual zones, and virtual gateways) in a tree-like display, in the Tree View pane, of the logical containment hierarchy.

The network element geographical view appears in the Graph pane when you click on a specific network element in the Tree View pane. When you double-click on a specific network element in the Tree View pane, the tree view is expanded to show the underlying network elements. An example showing the expanded SanJose region object, is shown in Figure 3-2.

Figure 3-2 Topology Management Window - Expanded SanJose Region View

Management System View

The Management System View, as shown in Figure 3-3, is displayed when you click on the Management System View tab in the Topology Management window. The Management System View displays all of the Element Management Systems (EMSs) and Cisco IE2100 appliances that Cisco PTC interfaces with, in separate subviews. These include:

•CMNM—Cisco Media Gateway Controller (MGC) Node Manager (CMNM) EMSs

•IE2100—Cisco IE2100 Series appliances.

Figure 3-3 Topology Management Window - Management System View

CMNM EMS View

The Cisco Media Gateway Controller (MGC) Node Manager (CMNM) application is a Cisco Element Management Framework (CEMF) based Element Management System (EMS) for signaling controllers (SC2200). This view shows a tree view of all CMNM hosts and signaling controller complexes managed by each CMNM. Figure 3-4 shows an expanded CMNM tree view.

Figure 3-4 Topology Management Window - Expanded CMNM Management System View

You can see the contents of a particular CMNM node by double clicking on it. You can also invoke the Actions menu options on the selected node. The CMNM nodes are context sensitive for the requested operations and permissions (for example, checks are made to ensure the user is authorized to perform an Add CMNM Device operation).

Note To obtain access to the CMNM documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/info_ctr/index.htm.
To obtain access to the CEMF documentation, go to the following URL: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/info_ctr/index.htm.

Cisco IE2100 Series Appliance View

The Cisco IE2100 Series appliance is used to upload running configuration files of the Cisco IOS devices registered with it. This view shows a tree view of all Cisco IE2100 appliances and the gateways, gatekeepers, and directory gatekeepers managed by each Cisco IE2100. Figure 3-5 shows an expanded Cisco IE2100 tree view.

Figure 3-5 Topology Management Window - Expanded Cisco IE2100 Management System View

You can see the contents of a particular Cisco IE2100 node by double clicking on it. You can also invoke the Actions menu options on the selected Cisco IE2100 node. The Cisco IE2100 nodes are context sensitive for the requested operations and permissions (for example, checks are made to ensure the user is authorized to perform an Add Cisco IE2100 Device operation).

Adding a Device

This section describes how to add a device (gateway, gatekeeper, or directory gatekeeper) to an existing region through the Topology Management window.

Step 1 Click the Network View tab.

The Topology Management window now provides you access to and a view of the known network elements (such as regions, virtual zones, and virtual gateways) in a tree-like display, in the Tree View pane, of the logical containment hierarchy.

Step 2 In the Tree View pane, select the region object to which you want to add a device.

Step 3 Choose the Actions > Add Device menu option.

The Add Device window appears, as shown in Figure 3-6. The selected region name and the Cisco IE2100 device name and IP address are displayed in this window.

Figure 3-6 Add Device Window

Step 4 Choose the type of device you are adding (gateway, gatekeeper, or directory gatekeeper) from the Device Type menu.

Step 5 Enter the host name of the new device in the Device Name field.

Step 6 Enter the IP address of the new device in the Device IP Address field.

Step 7 When the login method between the Cisco IE2100's Intelligent Modular Gateway (IMGW) and this IOS device will use a secure shell, you must enter a username in the User Name field. Otherwise, if this is a Cisco Networking Services (CNS) enabled device or if Telnet will be used to login to this device, leave this field blank.

Step 8 Enter the AAA/local login password for the new device (not the user password) in the Login Password field.

Step 9 Enter the AAA/local login enable password for the new device (not the user password) in the Enabled Password field.

Step 10 Optionally, enter the IP address of the gateway or gatekeeper device for H.225 Registration, Admission, and Status (RAS) protocol messages in the VoIP Address field.

Step 11 Choose the login method to be used between the Cisco IE2100's IMGW and this IOS device from the Login Method menu. Valid types are:

•Not Applicable (login is not applicable for this CNS supported device)

•IOS_LOGIN (uses Telnet to login to this IOS device)

•IOS_LOGIN:SSH (uses a secure shell to login to this IOS device).

Step 12 Enter the TCP port to be used by the Cisco IE2100's IMGW when connecting to this device.

Note, when you select the IOS_LOGIN:SSH login method, set this parameter value to 22. When you select the Not Applicable or IOS_LOGIN login method, set this parameter value to 23.

Step 13 Click the OK button.

The Add Device operation is initiated and an entry is created in the Job Status pane for this operation.

Step 14 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 15 Upon successfully adding a device, you must invoke the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is added to the network through the Topology Manager.

Note The More option in the Add Device window allows you to add additional devices, one at a time. You can also click the Bulk Add button to add multiple devices in one operation or you can click the Range Add button to add multiple devices that start with the specified IP address with the subsequent devices having consecutive IP addresses for the range you specify.

Adding a CMNM Device

This section describes how to add a Cisco Media Gateway Controller (MGC) Node Manager (CMNM) device to the Cisco PTC network, through the Topology Management window.

Step 1 Click the Management System View tab.

The Topology Management window now provides you access to and a view of the CMNMs known to exist in the Cisco PTC network.

Step 2 In the Tree View pane, select the CMNM object.

Step 3 Choose the Actions > Add CMNM menu option.

The Add CMNM window appears, as shown in Figure 3-8.

Figure 3-7 Add CMNM Window

Step 4 Enter the name of the new CMNM device in the CMNM Name field.

Step 5 Enter the IP address of the CMNM device in the CMNM IP Address field.

Step 6 Enter the username root or vnm in the User Name field.

Step 7 Enter the password associated with the username you provided above, in the Login Password field, then click the OK button.

The Add CMNM operation is initiated and an entry is created in the Job Status pane for this operation.

Step 8 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 9 Upon successfully adding a CMNM, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is added to the network through the Topology Manager.

Step 10 At this point, the new CMNM entry should appear under the CMNM object in the Tree View pane. If entries for all of the SC2200s being managed by this CMNM do not appear under the new CMNM object you just created, you must discover the SC2200 elements from the CEMF session on the CMNM device, and then you must choose the Actions > Resync Topology menu option in order to synchronize the Cisco PTC components.

Adding a Cisco IE2100

This section describes how to add a Cisco IE2100 appliance to an existing region through the Topology Management window.

Step 1 Click the Management System View tab.

The format of the Topology Management window changes. You now have access to and a view of the Cisco IE2100 appliances and the gateways, gatekeepers, and directory gatekeepers managed by each Cisco IE2100.

Step 2 In the Tree View pane, select the IE2100 object.

Step 3 Choose the Actions > Add IE2100 menu option.

The Add IE2100 window appears, as shown in Figure 3-8.

Figure 3-8 Add IE2100 Window

Step 4 Enter the host name of the Cisco IE2100 appliance in the IE2100 Name field.

Step 5 Select the region this Cisco IE2100 appliance is to be added to from the Region Name menu.

Step 6 Enter the IP address of the Cisco IE2100 appliance in the Device IP Address field.

Step 7 Enter the login password of the Cisco IE2100 appliance (not the user password) in the Login Password field, then click the OK button.

The Add Cisco IE2100 operation is initiated and a job entry is created in the Job Status pane for this operation.

Step 8 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 9 Upon successfully adding the Cisco IE2100 appliance, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is added to the network through the Topology Manager.

Adding a Region

This section describes how to add a region with a unique name through the Topology Management window.

Step 1 In the Tree View pane, select the Network object.

Step 2 Choose the Actions > Add Region menu option.

The Add Region window appears.

Step 3 Enter the name of the new region in the Region Name field, then click the OK button.

The Add Region operation is initiated and a job entry is created in the Job Status pane for this operation.

Step 4 Check the Job Status pane to see whether any inconsistencies have been flagged. If not, you can now add new devices to the region you just created.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 5 Upon successfully adding the region, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a region is added to the network through the Topology Manager.

Removing a Device

This section describes how to remove a device through the Topology Management window.

Step 1 In the Tree View pane, select the device you want to delete.

Step 2 Choose the Actions > Delete Device menu option.

The Confirm Delete window appears.

Step 3 Click the Yes button.

The Delete Device operation is initiated and a job entry is created in the Job Status pane for this operation.

Step 4 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 5 Upon successfully removing the device, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is removed from the network through the Topology Manager.

Removing a Cisco IE2100

This section describes how to remove a Cisco IE2100 appliance through the Topology Management window.

Step 1 In the Tree View pane, select the Cisco IE2100 appliance you want to delete.

Step 2 Choose the Actions > Delete IE2100 menu option.

The Confirm Delete window appears.

Step 3 Click the Yes button.

The Delete Cisco IE2100 operation is initiated and a job entry is created in the Job Status pane for this operation.

Step 4 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 5 Upon successfully removing the Cisco IE2100 appliance, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a device is removed from the network through the Topology Manager.

Removing a Region

This section describes how to remove a region through the Topology Management window.

Note Only system administrators can remove regions and the region must not contain any objects.

Step 1 In the Tree View pane, select the region object you want to delete.

Step 2 Choose the Actions > Delete Region menu option.

The Confirm Delete window appears.

Step 3 Click the Yes button.

The Delete Region operation is initiated and a job entry is created in the Job Status pane for this operation.

Step 4 Check the Job Status pane to see whether any inconsistencies have been flagged.

You can view the status of this operation by selecting the job's entry and then clicking the View button in the Job Status pane. You can delete the job's entry by selecting the entry and then clicking the Delete button.

Step 5 Upon successfully removing the region, you must choose the Tools > Refresh View menu option in order to have the Tree View pane contents updated to reflect the performed operation, unless you previously chose the Tools > Auto Refresh View menu option, which automatically performs a Refresh View operation whenever a region is removed from the network through the Topology Manager.

Resynchronizing the Network Topology

This section describes how to perform, as a system administrator, a network resynchronization operation through the Topology Management window.

Step 1 Prior to invoking the resynchronization process, if changes have occurred in the SC2200 environment, you must ensure that the CMNM is in sync with the SC2200. Click on the Management System View tab in the Topology Management window.

Step 2 Double-click on the CMNM object icon in the Tree View pane to expand the hierarchical view.

Step 3 Double-click on a CMNM host icon in the Tree View pane to expand the view to show the MGC devices under a particular CMNM.

Step 4 Right click on an MGC device icon in the Tree View pane, then choose the
Launch Applications > Cisco MGC Node Manager option.

Step 5 Enter the IP address of the CMNM host machine, then click OK.

The Cisco Element Management Framework Login window appears.

Step 6 Log into the CEMF host by entering admin for the username and password values.

The Cisco Element Management Framework Launch Pad window appears.

Step 7 Choose the Viewer icon in the CEMF Launch Pad window.

The Map Viewer window appears.

Step 8 Click the MGC-Node-View tab in the Map Viewer window.

Step 9 Right click on an MGC-node icon in the Tree View pane, then choose the
MGC Node > MGC Node State menu option.

The MGC Node State window appears.

Step 10 Click on the Rediscover button in the MGC Node State window.

Step 11 Click Yes in the Confirmation window.

The CMNM and SC2200 synchronization process in invoked.

Step 12 Upon successful completion of the CMNM and SC2200 synchronization process, exit the CEMF application.

Step 13 Choose the Actions > Resync Topology menu option from the Cisco PTC Topology Management window.

Step 14 Click OK to confirm.

Step 15 Check the Job Status pane in the Topology Management window to see whether any inconsistencies have been flagged.

Note The Graph pane in the Cisco PTC Topology Management window shows a device status as unreachable when the Discovery process was unable to upload the configuration file from that particular device.

Resynchronizing a Specific Region

This section describes how to perform a resynchronization operation on a specific region, through the Topology Management window. See the "Resync Topology" section for a detailed description of the operations that are performed when you choose this menu option.

Step 1 Prior to invoking the resynchronization process, if changes have occurred in the SC2200 environment, you must ensure that the Cisco MGC Node Manager (CMNM) application is in sync with the SC2200. Click on the Management System View tab in the Topology Management window.

Step 2 Double-click on the CMNM object icon in the Tree View pane to expand the hierarchical view.

Step 3 Double-click on a CMNM host icon in the Tree View pane to expand the view to show the MGC devices under a particular CMNM.

Step 4 Right click on an MGC device icon in the Tree View pane, then choose the
Launch Applications > Cisco MGC Node Manager option.

Step 5 Enter the IP address of the CMNM host machine, then click OK.

The Cisco Element Management Framework Login window appears.

Step 6 Log into the CEMF host by entering admin for the username and password values.

The Cisco Element Management Framework Launch Pad window appears.

Step 7 Choose the Viewer icon in the CEMF Launch Pad window.

The Map Viewer window appears.

Step 8 Click the MGC-Node-View tab in the Map Viewer window.

Step 9 Right click on an MGC-node icon in the Tree View pane, then choose the
MGC Node > MGC Node State menu option.

The MGC Node State window appears.

Step 10 Click on the Rediscover button in the MGC Node State window.

Step 11 Click Yes in the Confirmation window.

The CMNM and SC2200 synchronization process in invoked.

Step 12 Upon successful completion of the CMNM and SC2200 synchronization process, exit the CEMF application.

Step 13 Click on the Network View tab in the Cisco PTC Topology Management window.

Step 14 Select the region object you wish to resynchronize.

Step 15 Choose the Actions > Resync Region menu option.

Step 16 Click OK to confirm.

Step 17 Check the Job Status pane in the to see whether any inconsistencies have been flagged.

Before performing any other resynchronization operations, you must wait for this resynchronization process to complete.

Searching for a Device in the Network View

This section describes how to perform a search operation while looking at the topology in Network View mode, through the Topology Management window.

Step 1 If the Network View is not currently displayed in the Topology Management window, click the Network View tab.

Step 2 Expand the tree view by clicking on the objects in the Tree View pane.

Step 3 Choose the Tools > Search menu option or click the Search Node icon in the Tool bar.

The Search Network View window appears.

Step 4 Enter any keyword, node name, or IP address of the device you are searching for in the Keyword/Nodename/IpAddress text field.

Step 5 Choose whether to search the entire network or a specific region by clicking the appropriate option in the Search In menu.

Step 6 Click the OK button.

The results are displayed in the Results pane. Each table entry represents a tree path that tells you the exact place the node is located in the MIT.

Step 7 You can refer to the displayed path and then expand the network tree view to that particular node by clicking on the various objects/icons in the Tree View pane or you can select the path entry in the table, then click the Locate button. The Topology Manager then navigates to that particular node in the Tree View pane and also displays and highlights the device object in the Graph pane.

Searching for a Device in the Management System View

This section describes how to perform a search operation while looking at the topology in Management System View mode, through the Topology Management window.

Note This search is limited as it only works with an expanded tree view.

Step 1 If the Management System View is not currently displayed in the Topology Management window, click the Management System View tab.

Step 2 Expand the tree view displayed in the Tree View pane by clicking on the network objects.

Step 3 Choose the Tools > Search menu option or click the Search Node icon in the Tool bar.

The Input window appears.

Step 4 Enter the name or IP address of the device you are searching for in the Node Name/IP Address text field.

Step 5 Click the OK button.

The device object is displayed and highlighted in the Graph pane.

Rearranging Network Element Icons in the Graph Pane

This section describes how to rearrange network element icons in the Graph pane.

Step 1 Double-click on the SanJose object in the Tree View pane.

The tree view in the Tree View pane is expanded to show the underlying SanJose region's network elements and the zoneclus network element icon is displayed in the Graph pane.

Step 2 Double-click on the zoneclus object in the Tree View pane.

Again, the tree view in the Tree View pane is expanded to show the underlying zoneclus object's network elements and the GKGroup_1 and tv-5400-2_172.29.129.128 network element icons are displayed in the Graph pane, as shown in Figure 3-9.

Figure 3-9 Expanded Virtual_Zone1 Object

Step 3 As shown in Figure 3-10, you can rearrange the network elements in the Graph pane. You do this by dragging and dropping the network element's icon in the desired location.

This feature is primarily used when multiple network element icons are displayed in the Graph pane and the icons and/or labels are jumbled together or when you wish to have the icons displayed along geographical lines.

Figure 3-10 Rearranged VirtualZone_1 Network Element Icons

Printing the Topology Image

This section describes how to print the topology image.

Step 1 Click on the Printer icon in the Tool bar.

The Print window appears.

Step 2 Enter the number of copies, the name of the printer (or click the File button to save the image to a file), any print command options, the paper size, and orientation in the appropriate fields, then click Print.

Step 3 The image is sent to either the printer or file you specified.

Zooming In and Out of the Topology Image

This section describes how to zoom in and out of the topology image.

Step 1 Click on the Zoom In or Zoom Out icon in the Tool bar.

The topology image is enlarged/decreased in size within the Graph pane.

Step 2 Use the Graph pane scroll bars to align the image for your viewing pleasure.

Redisplaying the Cisco PTC Launch Pad

You can redisplay the Cisco PTC Launch Pad window by clicking on the Launch icon in the Tool bar.