Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Network Node Manager i Software10.30

Use > Monitor with the NNM iSPI for IP Telephony > Cisco IP Telephony > Monitor Cisco IP phones

Monitor IP Phones

The IP Phones view displays a list of available Cisco IP phones on the network. The view arranges the key attributes of all discovered Cisco IP phones in a table.

To launch the IP Phones view:

From the Workspaces navigation pane, click Cisco IP Telephony > IP Phones. The IP Phones view opens on the right pane.

You can see the IP phones associated with a cluster from Cluster Details form.

To launch the IP Phones view from Cluster Details form:

From the Workspaces navigation pane, click Cisco IP Telephony > UCM Clusters. The UCM Clusters view opens in the right pane.
Select a UCM Cluster of your interest and click (the Open icon). The UCM Cluster Details form opens.
Click the IP Phones tab. The IP Phones view opens on the right pane.

Basic Attributes of the IP Phones Table
Attribute	Description
Registration State	The registration status of the Cisco IP phone line with its current controller. Possible values are as follows: Registered Unregistered Unknown Rejected
Extension Number	The extension number of the IP phone.
Model	The model of the IP phone.
Protocol	The protocol supported by the IP phone. The protocol can be Skinny Client Control Protocol (SCCP) or Session Initiation Protocol (SIP).
IP Address	The IP address of the IP phone.
Call Server	The call controller with which the IP phone is registered.
UCM Cluster	The name of the UCM cluster to which the IP phone is associated.
Tenant	The name of the tenant to which the IP phone belongs.
Device Pool	The name of the device pool to which the IP phone is associated.
SRST Router	The name of the Survivable Remote Site Telephony (SRST) router configured for the IP phone.
Management Server	The management server for the IP phone. This attribute displays one of the following values: Local: If the IP phone is being managed by the NNMi management server console on which you are viewing the IP phone details. Name of the regional manager that manages the IP phone.
Route Partition	The logical grouping of extension numbers and route patterns to which the shared line extension number belongs.
Shared Line	The extension number that is assigned to two or more IP phones. The extension number is part of the same route partition in all the IP phones.

When the status of a phone changes to Unregistered, the NNM iSPI for IP Telephony sends an incident to the NNMi incident browser.

You can view the details of a single IP phone in a form.

To view the Cisco Extension Details form:

From the IP Phones view, select the node of your interest, and then click (the Open icon). The Cisco Extension Details form opens.

To view the Node Form for the IP phone, click , and then click Open. The Node Form opens displaying the details of the IP phone.

View Cisco IP Telephony Reports

You can select an IP phone from the inventory and click Actions > IP Telephony Reports and select one of the following options to launch a chart detail report for the selected attribute:

Average Duration of Calls Made
Average Duration of Calls Received
Termination Reasons for Calls Made
Termination Reasons for Calls Received.

See the NNM iSPI for IP Telephony Cisco IPT CDR Collection extension pack report online help for more information.

Analysis Pane

The Analysis pane of the IP Phone displays a summary of the details of the selected IP Phone as follows:

Cisco Extension details Summary tab

Name: The name of the selected IP phone.
Cluster: The name of the UCM cluster to which the selected IP phone is associated.
Call Server: The UCM with which the selected IP phone is registered.
Tenant: The name of the tenant to which the IP phone belongs.
Management Server: The management server for the IP phone. This attribute displays one of the following values:
- Local: If the IP phone is being managed by the NNMi management server console on which you are viewing the IP phone details.
- Name of the regional manager that manages the IP phone.

Extension Information tab

Management Mode: The management status of the selected IP phone.
Registration State: The registration status of the selected IP phone with its current UCM.
IP Address: The IP address of the selected IP phone.
MAC Address: The MAC address of the selected IP phone.
Route Partition: The logical grouping of extension numbers and route patterns to which the shared line extension number belongs.
Shared Line: The extension number that is assigned to two or more IP phones. The extension number is part of the same route partition in all the IP phones.
Description: A short description of the selected IP phone.
Model: The model of the selected IP phone.
Device Pool: The name of the device pool to which the IP phone is associated.

Filter Cisco IP phones

You can filter the listed IP phones in the IP Phones view with the available filters. You can perform the filtering action only on the Registration State, IP Address, Extension Number, Route Partition, Shared Line, Tenant, Call Server, UCM Cluster, Device Pool, SRST Router, or Management Server columns.

To filter the IP Phones view:

Right-click the Registration State, IP Address, Extension Number, Route Partition, Shared Line, Tenant, Call Server, SRST Router, or Management Server attribute of one of the IP phones listed in the IP Phones view.
Select one of the following filters:

Equals this value: filters and lists all the IP phones that have a value that is equal to the value of the column that you selected.
Create Filter: opens the Filter dialog box. This dialog box helps you specify a string and select options to perform filtering based on the string specified.
Is not empty: filters and lists all the IP Phones for which the selected column is not empty.
Is empty: filters and lists all the IP Phones for which the selected column is empty.
Not equal to this value: filters and lists all the IP phones that do not have the value in the column that you selected.

The filtered list of Cisco IP phones appears in the view.

After viewing the filtered list, always remove the filter. To remove the filter, right-click the filter attribute, and then click Remove Filter.

Cisco Extension Details form

The Cisco Extension Details form helps you view the node details of the selected Cisco IP phone and the Cisco Call Controller servers associated with it. The form presents two different panes.

