Cisco Systems 78-15589-01 User Manual

CHA PT ER

Managing ITP Networks Using SGM

This chapter provides details on using SGM to discover and manage your ITP networks. It includes the following sections:

• Becoming the Root User (Solaris Only), page 3-2

• Configuring SNMP, page 3-2

• Discovering the Network, page 3-6

• Configuring Seed Files, page 3-20

• Working with Views, page 3-26

• Working with Linksets, page 3-37

• Working with Nodes, page 3-91

• Working with Signaling Points, page 3-136

• Working with Links, page 3-170

• Working with Events, page 3-235

• Viewing the Topology of the Network, page 3-259

78-15589-01

• Viewing Server Status Information, page 3-274

• Finding Information in a Window, page 3-278

• Resizing, Sorting, and Hiding Table Columns, page 3-279

• Viewing Online Help, page 3-280

• Editing an ITP Route Table File, page 3-281

• Editing a Global Title Translation Table, page 3-290

• Working with SGM Statistics Reports, page 3-334

Cisco Signaling Gateway Manager User Guide

3-1

Chapter 3 Managing ITP Networks Using SGM

Becoming the Root User (Solaris Only)

• Printing SGM Windows, page 3-398

• Connecting to a New Server, page 3-399

• Integrating SGM with Other Products, page 3-401

• Using the Windows Start Menu, page 3-403

Becoming the Root User (Solaris Only)

Some SGM procedures require you to be logged in as the root user.

Caution As the root user, you can adversely affect your operating environment if you are

unaware of the effects of the commands you use. If you are a relatively inexperienced UNIX user, limit your activities as the root user to the tasks described in this manual.

If you are not logged in, log in as the root user:

> login: root

> Password: root-password

If you are already logged in, but not as the root user, use the su command to change your login to root:

# su

# Password:

Configuring SNMP

If SGM User-Based Access is disabled, or if it is enabled and you are a Network Administrator or System Administrator, SGM enables you to view and change some SNMP settings. (For more information about user authorization levels in SGM, see the “Configuring SGM User Authentication Levels (Solaris Only)”

section on page 4-6.)

Cisco Signaling Gateway Manager User Guide

3-2

root-password

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Note If you want to change SNMP settings, do so before running Discovery.

To change SNMP settings in SGM:

Step 1 Start the SGM client, as described in the “Starting SGM” section on page 2-2.

Step 2 Select Edit > SNMP Configuration from the SGM Main Menu. (If you have

implemented SGM User-Based Access, this option is available to users with authentication level Network Administrator [Level 4] and higher.) SGM displays the SNMP Configuration Dialog (Figure 3-1).

Figure 3-1 SNMP Configuration Dialog

Configuring SNMP

78-15589-01

The SNMP settings table displays SNMP information for nodes in SGM.

Step 3 (Optional) To delete a node, select it and click Delete.

Cisco Signaling Gateway Manager User Guide

3-3

Configuring SNMP

Step 4 (Optional) To change the IP address or DNS name of a node, select the node and

Step 5 (Optional) Nodes use SNMP community names for read access to the information

Chapter 3 Managing ITP Networks Using SGM

enter the new address or name in the IP Address Range or Hostname field.

• IP addresses use the format x.x.x.x, where each x has one of the following

values:

–

An integer in the range 0 through 255.

–

A range of integers separated by a dash (-), such as 10-60.

–

An asterisk (*), which is equivalent to specifying 0-255.

• Unlike IP addresses, you cannot specify a range of node names or use

wildcards in node names. Each node name corresponds to a single node in the network.

The default value for this field is the IP address *.*.*.*, which SGM uses for all nodes not covered by other IP address ranges or names.

Click Update to apply the new IP address to the selected node.

maintained by the SNMP agent on the ITP. To change the SNMP community name for a node, select the node and enter the new name in the Read Community field. This name must match the name used by the node. The default name is public.

Click Update to apply the new SNMP community name to the selected node.

For information about exporting SNMP community names from CiscoWorks2000 Resource Manager Essentials (RME), see the “Importing SNMP Community

Names from CiscoWorks2000 (Solaris Only)” section on page 5-2.

3-4

Step 6 (Optional) If you determine that SGM waits too long for a response from a node,

or does not wait long enough, you can change the timeout value. To change the time, in seconds, that SGM waits for a response from a node, select the node and enter the new timeout value in the Timeout (secs) field. The valid range is 1 to 60 seconds. The default value is 1 second.

Click Update to apply the new timeout to the selected node.

Step 7 (Optional) If you determine that SGM retries a node too many times, or not

enough times, you can change the number of retries. To change the number of times SGM attempts to connect to a node, select the node and enter the new number in the Retries field. The valid range is 0 to 99. The default value is 2retries.

