User Guide for IP Telephony Monitor
Configuring and Administering ITM Multi-View

Table Of Contents

Configuring and Administering ITM Multi-View

Creating a Partition Administrator

Tasks for Partition Administrators

Tasks that Only a Partition Administrator Can Perform

Tasks that a Partition Administrator Can Perform in Partition 0

Using Multi-View Manager

Managing Partitions

Assigning Devices to Partitions

Checking Available Devices

Assigning Cluster-Related Devices to Partitions

Synchronizing ITM Multi-View Devices with RME

Assigning Users to Partitions

Creating a Partition

Viewing Partition Membership Details

Editing a Partition

Deleting a Partition

Administering Partitions

Saving a Partition

Restoring a Partition


Configuring and Administering ITM Multi-View


These topics provide an overview of configuration and administration tasks for IP Telephony Multi-View (ITM Multi-View):

Creating a Partition Administrator

Tasks for Partition Administrators

Managing Partitions

Administering Partitions


Note If you are initially configuring ITM Multi-View, you must configure a user as a Partition Administrator. For more information about performing an initial configuration, see "Comparison of ITM and ITM Multi-View" in Table 1-1.


Creating a Partition Administrator

Before You Begin

You must be logged in to CiscoWorks as the System Administrator to create a Partition Administrator for ITM Multi-View.


Step 1 Select Server > Configuration > Setup > Security > Add Users.

Step 2 Select Partition Administrator as the CiscoWorks user role. The following user roles are also automatically selected:

Approver

Network Operator

Network Administrator

System Administrator


Note Do not deselect the additional roles; the Partition Administrator must have all of these roles.


Step 3 Click OK.



Note A user in the Partition Administrator role, by default, has access to all partitions.


For additional information, see the following topics:

Understanding Your User Role

Assigning Users to Partitions

Tasks for Partition Administrators

A Partition Administrator is the only user who can perform certain tasks that affect all partitions, and the only user who can perform device management tasks in Partition 0. For more information, see the following topics:

Tasks that Only a Partition Administrator Can Perform

Tasks that a Partition Administrator Can Perform in Partition 0

Tasks that Only a Partition Administrator Can Perform

The following configuration tasks are global in their effect and only a Partition Administrator can perform them (from any partition):

Configuring the Daily Purging Schedule

Configuring Rediscovery Schedules

Scheduling Confidence Tests

Scheduling Major Phone Discovery


Note For scheduling considerations, see the "Performing Scheduling Tasks" section.


Updating the SNMP Trap Receiving Port

Configuring SNMP Trap Forwarding

Configuring a Default SMTP Server

Using Multi-View Manager

Tasks that a Partition Administrator Can Perform in Partition 0

A Partition Administrator is the only user with direct access to Partition 0, the default partition. Table 13-1 lists the tasks a Partition Administrator can perform in Partition 0.

Table 13-1 Partition Administrator Tasks Allowed in Partition 0

Task
Notes
See Also...
Perform tasks that require Partition Administrator privilege
 

Tasks that Only a Partition Administrator Can Perform

Add, import, or export devices

After you import devices, ITM Multi-View discovers the devices. However, ITM Multi-View does not start polling devices until you assign them to partitions. You can assign the devices to partitions while discovery ensues.

Understanding the Device Summary

Managing Partitions

View discovery status

After you import devices, if you wait for discovery to complete before assigning devices to partitions, you can check device discovery status while the device is still in the default partition.

Note Discovery status for all devices is not available immediately when you import devices. Device discovery takes some time to complete.

Viewing Discovery Status

View device detail

If you wait for discovery to complete before assigning devices to partitions, you can check device details while the device is still in the default partition.

Note Details for all devices are not available immediately when you import devices. Device details become available as device discovery completes.

Viewing Device Details

Change device credentials, initiate rediscovery, and delete devices
 

Editing Device Configuration


For additional information, see the following topics:

How Are ITM and ITM Multi-View Different?

Understanding Your User Role

Overview of ITM Multi-View