The right pane lists the following details:

Current Controller: This tab displays the details of the Cisco Call Controller server that currently controls the selected Cisco IP Phone. The tab displays the details of the Cisco Call Controller in the format presented in the Call Controllers view .
Previous Controller: The Previous Call Controllers tab displays the details of the Cisco Call Controller server that was previously controlling the selected Cisco IP phone. The tab displays the details of the Cisco Call Controller in the format presented in the Call Controllers view.
Incidents: This tab displays the incidents generated for the IP phones.

The left pane lists the following details of the selected Cisco IP phone:

Basic Attributes of the Selected Cisco IP Phone
Attribute	Description
Hosted Node	The node on which the IP Phone is hosted.
Extension Number	The extension number configured for the IP Phone.
Route Partition	The logical grouping of extension numbers and route patterns to which the shared line extension number belongs.
Shared Line	The extension number that is assigned to two or more IP phones. The extension number is part of the same route partition in all the IP phones.
Registration State	The registration status of the Cisco IP phone line with its current controller. Possible values are as follows: Registered Unregistered Unknown Rejected
IP Address	The IP address of the IP phone.
MAC Address	The MAC address of the Cisco IP phone.
Description	A short description of the phone.
Model	The model of the phone.
Management Mode	The management status of the node. The status can be any of the following strings: Managed: indicates that the node is managed by the NNM iSPI for IP Telephony. Out of Service: indicates that the node is currently out of service and not managed by the NNM iSPI for IP Telephony. Unmanaged: indicates that the node is currently not managed by the NNM iSPI for IP Telephony.
Protocol	The protocol used by the phone.
Device Pool	The name of the device pool to which the IP phone is associated.
SRST Router	The name of the SRST router.
Tenant	The name of the tenant to which the IP phone belongs.
Location	The location configured for the IP phone.
Site Code	The site code configured for the IP phone.
Mail Code	The mail code configured for the IP phone.

Analysis Pane

The Analysis pane displays a summary of the details of the selected IP phone.

Update Site Codes, Mail Codes, and Location Details of Cisco IP Phones

You can update the site code, mail code, and location of an IP phone from IP phone details form as follows:

Open the IP phone's details form.
Type the new site code, mail code, and location.
Save your changes.

Alternatively, you can update the site codes, mail codes, and locations of all Cisco IP phones on your network by using nmsiptconfigimport.ovpl command. You can import the new site codes, mail codes, and locations from a comma-separated values (CSV) file and update the IP phones with the new values.

To update the site codes, mail codes, and locations of Cisco IP phones from the command line:

Create a CSV file in the following format:

Tenant,Cluster,Device Pool,IP Phone,Site code,Mail code,Location

The CSV file must have the following fields in the same order as mentioned here.
1. Tenant: The name of the tenant to which the IP phone belongs. This is a not a mandatory field. If this field is kept empty, NNM iSPI for IP Telephony selects the default tenant.
2. Cluster: The name of the cluster to which the IP phone is associated.
3. Device Pool: The name of the device pool to which the IP phone is associated. This is not a mandatory field.
4. IP Phone: You can use one of the following options to specify the details of IP phones:
  - Using the actual extension numbers of IP phones. For example, if you want to update the site code, mail code, and location of the IP phone for the extension number 69750, specify 69750 in this field.
  - Using the hyphen (-) to specify a range of IP phones. For example, if you want to update the IP phones with the extension numbers from 12300 to 52895, you can specify 12300-52895 in this field.
  - Using the wildcard character percent (%) to specify a set of IP phones. The wildcard character percent (%) can match one or more digits. For example, if you want to update all the IP phones whose extensions numbers start with 8, you can specify as 8% in this field. If you want to update all the IP phones whose extensions numbers end with 8, you can specify %8 in this field. If you want to update all the IP phones whose extensions numbers start with 5 and end with 8, you can specify 5%8 in this field.
  - Using the wildcard character question mark (?) to specify a set of IP phones. The wildcard character question mark (?) can match any single digit between 0 and 9. For example, if you want to update the IP phones with the extension numbers from 4830 to 4839, you can specify 483? in this field.
    
    IP Phone Range is not a mandatory field. If this field is kept empty, the changes will be applied to all IP phones in the device pool or cluster.
5. Site Code: The new site code to be configured for the IP phones. You can use the keyword UNSET (case-sensitive) in this field to clear the current site codes and reset them to factory defaults, which are null.
6. Mail Code: The new mail code to be configured for the IP phones. You can use the keyword UNSET (case-sensitive) in this field to clear the current mail codes and reset them to factory defaults, which are null.
7. Location: The new location to be configured for the IP phones. You can use the keyword UNSET (case-sensitive) in this field to clear the current locations and reset them to factory defaults, which are null.
Log on to NNMi management server.
Run the following command:
- On Windows
  
  %NnmInstallDir%\bin\nmsiptconfigimport.ovpl -type phonecustominfo -vendor cisco -u<user> -p<password> -f<csv_file>
- On Linux
  
  /opt/OV/bin/nmsiptconfigimport.ovpl -type phonecustominfo -vendor cisco -u<user> -p<password> -f<csv_file>
  
  In this instance, <user> is the NNMi user, <password> is the password of this user, and <csv_file> is the complete path name of the CSV file that contains the new site codes, mail codes, and locations of the IP phones.

Send Help Center feedback