Click Update to apply the new retries value to the selected node.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Step 8 (Optional) If you determine that SGM polls a node too often, or not often enough,

you can change the poll interval. To change the time, in minutes, between polls for a node, select the node and enter the new interval in the Poll Interval (mins) field. The valid range is 5 to 1440. The default value is 15 minutes.

Click Update to apply the new poll interval to the selected node.

Step 9 (Optional) To add a new node or range of nodes, enter the SNMP information in

the appropriate fields and click Add. The new SNMP settings are added to the SGM database.

When you are satisfied with all of your changes to the SNMP settings, select the File > Save menu option. SGM saves the changes, updates the SNMP information on the SGM server in real time, and closes the SNMP Configuration Dialog.

Note If another user modifies and saves the SNMP configuration before you

save your changes, SGM asks if you want to overwrite that user’s changes. If you choose to do so, the other user’s changes are overwritten and lost. If you choose not to do so, your changes are lost.

Configuring SNMP

78-15589-01

For more information about SNMP, refer to “Configuring SNMP Support” in the Cisco IOS Release 12.2 Configuration Fundamentals Configuration Guide, Part 3, Cisco IOS System Management.

SGM also provides the following SNMP-related commands:

• To set a new default SNMP read community name, use the sgm snmpcomm

command.

• To change the file used for SNMP parameters, such as community names,

timeouts, and retries, use the sgm snmpconf command.

• To query a host using SNMP GetRequests, use the sgm snmpget command.

• To query a host using SNMP GetNextRequests, use the sgm snmpnext

command.

• To query a host, using SNMP GetNextRequests to “walk” through the MIB,

use the sgm snmpwalk command.

For more information on the use of these commands, see the “SGM Commands

and Descriptions” section on page B-2.

Cisco Signaling Gateway Manager User Guide

3-5

Discovering the Network

SGM uses a Discovery process to populate the SGM database, discovering the nodes, signaling points, linksets, and links in your network.

You can run Discovery if SGM User-Based Access is disabled, or if it is enabled and you are a Network Administrator or System Administrator. (For more information about user authorization levels in SGM, see the “Configuring SGM

User Authentication Levels (Solaris Only)” section on page 4-6.)

Related Topics:

• Backing Up or Restoring SGM Files (Solaris Only), page 5-47

• Configuring Seed Files, page 3-20

• Investigating Data Problems, page 6-2

• Verifying Discovery, page 6-1

Chapter 3 Managing ITP Networks Using SGM

3-6

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

To discover the network in SGM:

Step 1 Start the SGM client, as described in the “Starting SGM” section on page 2-2.

Step 2 Select Edit > Network Discovery from the SGM Main Menu. SGM displays the

Discovery Dialog (Figure 3-2).

Figure 3-2 Discovery Dialog

Discovering the Network

78-15589-01

If you start the SGM client and the SGM database is empty (including the very first time you start the SGM client), SGM automatically opens the Discovery Dialog so you can run Discovery and populate the database.

Step 3 Select the Seed Settings tab, if it is not already selected. SGM displays the Seed

Settings panel, which enables you to create, save, load, and delete SGM seed files. Seed files are lists of seed nodes, which SGM uses to discover the nodes, signaling points, linksets, and links in your network.

Cisco Signaling Gateway Manager User Guide

3-7

Discovering the Network

Step 4 Load one or more seed nodes, using one of the following procedures:

Chapter 3 Managing ITP Networks Using SGM

• Enter the name or IP address of a seed node in the IP Address or DNS

Hostname field, and click Add Node.

SGM displays details of the SNMP settings for the seed nodes in the right pane of the window.

Continue adding seed nodes until you are certain that SGM will be able to discover the entire network.

• If you have already created and saved a seed file, select File > Load Seeds

from the Discovery Dialog menu. SGM displays the Load File Dialog: Seed File List dialog (Figure 3-3).

Figure 3-3 Load File Dialog: Seed File List Dialog

3-8

The Load File Dialog: Seed File List dialog contains the following fields:

–

Type—Icon indicating whether the item in the table is a file or a folder.

–

Name—Name of the seed file or folder.

–

Last Modified—Date and time the seed file or folder was last modified.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

–

Size (bytes)—Size of the seed file or folder, in bytes.

–

Make this my preferred start option—Specifies whether the selected seed file is to be loaded automatically whenever this SGM client is started or the Discovery Dialog is opened. By default, this checkbox is cleared for all seed files. That is, no seed file is loaded automatically when the SGM client is started or the Discovery Dialog is opened.

–

Number of Files—Total number of seed files and folders (displayed in bottom left corner).

To load a seed file, select the seed file in the list and click OK.

SGM closes the Load File Dialog: Seed File List dialog, loads the seed file, and returns to the Discovery Dialog. SGM lists all of the seed nodes in the seed file in the left pane of the window, and displays details of the SNMP settings for the seed nodes in the right pane.