Using Multi-View Manager

ITM Multi-View provides a set number of partitions on a single ITM Multi-View platform. The Multi-View Manager is the tool that allows a Partition Administrator to:

Name the partitions.

Assign devices. Each device can be assigned to only one partition.

Grant user access to a partition. A user can be assigned to more than one partition. No user logged in with any CiscoWorks role can gain access to a partition unless the Partition Administrator has assigned the user to a partition.

Perform data backup.

ITM Multi-View provides the following partitions:

A default partition to which all devices are assigned initially. ITM Multi-View provides one such partition, Partition 0. After devices are imported or added to ITM Multi-View, they remain in the default partition until you assign them to a defined partition. While devices are in the default partition, they are not polled and alerts are not generated for them. Devices return to the default partition if you choose to remove them from a defined partition.

Partitions that can become defined partitions. ITM Multi-View provides a set number of such partitions, numbered 1 through n. You create a defined partition by specifying an alias for a partition and assigning users and devices to it.

Managing Partitions

To access the Multi-View Manager from the CiscoWorks desktop, select IP Telephony Monitor > Configuration > Multi-View Manager. From the Multi-View Manager page, you can initiate the following tasks:

Creating a Partition

Editing a Partition

Deleting a Partition

Viewing Partition Membership Details

The Multi-View Manager displays the following details about partitions:

Partition—A number from 0 to 10. Partition 0 is the default partition.

Alias—The name assigned when the partition was created or edited.

Created By—The CiscoWorks username of the Partition Administrator who created the partition.

Date Created—The date on which the Partition Administrator created the partition.

Last Modified By—The CiscoWorks username of the Partition Administrator who most recently edited the partition.

Date Last Modified—The date on which the Partition Administrator most recently edited the partition.

Assigning Devices to Partitions

You can assign devices to partitions from the Multi-View Manager when you perform either of the following tasks:

Creating a Partition

Editing a Partition

Before you assign devices to partitions, you may need to:

Verify that all of the devices that you want have been imported to the default partition. See the "Checking Available Devices" section.

Import devices. See the "Tasks that a Partition Administrator Can Perform in Partition 0" section.

You should check the "Assigning Cluster-Related Devices to Partitions" section before you assign the following types of devices to partitions:

Devices that run Cisco CallManager (media servers or ICSs)

Devices that are registered to a Cisco CallManager (voice gateways and voice mail gateways)

After you assign devices to partitions, ITM Multi-View starts to poll the devices and displays alerts that occur as a result of events on the devices.

Checking Available Devices

Devices available to be assigned to a defined partition are located in the default partition, Partition 0. Devices in Partition 0 are of two types:

Devices that have been recently imported or added to ITM Multi-View, but are not yet assigned to a partition.

Devices that were previously assigned to a partition, but have since been removed and returned to the default partition.


Step 1 From the Multi-View Manager page, select Partition 0.

Step 2 Click the Details button. The Partition Properties page appears.

Step 3 Click the Membership Details button. The list of devices is displayed.



Note To delete a device from the default partition, see the "Editing Device Configuration" section.


For additional information, see the following topics:

Importing Devices to ITM Multi-View

Assigning Devices to Partitions

Editing a Partition

Assigning Cluster-Related Devices to Partitions

A Cisco CallManager cluster includes one or more Cisco CallManagers. The following types of devices can run Cisco CallManager:

Integrated Communication Systems (ICSs)

Media servers

Other types of devices can be registered to a Cisco CallManager; for example:

Voice gateways

Voice mail gateways

You must assign all devices that are related to the same cluster to the same partition, as follows:

Assign all ICSs and media servers that run Cisco CallManager and belong to the same Cisco CallManager cluster to the same partition.

Assign all devices that have registrations to a Cisco CallManager cluster to the same partition as the media servers or ICSs that make up the cluster.

The first time you assign a device running Cisco CallManager to a partition, ITM Multi-View creates the cluster subgroup under the Cisco CallManager or Cluster system-defined group. ITM Multi-View also creates a number of subgroups under the cluster subgroup, each representing one device group that has a logical connection with the cluster.

