Table Of Contents
Getting Started with ITM
Working with ITM Windows
Using Help
Understanding the Dates and Times Displayed
Using Tabular Displays
Paging and Sorting Tabular Displays
Viewing Data from Tabular Displays with Over 2000 Records
Exporting Data from Tabular Displays
Printing Tabular Displays
Selecting Objects and Groups
Understanding Your User Role
Responding to Security Alerts
Getting Started with ITM
These topics help you to work with and understand the IP Telephony Monitor (ITM) user interface:
•
Working with ITM Windows
•
Using Tabular Displays
•
Selecting Objects and Groups
•
Understanding Your User Role
•
Responding to Security Alerts
Working with ITM Windows
This topic focuses on questions you may have when you first start to work with the ITM user interface:
•
What is the CiscoWorks window?
•
Why are multiple windows open?
•
Why do I see the error "The page cannot be displayed"?
•
When I press the Enter key, why doesn't ITM complete the current task?
•
Where is the help button?
What is the CiscoWorks window?
The browser from which you start ITM takes CiscoWorks as its title. After you log in to ITM, the CiscoWorks desktop is displayed. The CiscoWorks desktop is where you start using ITM functions and where you stop using ITM by logging out.
In the left pane, the CiscoWorks desktop contains Logout and Help buttons as well as a navigation tree. The right pane contains any application pages that are displayed after you select items from the navigation tree.
Note
ITM sometimes displays information in the right pane of the CiscoWorks desktop. However, for functions that require a more expansive display area, ITM opens new browser windows.
Why are multiple windows open?
For ease of use, ITM opens separate windows for many displays. Opening multiple browser windows allows you to:
•
Refer to information from one display to complete a task in another window
•
Rapidly compare information on different displays.
When ITM opens a new browser window, it does not close previously opened windows. You can close browser windows when you are done with them.
Note
If you close the CiscoWorks window while displaying Alerts and Activities in the IP Telephony Monitor browser windows, links in those windows will continue to function. In contrast, if you log out of CiscoWorks, links from those windows will return errors and you will need to log in to CiscoWorks again.
Why do I see the error "The page cannot be displayed"?
ITM displays often include links to more detailed information. Right-clicking a link and selecting Open in New Window is not supported. It is expected behavior for this error to appear.
When I press the Enter key, why doesn't ITM complete the current task?
ITM does not accept pressing the Enter key as a substitute for clicking buttons, such as OK, Finish, or Next, on the application page.
Where is the help button?
To access online help when you are looking at an ITM window that does not include a help button, select the CiscoWorks window and click the Help button located near the top of the left pane. See the "What is the CiscoWorks window?" section.
Using Help
Most ITM browser windows do not include a help button. To start help:
1.
Select the CiscoWorks browser window. See the "What is the CiscoWorks window?" section.
2.
Click the Help button near the top of the left pane.
Note
If you have selected an option in the navigation tree, the context-sensitive help for that option is displayed.
Help is displayed in a separate browser window that remains open until you close it. Online help includes an index and search capability.
Understanding the Dates and Times Displayed
Dates and times displayed by ITM reflect the date, time, and time zone set on the server where ITM is installed. If the client system you use to run ITM is located in a time zone other than the time zone set on the server, you will notice the difference; for example:
•
Status "as of" the current date and time will not display your local time and time zone and may not match your local date.
•
Dates and times shown for previous events are recorded (and displayed) with the server time stamp, which is offset from your local time.
There are no settings that you can change on the client to affect the time zone displayed by ITM. However, you can obtain information about the time zone acronyms and offsets used by ITM in Release Notes for IP Telephony Monitor 2.0 on Windows 2000. To see the release notes, log in to Cisco.com and select Products & Services > Network Management CiscoWorks > CiscoWorks IP Telephony Monitor > Technical Documentation > Release Notes.
Using Tabular Displays
ITM presents information in tabular displays when the amount of data to be displayed or manipulated could be quite large. Tabular displays ease the task of handling information by providing the following features:
•
Sorting—You can sort a tabular display in the order you prefer by clicking any clickable column heading.
•
Direct page access—You can browse a tabular display screen by screen or jump to any screen number in the range by entering a screen number.
Note
A tabular display can show up to 2,000 records. If more than 2,000 records exist and you need to access the additional records, you can export all records using the data export icon.
•
Data export—You can export data from a tabular display to a comma separated values (CSV) file, a Portable Document Format (PDF) file, or both, depending upon the tabular display that you are using. See the icon in Table 2-1.
•
Printer friendly—You can format the tabular display for a printer and print the result from the browser. Like the tabular display, the print-friendly browser display includes a maximum of 2,000 records. See the icon in Table 2-1.
Table 2-1 Tabular Displays—Export and Print-Friendly Icons
Icon
|
Action
|
|
Exports all data to either a CSV file or a PDF file.
|
|
Reformats the displayed records into print-friendly format, and displays them in a new browser window.
|
Paging and Sorting Tabular Displays
The sort order for any tabular display is indicated by the presence of a triangle in the column heading. A triangle pointing down indicates records in descending order, which is the default, while a triangle pointing up indicates records in ascending order.
Step 1
To sort a tabular display, click any blue column heading label.
The first time you click a column heading on a previously unsorted column, data in that column is sorted in descending order. If you click the column heading again, the records will be sorted in the reverse order.
Note
When you sort a tabular display, if there are more than 2,000 records available, all records are sorted, not just those that are displayed. The first 2,000 records are displayed after sorting.
Viewing Data from Tabular Displays with Over 2000 Records
If more than 2,000 records exist, they cannot all be shown in a tabular display. A message will be displayed to notify you when this is the case. If you want to see data for all of the records, you must export the data to a CSV or PDF file. See the "Exporting Data from Tabular Displays" section.
You may be able to change which of the more than 2,000 records are displayed by sorting the tabular display. See the "Paging and Sorting Tabular Displays" section.
Exporting Data from Tabular Displays
All tabular displays can be exported as comma separated values (CSV) files. Some tabular displays can also be exported as PDF files.
Note
To open a PDF file, you must have Adobe Acrobat Reader 4.0 or higher installed on your client system. However, you can save a file as a PDF file even if you do not have Acrobat Reader on your system.
Step 1
Click the data export icon located on the top-right side of the tabular display. See the icon in Table 2-1.
Step 2
If the dialog box Export to appears, select one of the following and click OK:
•
CSV
•
PDF
Step 3
Save the export file in one of the following ways:
•
If you selected PDF and have Adobe Acrobat Reader installed on your client system, the PDF file opens. To save the PDF file, select File > Save as from the browser and follow the online instructions to save the file.
•
If you selected PDF and do not have Adobe Acrobat Reader installed, or if you selected CSV, follow the online instructions to save the file.
Printing Tabular Displays
Step 1
Click the print-friendly icon located on the top-right side of the tabular display. See the icon in Table 2-1.
A new browser window opens, displaying the data in print-friendly format.
Step 2
Print the tabular display from the new browser window.
Selecting Objects and Groups
As you use ITM, you will often need to select something—a device or a device group, for example—before you can view information or complete a task. Groups and devices displayed in a selector differ depending upon the application.
This topic shows a few examples of selectors to familiarize you with them. Use the application-specific topics to determine what to select to accomplish your objective.
Figure 2-1 shows a device group and device selector as it might first appear on the SNMP Trap Notification and E-Mail Notification pages.
Figure 2-1 Device Groups and Device Selector as Displayed Initially on Notification Services Pages
1
|
P0—A container for all groups. Expanded on initial display.
|
3
|
User Defined Groups—A container for user-defined groups, including customizable groups. Collapsed on initial display.
|
2
|
System Defined Groups—A container for predefined groups. Collapsed on initial display.
|
|
|
Table 2-2 further describes the device groups shown in Figure 2-1.
Table 2-2 Device Group Descriptions
Group
|
Description
|
P0
|
Contains all groups and shares the same name as the partition alias. For ITM, the name is P0. For ITM Multi-View, the partition name is set by the Partition Administrator. For more information, see the "What Is a Partition?" section.
|
System Defined Groups
|
Contains predefined device groups.
|
User Defined Groups
|
Displayed only when a user has already created user-defined groups or added devices to customizable groups. You can organize devices into groups that you define, based on characteristics you choose; for example, device location. For more information, see the "Understanding ITM Groups" section and the "What Are Customizable Groups?" section.
|
Figure 2-2 also shows a device group and device selector as it might appear on the SNMP Trap Notification and E-Mail Notification pages after a user has expanded the following:
•
The System Defined Groups folder—Displaying system-defined device groups.
•
The All Cisco ICS 77XX group folder—Displaying the devices that are members of the group.
Figure 2-2 Device Group and Device Selector with System Defined Groups Expanded
1
|
All 78XX Media Servers—A system-defined group. Collapsed on initial display. If you select the check box, you select the group and all devices in it.
|
2
|
A device—You can select the device from the All Cisco ICS 77XX system-defined group. Expanded in this example.
|
Figure 2-3 shows a device group selector as you might see it on the Polling Parameters page. A device group selector enables you to select device groups only, in contrast to the device group and device selector shown in Figure 2-2.
Figure 2-3 Device Group Selector with User Defined Groups and Customizable Groups Expanded
1
|
P0—Contains other groups. See Table 2-2 for more information.
|
3
|
User Defined Groups—Groups that you can create (or edit, only for customizable groups). Expanded in this example.
|
2
|
System Defined Groups—Groups that ITM predefines. Collapsed on initial display.
|
4
|
Customizable Groups—Groups to which you can add devices, and that you can use to customize polling parameters and thresholds. Expanded in this example.
|
Using a device group selector, you select device groups by highlighting the groups that you want.
Figure 2-4 shows a device group selector as you might see it on the Polling Parameters page after a user expands the System Defined Groups folder.
Figure 2-4 Device Group Selector with System Defined Groups Expanded
1
|
All Cisco Gateways—A system-defined group that contains other groups. Collapsed on initial display.
Note Although All Cisco Gateways has members, the members are also device groups.
|
2
|
All Cisco IP Telephony Applications—A system-defined group that contains other groups. Expanded in this example. The member groups of All Cisco IP Telephony Applications are two Cisco IP telephony applications (Cisco CallManager and Cisco Unity) that exist on hosts that ITM polls.
|
Understanding Your User Role
When you log in to ITM, you enter the username and password assigned to you by a System Administrator. Your username is associated with CiscoWorks user roles. User roles control the folders and applications that you are allowed to see and use from the CiscoWorks navigation tree.
ITM documentation includes tasks for ITM and ITM Multi-View user roles. If you cannot locate a folder or application in the CiscoWorks navigation tree, either of the following could be the cause:
•
The task is necessary only for ITM Multi-View—When this is the case, ITM documentation notes it.
•
The task is not permitted for the user role—View the CiscoWorks Server Permissions Report to determine which tasks are permitted for each user role.
Step 1
Select Server Configuration > Setup > Security > Permissions Report. The Permissions Report window opens.
Note
For ITM Multi-View users only: The Partition Administrator user role does not appear on the Permissions Report. As a result, tasks that can be performed only by a Partition Administrator are listed showing that no user role has permission to perform them. (See the "Tasks for Partition Administrators" section for a list of tasks that only a Partition Administrator can perform.)
Responding to Security Alerts
The first time you select nearly any option from the IP Telephony Monitor drawer in the CiscoWorks navigation tree, you will see a Security Alert window displayed. If you are using Internet Explorer 6.0.26, simply click Yes.
If you are using Internet Explorer 6.0.28, you should install the self-signed security certificate. You should do this once, on each client system you use to access ITM.
Note
If you see a Security Alert Window with a message that the certificate has expired, you should contact a user with System Administrator privilege to create a self-signed security certificate. Then install it.
Note
If you do not install the self-signed security certificate, you may not be able to access some ITM application pages.
Step 1
Click the View Certificates button on the Security Alert window. The Certificate window is displayed.
Step 2
Install the certificate as follows:
a.
Click the Install Certificate button. The Certificate Import Wizard window is displayed.
b.
Follow the instructions provided by the Certificate Import wizard.