To close the Load File Dialog: Seed File List dialog without loading a seed file, click Cancel.

Step 5 Select the Discovery tab, or click Next. SGM displays the Discovery panel

(Figure 3-4), which enables you to discover the nodes, signaling points, linksets, and links in your network. (If you enter a seed node IP address or name in the IP Address or DNS Hostname field, then click Next, SGM automatically adds the seed node before displaying the Discovery panel.)

Discovering the Network

78-15589-01

Cisco Signaling Gateway Manager User Guide

3-9

Discovering the Network

Figure 3-4 Discovery Panel

Chapter 3 Managing ITP Networks Using SGM

3-10

Step 6

(Optional) Specify the extent of the network discovery.

• To discover the entire network, select the Entire Network checkbox. This is

called recursive discovery, and it is the default setting. Select this checkbox when you run Discovery for the very first time.

With this checkbox selected, SGM discovers all seed nodes and attempts to manage them; then attempts to discover and manage all ITP nodes that are adjacent to those seed nodes (unless the nodes are connected by serial links only); then attempts to discover and manage all ITP nodes that are adjacent to those nodes; and so on, until SGM has discovered the entire network.

• To rediscover only seed nodes, clear the Entire Network checkbox. This is

called nonrecursive discovery.

With this checkbox cleared, SGM discovers all seed nodes and attempts to manage them, then labels all nodes that are adjacent to those seed nodes Unmanaged.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

If you run Discovery with Entire Network cleared, then you run Discovery with Entire Network selected, any Unmanaged nodes in the first Discovery are not

rediscovered by the second Discovery.

To recover from this situation and generate a new, complete, and reliable SGM database, you must perform one of the following procedures:

a. Run Discovery again, with both Entire Network and Delete Existing Data

selected.

b. Change the Unmanaged nodes to managed status. See the “Unmanaging and

Managing a Node” section on page 3-133 for more information.

c. Poll the nodes that were Unmanaged in the first Discovery. See the “Polling

a Node” section on page 3-134 for more information.

Step 7 (Optional) Specify whether SGM is to keep or delete the existing database when

discovering the network:

• To keep all existing network data in the SGM database before rediscovering

the network, clear the Delete Existing Data checkbox. This is the default setting. Clear this checkbox when you run Discovery for the very first time.

• To delete all existing network data from the SGM database before

rediscovering the network, select the Delete Existing Data checkbox. Choose this option if you know that network elements have been deleted from your network since the last Discovery.

Discovering the Network

78-15589-01

Note If you discover the network with Delete Existing Data selected, SGM

stops any real-time polls that are running and issues appropriate messages.

Cisco Signaling Gateway Manager User Guide

3-11

Discovering the Network

Step 8 Click Discover Network to begin Discovery.

Step 9 (Optional) To stop the Discovery process at any time, click Stop Discovery. For

Chapter 3 Managing ITP Networks Using SGM

When Discovery begins:

• The Discover Network button is grayed-out.

• The “Discovery In Progress” message is displayed at the bottom of the

Discovery Dialog.

• The “Discovery In Progress” message is displayed in the title bar of all SGM

client windows.

Discovery progresses in bursts. You might see a number of updates, followed by a pause, followed by more updates. The information displayed in SGM windows is not fully updated until Discovery is complete.

By default, Discovery times out after 600 seconds (10 minutes). To change the Discovery timeout, change the value of the DISCOVERY_TIMELIMIT entry in the Server.properties file:

• If you installed SGM in the default directory, /opt, then the location of the

Server.properties file is /opt/CSCOsgm/properties/Server.properties.

• If you installed SGM in a different directory, then the Server.properties file is

located in that directory.

Because SGM is an asynchronous system, with the SGM server contacting clients one at a time, and because clients might run at different speeds, the information displayed by SGM clients during Discovery might not always be synchronized.

example, if you click Discover Network, then you realize that you loaded a seed node that you did not intend to load, you can click Stop Discovery to stop the Discovery process.

3-12

Note If you stop the Discovery process, the information in the SGM database

is incomplete and unreliable. To generate a new, complete, and reliable SGM database, you must run Discovery again, with Delete Existing Data selected.

Step 10 When the “Discovery In Progress” message disappears, Discovery is complete.

The Discovered Nodes section of the Discovery panel (Figure 3-5) lists all nodes that were discovered by SGM. By default, this table is sorted by Status.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Figure 3-5 Discovery Panel with Discovered Nodes

Discovering the Network

78-15589-01

By default, SGM displays all of the columns in the Discovered Nodes section except Internal ID, ITP Uptime, Reboot Reason, and Last Status Change. To display these columns, or to hide other columns, see the procedures in the

“Modifying Node Table Column Settings” section on page 5-16.