Figure 13-1 shows an example of a cluster subgroup as displayed in the Group Selector pane on the Group Configuration and Administration page.

Figure 13-1 Cluster Subgroup

1

Cluster subgroup—Created when a device running Cisco CallManager is the first assigned to a partition from a particular cluster.

2

Device groups in the cluster—Created at the same time as the cluster subgroup. Devices become members of the appropriate device groups for the cluster when assigned to the same partition, whether running Cisco CallManager or registered to a Cisco CallManager.



Note Device group membership becomes important when, for example, you update polling parameters and thresholds or when you send notifications based on device group.


After you assign Cisco CallManager-related devices to partitions, you can verify that they have been successfully assigned.


Step 1 If you want to verify that a device did not remain in the default partition, Partition 0, you can do as follows:

a. Select Partition 0 from the Multi-View Manager page and click the Details button. The Partition Properties: Details page appears.

b. Click the Membership Details button. The Partition Membership: Membership Details page appears.

c. Verify that none of the devices you assigned to a partition appear in the Device Names column.

Step 2 If you want to verify that a device has been assigned to a partition and is a member of a cluster subgroup, you can do so as follows:

a. Use the Active Partition Selector to select the partition to which you assigned the device.

b. Select IP Telephony Monitor > Group Management. The Group Administration and Configuration page appears.

c. In the Group Selector pane:

Expand the System Defined Groups folder

Scroll down through the system-defined groups until you locate the Cisco CallManager or Cluster folder

Expand the Cisco CallManager or Cluster folder and expand the cluster subgroup folder, VE-<ClusterName>

Select the appropriate device group

d. Click Details. The Properties: Details page appears.

e. Click Membership Details. The Membership: Details page appears.

f. If you cannot find the device on the Membership Details page, continue to Step 3.

Step 3 Check the log file, <NMSROOT>/log/itemlogs/VHM/
CiscoCallManagerOrClusterGrouping.log.


Note NMSROOT is the directory where IP Telephony Monitor is installed on your system. If you selected the default directory during installation, it is C:\Program Files\CSCOpx.



Note If you cannot access the server where ITM Multi-View is installed, contact the local administrator for the server. The local administrator may be able to provide access to log files.


Look for the following type of message in the log file:

This VE CiscoCallManagerClusterName already belongs in another 
partition.

If you find this message, continue to Step 4.

Step 4 Assign the media server or ICS to the correct partition.


Synchronizing ITM Multi-View Devices with RME


Note RME Synchronization is available only if you have downloaded and installed Incremental Device Update (IDU) 2 or later from the ITM download site: http://www.cisco.com/pcgi-bin/tablebuild.pl/item-3des.


If RME synchronization is enabled, the synchronization process regularly does the following:

Adds to ITM any devices that have been added to RME.

Updates device credentials in ITM if they have been updated in RME.

New devices are added to the default partition, Partition 0. Therefore, if you are using RME Synchronization, you might need to check Partition 0 regularly for new devices.


Step 1 You can view the schedule for RME synchronization by selecting IP Telephony Monitor > Configuration > RME Synchronization.

Step 2 After RME synchronization completes, assign any new devices to partitions. See the "Assigning Devices to Partitions" section.

Step 3 After the devices are in the active partition, you can verify their status by selecting IP Telephony Monitor > Device Management > View Device Details. (For more information on device details, see the "Understanding the Device Details Display" section.)


For additional information, see the following topic:

Synchronizing ITM Inventory with RME Inventory

Assigning Users to Partitions

When you assign users to partitions, you should assign at least one Network Administrator or Network Operator to each partition. For each partition, you need to decide which user roles are necessary. For example, you may decide to assign users in either of the following ways:

One Network Administrator to each partition, Partition numbers 1 through 10

One Network Administrator for Partition 1, but a Network Operator and a Help Desk user for Partition 5.


Note You cannot assign a Partition Administrator to a partition or remove a Partition Administrator from a partition. Only Partition Administrators have access to all partitions.