To see mouse over help popup for each column in the table, place the cursor over a column header.

If a cell is too small to show all of its data, place the cursor over the cell to see the full data in a mouse over help popup.

You can resize each column, or sort the table based on the information in one of the columns. See the “Resizing, Sorting, and Hiding Table Columns” section on

page 3-279 for more details.

Cisco Signaling Gateway Manager User Guide

3-13

Discovering the Network

Chapter 3 Managing ITP Networks Using SGM

The Discovered Nodes section displays the following information for each discovered node:

• Internal ID—Internal ID of the event. The internal ID is a unique ID for

every event, link, linkset, signaling point, and node, assigned by SGM for its own internal use. It can also be useful when the TAC is debugging problems.

• Name—Name or IP address of the discovered node.

• Primary SNMP Address—IP address of the node, used by SNMP to poll the

node. (There might be other IP addresses on the node that are not the primary SNMP address.)

• CLLI Code—COMMON LANGUAGE Location Identification Code for the

node. A CLLI code is a standardized 11-character identifier that uniquely identifies the geographic location of the node. If the node has no CLLI code configured, this field is blank.

• Device Type—Device type of the node. Possible values are:

–

Cisco2650—Cisco 2650 series router

–

Cisco2650XM—Cisco 2650XM series router

–

Cisco2651—Cisco 2651 series router

–

Cisco2651XM—Cisco 2651XM series router

–

Cisco7204—Cisco 7204 series router

3-14

–

Cisco7204VXR—Cisco 7204VXR series router

–

Cisco7206—Cisco 7206 series router

–

Cisco7206VXR—Cisco 7206VXR series router

–

Cisco7507—Cisco 7507 series router

–

Cisco7507mx—Cisco 7507mx series router

–

Cisco7507z—Cisco 7507z series router

–

Cisco7513—Cisco 7513 series router

–

Cisco7513mx—Cisco 7513mx series router

–

Cisco7513z—Cisco 7513z series router

–

IPDevice—IP device, other than those listed above. You can assign this icon to an unknown node if you know that it is an IP device.

–

Unknown—SGM is unable to determine the device type.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

• ITP MIB Level—MIB conformance level used by the ITP, such as ITP MB5.

• ITP Uptime—Time the ITP has been up, in weeks, days, hours, minutes, and

seconds.

• Reboot Reason—Reason for the last reboot of the ITP.

• Notes—Indicates whether there is a note associated with the node.

• Events—Indicates whether there is a recent event associated with the node.

During Discovery, SGM might flag most nodes with an event icon. If the event icons are too distracting, select Edit > Clear All Events from the SGM Main Menu to remove them.

• Last Status Change—Date and time that the status of the node last changed.

• Status—Current status of the node. Possible values are:

–

Active (green ball)—The node is currently fully functional.

–

Discovering (gray ball)—The node is being discovered, and SNMP queries have been sent to the device.

–

Polling (gray ball)—The node is being polled.

–

Unknown (red ball)—The node failed to respond to an SNMP request. SGM sets all associated signaling points, linksets, and links to Unknown.

–

Unmanaged (gray ball)—One of the following situations exists:

– The node is known indirectly by SGM. In other words, SGM knows the device exists but there is no known SNMP stack on the device for SGM to query.

Discovering the Network

78-15589-01

– An SGM user has set the node to Unmanaged status, to prevent SGM from polling the node.

If the associated signaling points are referenced via linksets to other signaling points, SGM automatically sets all associated signaling points to Unmanaged, and deletes all associated linksets and links, as well as all linksets and links that reference the node as an adjacent node.

If the associated signaling points are not referenced to other signaling points, SGM automatically deletes the signaling points, all associated linksets and links, and all linksets and links that reference the node as an adjacent node.

Cisco Signaling Gateway Manager User Guide

3-15

Discovering the Network

Chapter 3 Managing ITP Networks Using SGM

–

Waiting (gray ball)—The node is in the Discovery queue but is not currently being discovered.

–

Warning (yellow ball)—The node is active, but one or more associated signaling points, linksets, or links is in Failed, Unavailable, Unknown, or Warning status and is not Ignored.

• Status Reason—Reason for the current status of the node. Possible values

are:

–

None

–

SGM Restart

–

Unsupported Configuration

–

Unconfigured

–

SNMP Timeout

–

Device is unreachable, possibly wrong community string

–

Not ITP Device

–

Not Configured for ITP

–

MIB Data Error

–

SNMP Exception

–

SignalingPoint Inactive

3-16

–

Linkset Inactive

–

Link Congested

–

Link Send Utilization Threshold Exceeded

–

Link Receive Utilization Threshold Exceeded

–

Link Local Interface Inactive

–

Link Remote Interface Inactive

–

Link Inactive

If the cell is too small to show all of the status reason, place the cursor over the cell to see the full status reason in a mouse over help popup.

The status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude is displayed.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

If the status reason is Unsupported Configuration, correct the configuration and enter the sgm cleandiscover command to delete all current network data and begin a clean discovery of the ITP network. If the status reason is still Unsupported Configuration, enter the sgm clean command to restore the SGM server to a “clean” state, such as would exist after a new installation of SGM. For more information on the use of these commands, see the “SGM

Commands and Descriptions” section on page B-2.

The “Viewing Detailed Information for a Link” section on page 3-175 displays additional information about the causes of link failures.

The “Viewing Detailed Information for a Linkset” section on page 3-42 displays additional information about the causes of linkset failures.

All discovered nodes are placed in a DEFAULT configuration view, which is stored on the SGM server and shared by all SGM clients. Initially, all clients use the DEFAULT view. Clients can then create their own views, which are subsets of the DEFAULT view, to meet their individual needs. However, the DEFAULT view stored on the SGM server cannot be modified by the clients. It is always available, for users who need to view the entire network.

All other SGM windows (Node, Signaling Point, Linkset, Topology, and so on) are also populated with the newly discovered network data.

Discovering the Network

78-15589-01

Step 11 (Optional) To delete a node or nodes from the Discovery database, select the

nodes and click Delete Node. SGM deletes the nodes without asking for confirmation.

Step 12 (Optional) Examine the Discovered Nodes table to verify that SGM discovered all

of the nodes in the network. If you suspect that SGM did not discover all of the nodes, see the “Verifying Discovery” section on page 6-1 for troubleshooting information. You might need to add more seed nodes and run Discovery again.

Step 13 When you are satisfied that SGM discovered all of the nodes in the network, save

the list of seed nodes in a seed file, using one of the following procedures:

• To save the changes you have made to the seed file without changing the name

of the file, select File > Save from the Discovery Dialog menu.

• To save the changes you have made to the seed file with a new name, select

File > Save As from the Discovery Dialog menu. SGM displays the Save File Dialog: Seed File List dialog (Figure 3-6).

Cisco Signaling Gateway Manager User Guide

3-17

Discovering the Network

Chapter 3 Managing ITP Networks Using SGM

Figure 3-6 Save File Dialog: Seed File List Dialog

3-18

The Save File Dialog: Seed File List dialog contains the following fields:

• Type—Icon indicating whether the item in the table is a file or a folder.

• Name—Name of the seed file or folder.

• Last Modified—Date and time the seed file or folder was last modified.

• Size (bytes)—Size of the seed file or folder, in bytes.

• Filename—Name by which you want to save the seed file.

If you create a new seed file name, you can use any letters, numbers, or characters in the name that are allowed by your operating system. However, if you include any spaces in the new name, SGM converts those spaces to dashes. For example, SGM saves file “a b c” as “a-b-c”.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

• Make this my preferred start option—Specifies whether the selected seed

file is to be loaded automatically whenever this SGM client is started or the Discovery Dialog is opened. By default, this checkbox is cleared for all seed files. That is, no seed file is loaded automatically when the SGM client is started or the Discovery Dialog is opened.

• Number of Files—Total number of seed files and folders (displayed in

bottom left corner).

To save the seed file with a new name, use one of the following procedures:

• To save the file with a completely new name, enter the new name and click

OK.

• To save the file with an existing name, overwriting an old seed file, select the

name in the list and click OK.

SGM saves the seed file with the new name, closes the Save File Dialog: Seed File List dialog, and returns to the Discovery Dialog.

Note If another user modifies and saves the seed file before you save your

changes, SGM asks if you want to overwrite that user’s changes. If you choose to do so, the other user’s changes are overwritten and lost. If you choose not to do so, your changes are lost, unless you save the seed file to a different filename.

Discovering the Network

78-15589-01

SGM stores the seed file in the seed file directory on the SGM server:

• If you installed SGM in the default directory, /opt, then the SGM seed file

directory is /opt/CSCOsgm/seeds.

• If you installed SGM in a different directory, then the SGM seed file directory

is located in that directory.

To delete a seed file from the seed file list, select a file and click Delete. SGM issues an informational message containing the name and location of the deleted file.

To save any changes you made to the list of files, click OK. SGM saves the changes and closes the Save File Dialog: Seed File List dialog.

To close the Save File Dialog: Seed File List dialog without saving the seed file or saving any changes to the seed file list, click Cancel.

Cisco Signaling Gateway Manager User Guide

3-19

Configuring Seed Files

You can run Discovery multiple times to attempt to discover additional nodes based on the IP address defined in the Stream Control Transmission Protocol (SCTP) linksets. If you are using a separate management VLAN to manage your nodes, but private or unreachable IP addresses for your SCTP connectivity, clear the Entire Network checkbox in the Discovery Dialog. Otherwise, Discovery attempts to reach those nodes continuously. Instead, enter all nodes to be discovered directly into the seed list and do a nonrecursive Discovery.