You should know which CiscoWorks user roles are assigned to your users, and the tasks that the user roles permit them to do. For instructions on assigning users to partitions, see the "Editing a Partition" section.

For additional information, see the following topic:

Configuring Users

Creating a Partition


Step 1 From the Multi-View Manager page, select a partition number for which no alias is displayed.

Step 2 Click the Create button.


Note You can create a partition even when you do not yet have devices available and are not ready to assign users. The only information you must supply to create a partition is the alias.


Step 3 Enter a name for the partition (and, optionally, a description), and assign users to it:

a. Enter a name for the partition in the Partition Alias field using only the following characters:

Alphabetic (a-z, A-Z)

Hyphen

Underscore

This name will be displayed on the Multi-View Manager page and in the Active Partition Selector.

b. (Optional) Enter a description for the partition in the Description field.

c. If you want to postpone assigning users to this partition, skip to Step 4.


Note Users with roles other than Partition Administrator cannot access a partition until you assign them to it.


Otherwise, select one or more available users and click the > Add >> button to move them to Selected Users.


Note Partition Administrators do not appear in the lists of available users or selected users. Partition Administrators have access to all partitions and cannot be added to or removed from them.


For additional information, see the "Assigning Users to Partitions" section.

Step 4 Do the following:

a. Click the Next button to continue creating the partition.

b. If you want to postpone selecting devices for the partition, skip to Step 5. Otherwise, select one or more available devices and click the > Add >> button to move them to Devices in Partition. For more information, see the "Assigning Devices to Partitions" section.


Note A device can be assigned to only one partition.


Step 5 Click the Finish button. The Multi-View Manager page will be displayed, showing the new information for the partition.


Note Adding devices to a partition or removing devices from a partition may cause CPU usage to increase and remain high for a few minutes after you complete this step.



Tip

Although the partition is now stored in the database, you should consider also saving the partition to a file. See the "Saving a Partition" section.

For additional information, see the following topics:

Viewing Partition Membership Details

Saving a Partition

Viewing Partition Membership Details

Viewing Partition Membership Details

From the Membership Details page you can:

Page through the list of devices.

Return to the Partitions Properties page to view the list of users who can access the partition. To do so, click the Details button.

Return to the Multi-View Manager page (by clicking the Cancel button).


Step 1 From the Multi-View Manager page, select a partition.

Step 2 Click the Details button. The Partition Properties page appears.

Step 3 If you are interested only in devices assigned to the partition, or their discovery status, skip to Step 4. Otherwise, view the Partition Properties page, which displays the following information:

Partition ID—Number of the partition. Partition numbers are provided by ITM Multi-View and cannot be changed.

Partition Alias—Name of the partition; will be displayed in the Active Partition Selector.

Description—Optional entry; therefore, may be blank.

User Access—Comma separated list of CiscoWorks usernames that have been assigned to the partition. If no users are assigned, there will be no list.

Created By—Name of the Partition Administrator who created the partition.

Last Modified By—Date on which the partition was lasted edited.

Step 4 Obtain information about the devices in the partition as follows:

To view the discovery status for the devices in the partition, click the Device Discovery Summary button. The summary shows the number of devices in each device state. See the "What Are Device States?" section for more information.

To view the list of devices assigned to the partition, click the Membership Details button. The Membership Details page displays a numbered list with the following information:

Device Name—Displays either the DNS name for the device, or its IP address.

IP Address—Displays the IP address for the device.

Device Status—Displays the device status. See the "What Are Device States?" section for more information.


Editing a Partition

When you edit a partition, you can change any of the following information:

Partition Alias—Change the name that is displayed in the Multi-View Manager and in the Active Partition Selector.

Selected Users—Add or remove users from the list of those who can access the partition.

Devices in Partition—Add or remove devices from those that are assigned to the partition.


Step 1 From the Multi-View Manager page, select a partition.


Note You cannot edit Partition 0.


Step 2 Click the Edit button.