Configuring Seed Files

SGM enables you to create, save, load, and delete SGM seed files.

This section includes the following information:

• Creating a New Seed File, page 3-20

• Modifying an Existing Seed File, page 3-22

• Creating and Modifying Seed Files Using a Text Editor, page 3-24

Creating a New Seed File

To create a new seed file in SGM:

Step 1 Select Edit > Network Discovery from the SGM Main Menu. SGM displays the

Discovery Dialog (Figure 3-2).

Step 2 Select the Seed Settings tab, if it is not already selected. SGM displays the Seed

Settings panel.

Step 3 Enter the name or IP address of a seed node in the IP Address or DNS Hostname

field, and click Add Node. SGM displays details of the SNMP settings for the seed node in the right pane of the window.

Continue to add as many seed nodes as necessary.

Cisco Signaling Gateway Manager User Guide

3-20

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Step 4 When you are ready to save the list of seed nodes in a new seed file, select File >

Save As from the Discovery Dialog menu. SGM displays the Save File Dialog: Seed File List dialog (Figure 3-6).

The Save File Dialog: Seed File List dialog contains the following fields:

• Type—Icon indicating whether the item in the table is a file or a folder.

• Name—Name of the seed file or folder.

• Last Modified—Date and time the seed file or folder was last modified.

• Size (bytes)—Size of the seed file or folder, in bytes.

• Filename—Name by which you want to save the seed file. You can use any

letters, numbers, or characters in the name that are allowed by your operating system. However, if you include any spaces in the new name, SGM converts those spaces to dashes. For example, SGM saves file “a b c” as “a-b-c”.

• Make this my preferred start option—Specifies whether the selected seed

Configuring Seed Files

78-15589-01

• Number of Files—Total number of seed files and folders (displayed in

bottom left corner).

Enter the new name and click OK. SGM saves the seed file with the new name, closes the Save File Dialog: Seed File List dialog, and returns to the Discovery Dialog.

SGM stores the new seed file in the seed file directory on the SGM server:

• If you installed SGM in the default directory, /opt, then the SGM seed file

directory is /opt/CSCOsgm/seeds.

• If you installed SGM in a different directory, then the SGM seed file directory

is located in that directory.

Cisco Signaling Gateway Manager User Guide

3-21

Configuring Seed Files

Modifying an Existing Seed File

To modify an existing seed file in SGM:

Step 1 Select Edit > Network Discovery from the SGM Main Menu. SGM displays the

Discovery Dialog (Figure 3-2).

Step 2 Select the Seed Settings tab, if it is not already selected. SGM displays the Seed

Settings panel.

Step 3 Select File > Load Seeds from the Discovery Dialog menu. SGM displays the

Load File Dialog: Seed File List dialog (Figure 3-3).

The Load File Dialog: Seed File List dialog contains the following fields:

• Type—Icon indicating whether the item in the table is a file or a folder.

• Name—Name of the seed file or folder.

• Last Modified—Date and time the seed file or folder was last modified.

• Size (bytes)—Size of the seed file or folder, in bytes.

• Make this my preferred start option—Specifies whether the selected seed

• Number of Files—Total number of seed files and folders (displayed in

bottom left corner).

Chapter 3 Managing ITP Networks Using SGM

3-22

To load a seed file, select the seed file in the list and click OK.

To close the Load File Dialog: Seed File List dialog without loading a seed file, click Cancel.

Step 4 (Optional) To add another seed node to the seed file, enter the name or IP address

of the seed node in the IP Address or DNS Hostname field, and click Add Node.

Step 5 (Optional) To delete a seed node from the seed file, select the seed node and click

Delete Node.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Step 6 When you are ready to save the modified seed file, use one of the following

procedures:

• To save the changes you have made to the seed file without changing the name

of the file, select File > Save from the Discovery Dialog menu.

• To save the changes you have made to the seed file with a new name, select

File > Save As from the Discovery Dialog menu. SGM displays the Save File Dialog: Seed File List dialog (Figure 3-6).

The Save File Dialog: Seed File List dialog contains the following fields:

• Type—Icon indicating whether the item in the table is a file or a folder.

• Name—Name of the seed file or folder.

• Last Modified—Date and time the seed file or folder was last modified.

• Size (bytes)—Size of the seed file or folder, in bytes.

• Filename—Name by which you want to save the seed file.

• Make this my preferred start option—Specifies whether the selected seed

Configuring Seed Files

78-15589-01

• Number of Files—Total number of seed files and folders (displayed in

bottom left corner).

To save the seed file with a new name, use one of the following procedures:

• To save the file with a completely new name, enter the new name and click

OK.

• To save the file with an existing name, overwriting an old seed file, select the

name in the list and click OK.

SGM saves the seed file with the new name, closes the Save File Dialog: Seed File List dialog, and returns to the Discovery Dialog.

Cisco Signaling Gateway Manager User Guide

3-23

Configuring Seed Files

Note If another user modifies and saves the seed file before you save your changes,

Chapter 3 Managing ITP Networks Using SGM

SGM asks if you want to overwrite that user’s changes. If you choose to do so, the other user’s changes are overwritten and lost. If you choose not to do so, your changes are lost, unless you save the seed file to a different filename.

SGM stores the seed file in the seed file directory on the SGM server:

• If you installed SGM in the default directory, /opt, then the SGM seed file

directory is /opt/CSCOsgm/seeds.

• If you installed SGM in a different directory, then the SGM seed file directory

is located in that directory.

To delete a seed file from the seed file list, select a file and click Delete. SGM issues an informational message containing the name and location of the deleted file.

To save any changes you made to the list of files, click OK. SGM saves the changes and closes the Load File Dialog: Seed File List dialog.

To close the Save File Dialog: Seed File List dialog without saving the seed file or saving any changes to the seed file list, click Cancel.

Creating and Modifying Seed Files Using a Text Editor

A seed file is simply an unformatted list of seed node names. To create a seed file using a text editor, simply create a file and list the seed node names, one on each line, with no other formatting:

new-york-a

new-york-b

chicago-c

Cisco Signaling Gateway Manager User Guide

3-24

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

When you save and name the seed file, keep the following considerations in mind:

• You can use any letters, numbers, or characters in the name that are allowed

by your operating system.

• SGM saves the seed file with a .see file extension.

• SGM saves the seed file in the SGM server’s seed file directory, seeds:

–

If you installed SGM in the default directory, /opt, then the seed file directory is /opt/CSCOsgm/seeds/.

–

If you installed SGM in a different directory, then the seed file directory is located in that directory.

When SGM loads the seed file, it verifies the syntax of the file, deleting blank lines and extraneous leading and trailing spaces as needed. SGM also verifies that each seed node name resolves to a valid IP address. If a name does not resolve to a valid IP address, SGM logs the erroneous entry and ignores it.

For example, given the following seed file:

new-york-a<space>

<space>new-york-b

Configuring Seed Files

78-15589-01

zzzzzzzzzzzz

<tab>chicago-c<tab>

SGM loads the following entries:

new-york-a

new-york-b

chicago-c

Cisco Signaling Gateway Manager User Guide

3-25

Working with Views

When SGM discovers your network, all discovered nodes, signaling points, linksets, and links are placed in a DEFAULT configuration view, which is stored on the SGM server and shared by all SGM clients. The DEFAULT view cannot be modified by the clients. It is always available, for users who need to view the entire network.

Initially, all clients use the DEFAULT view. However, SGM enables you to create your own, client-specific views, which are subsets of the DEFAULT view, to meet your individual needs.

You can choose the nodes you are interested in managing, remove all other nodes from your view, and modify the layout of the topology map in the Topology window. You can save all of this customized information in a view, set that view as the default view for the SGM client, and use the SGM client from then on to manage only the part of the network you are interested in, with the settings you prefer.

You can also create many different views on a given SGM client, with each view devoted to a different aspect of the network. You can then switch between views to manage different parts of the network, or switch to the DEFAULT view to see the entire network.

If a given SGM client is used by more than one person, each user can create his or her own personal view.

To help you keep track of which view you are currently using, most SGM windows display the following information:

Chapter 3 Managing ITP Networks Using SGM

3-26

• In the title bar, the name of the system on which the SGM server is running.

• In the bottom right corner:

–

The name of the current view.

–

The text (New Nodes Exist), if there is at least one newly discovered node or signaling point in the network that has not been added to your current view. To add the node to your current view, see the “Viewing the

Topology of the Network” section on page 3-259. To exclude the node

from your current view, see Step 6 in this section.

–

The text (Modified), if the view has been modified but not yet saved. You must save the view if you want to save your changes. See Step 10 in this section for more details.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

If your personal default view has been deleted, then the next time you launch the client SGM informs you that your default view has been deleted and that your view has been reset to the DEFAULT view. To choose another view as your default view, use the Load File Dialog: View List. See the “Loading a Client-Specific

View” section on page 3-35 for details.

This section includes the following information:

• Creating a View, page 3-27

• Loading the DEFAULT View, page 3-35

• Loading a Client-Specific View, page 3-35

Creating a View

To create a client-specific network view:

Step 1 Before creating a client-specific network view, make sure that Discovery has been

run at least once, and there is data in the server’s SGM database. See the

“Discovering the Network” section on page 3-6 for details.

Step 2 Select Edit > Network Views from the SGM Main Menu. SGM displays the