Step 3 To add or remove devices only, skip to Step 4. Otherwise, make any of the following changes:

a. Update the name of the partition in the Partition Alias field. This name will be displayed on the Multi-View Manager page and in the Active Partition Selector.

b. (Optional) In the Description field, update or enter a description for the partition.

c. To assign users to this partition, select one or more users from Available Users and click the > Add >> button to move them to Selected Users. See the "Assigning Users to Partitions" section.


Note Partition Administrators do not appear in the lists of available users or selected users. Partition Administrators have access to all partitions and cannot be added to or removed from them.


d. To remove users from this partition, select one or more users from Selected Users and click the < Remove << button to move them to Available Users.

Step 4 Click the Next button to continue editing the partition.

Step 5 If you do not need to add or remove devices for this partition, skip to Step 6. Otherwise, update device assignments as follows:

To assign devices to the partition, select one or more devices from Available Devices and click the > Add >> button to move them to Devices in Partition. See the "Assigning Devices to Partitions" section.

To remove devices from the partition, select one or more devices from the Devices in Partition list and click the < Remove << button to move them to Available Devices.


Note A device can be assigned to only one partition.


Step 6 Click the Finish button. The Multi-View Manager page will be displayed, showing the information for the partition.


Note Adding devices to a partition may cause CPU usage to increase and remain high for a few minutes after you complete this step.




Tip Although the partition is now stored in the database, you should consider also saving the partition to a file.


For additional information, see the following topics:

Saving a Partition

Viewing Partition Membership Details

Deleting a Partition

When you delete a partition, you permanently remove:

All record of the partition, including the alias and the list of devices and users who were assigned to it.

The devices assigned to the partition.

Before You Begin

Save the partition. Doing so ensures that:

You keep a record of the partition, its creation date, and the devices assigned to it.

You can restore the partition, if desired.


Note Although a System Administrator should back up ITM Multi-View data regularly (see the "Backing Up and Restoring ITM Data" section), you cannot selectively restore partitions from such a backup.


For information on saving a partition, see the "Saving a Partition" section.

If you do not want to delete the devices assigned to the partition, move the devices back to the default partition, Partition 0. See the "Editing a Partition" section.


Step 1 From the Multi-View Manager page, select a partition.


Note You cannot delete Partition 0.


Step 2 Click the Delete button.

Step 3 If you have already saved the partition to a file, click OK to proceed. Otherwise, click Cancel to exit this procedure and save the partition.

Step 4 To confirm that you want to delete the partition, click OK.


For additional information, see the following topic:

Restoring a Partition

Administering Partitions

After you create or edit a partition, it is good practice to save the partition to a file. Doing so ensures that:

You keep a record of the partition as it existed immediately after you created or edited it. Saved information might include, for example:

Alias

Devices

Creator and creation date

Most recent modifier and modification date

You can restore the partition, if desired; for example, to:

Review the devices assigned to the partition at the time at which it was created or edited.

Move the partition to a different ITM Multi-View platform.

Move the partition from one partition number to another on the same ITM Multi-View platform.


Note Although a System Administrator should back up ITM Multi-View data regularly (see the "Backing Up and Restoring ITM Data" section), you cannot selectively restore partitions from such a backup.


For additional information, see the following topics:

Saving a Partition

Restoring a Partition

Saving a Partition

Saving a partition to a file saves the following information about the partition:

Alias

Devices

Creator and creation date

Most recent modifier and modification date


Step 1 From the Multi-View Manager page, select a partition.

Step 2 Click the Save button. The Partition X: Save page appears.

Step 3 Enter a filename and click OK. Files are saved in the file directory displayed on the Partition X: Save page.


Restoring a Partition


Step 1 From the Multi-View Manager page, click the Restore button. The Restore Partition page appears.

Step 2 Select a partition from the Partition Number list.


Note Partition numbers for available, undefined partitions appear on the list.


Step 3 Enter a filename in the File Name field.


Note The file must be located in the File Directory displayed on the Restore Partition page.


Step 4 Click OK.