Network View Editor window (Figure 3-7).

78-15589-01

Cisco Signaling Gateway Manager User Guide

3-27

Working with Views

Figure 3-7 Network View Editor Window

Chapter 3 Managing ITP Networks Using SGM

3-28

The Nodes panel and Signaling Points panel display:

• New nodes and signaling points that have been found by SGM.

• All nodes and signaling points that are in the current view.

• All nodes and signaling points that have been excluded from the current view.

The Nodes panel and Signaling Points panel also enable you to move nodes and signaling points into and out of the current view. All changes made in these panels are reflected in topology tables and maps as soon as you make the changes.

To display the Nodes panel, select the Nodes tab.

To display the Signaling Points panel, select the Signaling Points tab.

Step 3 (Optional) If you have already saved a view and you want to modify it, select the

File > Load menu option. SGM prompts you for the name of the view you want to load. Enter the name of the view, or accept the default view name, then click OK to load the view.

Cisco Signaling Gateway Manager User Guide

78-15589-01

Chapter 3 Managing ITP Networks Using SGM

Step 4 (Optional) The Nodes In Current View table lists the nodes that are in the current

view. If there are nodes listed in the Nodes In Current View table that you do not want to manage, you can remove them from the current view. To do so, select one or more nodes in the Nodes In Current View table, then click the right-arrow button to move the nodes to the Nodes Excluded from View table.

Note If you are using an SGM client with the DEFAULT view set, SGM

automatically adds all newly discovered nodes to the Nodes In Current View table as soon as they are discovered.

If you delete a node, SGM removes it from the Nodes In Current View table. If SGM then discovers the node, SGM places it in the New Nodes Found table. To see this node again in your current view, you must move it into the Nodes In Current View table.

At times, you might want to make an existing node a new node. To do so, select one or more nodes in the Nodes In Current View table, then click the left-arrow button to move the nodes to the New Nodes Found table.

Step 5 (Optional) The Nodes Excluded from View table lists the nodes that have been

excluded from the current view. To add these nodes to the current view, select them in the Nodes Excluded from View table and click the left-arrow button to move the node to the Nodes In Current View table.

At times, you might want to make an excluded node a new node. To do so, select one or more nodes in the Nodes Excluded From View table, click the left-arrow button to move the node to the Nodes In Current View table, then click the next left-arrow button to move the nodes to the New Nodes Found table.

Working with Views

78-15589-01

Step 6 (Optional) The New Nodes Found table displays newly discovered nodes, based

on the following criteria:

• If you are using an SGM client with the DEFAULT view set, this table never

contains any nodes. In the DEFAULT view, SGM adds all newly discovered nodes to the Nodes In Current View table as soon as they are discovered.

• If you are using an SGM client with a custom view set, this table contains all

nodes discovered since the Network View Editor window was opened in this session that have not been excluded in the Nodes Excluded from View table, or that are not in the current view.

Cisco Signaling Gateway Manager User Guide

3-29

Working with Views

Step 7 (Optional) The Signaling Points In Current View table lists the signaling points

Chapter 3 Managing ITP Networks Using SGM

When SGM discovers one or more new nodes in the network, SGM also takes the following actions:

• SGM broadcasts the discovery of the new nodes to all SGM clients.

• SGM displays the text (New Nodes Exist) in the bottom right corner of most

SGM windows.

• SGM adds graphical elements for the newly discovered nodes to the topology

new signaling point panel in the left pane of the Topology window. For more information, see the “Viewing the Topology of the Network” section on

page 3-259.

To add a newly discovered node to the current view, select one or more nodes and click the right-arrow button to move them to the Nodes In Current View table.

To exclude a newly discovered node from the current view, select the node, click the right-arrow button to move the node to the Nodes In Current View table, then click the next right-arrow button to move the node to the Nodes Excluded From View table.

that are in the current view. If there are signaling points listed in the Signaling Points In Current View table that you do not want to manage, you can remove them from the current view. To do so, select one or more signaling points in the Signaling Points In Current View table, then click the right-arrow button to move the signaling points to the Signaling Points Excluded from View table.

3-30

Note If you are using an SGM client with the DEFAULT view set, SGM

automatically adds all newly discovered signaling points to the Signaling Points In Current View table as soon as they are discovered.

If you delete a signaling point, SGM removes it from the Signaling Points In Current View table. If SGM then discovers the signaling point, SGM places it in the New Signaling Points Found table. To see this signaling point again in your current view, you must move it into the Signaling Points In Current View table.

At times, you might want to make an existing signaling point a new signaling point. To do so, select one or more signaling points in the Signaling Points In Current View table, then click the left-arrow button to move the signaling points to the New Signaling Points Found table.

Cisco Signaling Gateway Manager User Guide

78-15589-01

+ 376 hidden pages