Table Of Contents

Getting Started with DFM

Working with DFM Windows

Using Help

Understanding the Dates and Times Displayed

Using Tabular Displays

Using Window Tools

Paging and Sorting Tabular Displays

Exporting Data from Tabular Displays

Printing Tabular Displays

Using the Toggle Button     

Selecting Objects and Groups

Understanding Your User Role

Responding to Security Alerts

Responding to Messages About Device Limits

Getting Started with DFM

---

These topics help you to work with and understand the Device Fault Manager (DFM) user interface:

•Working with DFM Windows

•Using Tabular Displays

•Using Window Tools

•Selecting Objects and Groups

•Understanding Your User Role

•Responding to Security Alerts

•Responding to Messages About Device Limits

Working with DFM Windows

This topic focuses on questions you may have when you first start to work with the DFM user interface:

What is the purpose of the DFM Home Page?

The DFM home page opens when you click Device Fault Manager > Home from the LMS Portal. The DFM home page is an easy way to access frequently used operations.

The following links are available.

Device Management	Notification Services	Faults	Configuration
Add Device Device Rediscovery Device Summary Device Import Device Details Discovery Status Rediscovery Schedule	Notification Services	Alerts Fault History Fault History Group/Device Search Fault History Alert/Event ID Search	Polling and Thresholds DFM Group Administration Trap Forwarding Data Purge

The tabs on the DFM home page are the portals for all DFM-related tasks:

•Starting an Alerts and Activities display

•Running Fault History reports

•Managing devices in the DFM inventory

•Configuring notifications

•Performing system configuration on DFM

What is the purpose of the CiscoWorks LMS Portal?

The CiscoWorks LMS Portal replaces the CiscoWorks home page, and provides quick access to status information and CiscoWorks functions. It is the default window that opens when you first log on to the CiscoWorks server.

This portal provides easy access to network and device information related to configuration, reporting, performance, and fault management. You can customize the portal depending on your role. For information on the portal, see User Guides for LMS Portal.

Table 2-1 describes the DFM Portlets in CiscoWorks LMS Portal.

Table 2-1 DFM Portlets in CiscoWorks LMS Portal 

Portlet	Description
Device Fault Manager	Helps you to launch Device Fault Manager application.
DFM Workflows Demos	List the available workflows demos. These demos help you to understand the workflows.
High Severity Alerts	Provides details such as alert ID, device type, alert duration, last changes that occurred in the alert, and the device names of high severity alerts.
DFM Events Summary	Displays information about the events that were encountered on the devices. This information is based on the severity such as critical or informational.
DFM Device Status	You can view the status and the number of devices in the DFM inventory.

The data available in the portlet gets refreshed according to the CiscoWorks LMS Portal application configuration.

Why are multiple windows open?

For ease of use, DFM opens separate windows for each application, and sometimes for functions within applications. 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 DFM 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 Device Fault Manager 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"?

DFM displays often include links to more detailed information. Right-clicking a link and selecting Open in New Window is not supported. This is expected behavior.

When I press the Enter key, why doesn't DFM complete the current task?

In DFM you cannot press the Enter key instead of clicking buttons, such as OK, Finish, or Next, on the application page.

Where is the Help button?

You can access help by clicking the Help link at the top right of any home page—the CiscoWorks home page, the DFM home page, or any other application's home page. See Using Help.

Using Help

To start DFM help:

---

Step 1 Launch any DFM display from the LMS portal. See What is the purpose of the DFM Home Page?.

Step 2 Click the Help link near the top right of the page (the Alerts and Activities display provides a Help button).

If you have selected an option in any home page, 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.

You can access CiscoWorks help by clicking Main at the top right of the Help page.

---

Understanding the Dates and Times Displayed

Dates and times displayed by DFM reflect the date, time, and time zone set on the server where DFM is installed. If the client system you use to run DFM is located in a time zone other than the time zone set on the server, you will notice the difference. For example:

•The date and time displayed with a prefix "as of" 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 DFM. However, you can obtain information about the time zone acronyms and offsets used by DFM in Release Notes for CiscoWorks Common Services 3.2.

To see the release notes, log into Cisco.com and go to the Common Services documentation at http://www.cisco.com/en/US/products/sw/cscowork/ps3996/tsd_products_support_series_home.html.

Using Tabular Displays

DFM presents information in tabular displays when the amount of data to be displayed or manipulated could be large. Tabular displays helps to handle 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 go to any screen number in the range by entering a screen number.

•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. This depends on the tabular display that you are using. See the icon in Using Window Tools.

•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 Using Window Tools.

Using Window Tools

The top-right corner of the application screens contain buttons for the available window tools.

All buttons are described in Table 2-2

Table 2-2 Window Tools in DFM

Icon	Meaning	Described in...
	Exports the current tabular display to a PDF file.	Exporting Data from Tabular Displays
	Opens the Filter page, for refining the tabular display in the Alerts and Activities display.	Filtering Alerts and Activities
	Opens a printer-friendly version for printing.	Printing Tabular Displays
	Opens a DFM Tools window with link to Fault History	Generating a 24-Hour Report on All Alerts in the Current View
	Opens the DFM help window.	Using Help
	Switches between the Full Screen view and the Normal view of the application page.	Using the Toggle Button

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.

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.

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-2.

The Export To dialog box appears.

Step 2 Select either of the following in this dialog box and click OK:

•CSV

•PDF

---

Note Some tabular displays may only support CSV exports.

---

Step 3 Save the export file in either 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

To print a tabular display

---

Step 1 Click the print-friendly icon located on the top-right side of the tabular display. See the icon in Table 2-2.

A new browser window opens, displaying the data in print-friendly format.

Step 2 Print the tabular display from the new browser window.

---

Using the Toggle Button     

This button helps you to switch between the Full Screen view and the Normal view of the application page. See the icon in Table 2-2.

•Full Screen view: Displays only the application configuration area.

•Normal view: Displays the Table of Contents, Application tabs along with the configuration area.

By default, the Normal view is displayed.

Selecting Objects and Groups

As you use DFM, 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:

•By Discovery status—For example, known and questioned devices. Device states are described in Understanding the Device Summary and Device States.

•By Device type—For example, Routers or Switches. These groups are controlled by Common Services; see the User Guide for CiscoWorks Common Services 3.1 for more information.

•By Group Administration—For example, Customizable Access Groups (under User Defined Groups). Managing Groups, explains how to work with these groups.

The following table describes the categories you may see in the device selector windows.

Group	Description
Discovery Status Groups
All Known Devices	Container for all devices that were successfully imported and are being managed by DFM.
All Learning Devices	Container for all devices DFM is in the process of discovering.
All Pending Devices	Container for all devices that are in the process of being deleted from DFM.
All Questioned Devices	Container for all devices that DFM cannot manage.
Device Type Groups
All Devices	Container for all devices that were successfully imported and are being managed by DFM.
Device Type Groups	Same as Common Services System Defined Groups. As the name implies, devices are grouped together by their type.
Group Administration Groups
CS@MARVER_DAILY	Groups that are controlled by Common Services.
System Defined Groups	Groups that Common Services predefines and controls.
User Defined Groups	Groups provided by Common Services to help you organize devices into groups that you define, based on characteristics you choose; for example, device location. To control them select Common Services > Groups > Group Admin.
DFM@MARVER-DAILY	Groups that are controlled by DFM.
DFM System Defined Groups	Groups that are predefined and controlled by DFM.
Access Port Groups	Predefined access port groups used by DFM.
Interface Port Groups	Predefined interface port groups used by DFM.
Trunk Port Groups	Predefined trunk port groups used by DFM.
DFM User Defined Groups	Groups provided by DFM to help you organize ports, interfaces, and devices into groups that you define, based on characteristics you choose; for example, Backup interfaces in a certain device group. These groups are used by Polling and Thresholds and other DFM functions.
Customizable Access Port Groups	Groups you can customize to track access ports.
Customizable Groups	Groups you can customize to track devices.
Customizable Interface Groups	Groups you can customize to track interfaces.
Customizable Trunk Port Groups	Groups you can customize to track trunk ports.

With many devices in DFM, it can sometimes be difficult to locate the devices you need. To assist you in locating devices, DFM provides a search option in the device selector page when it is launched from certain locations.

---

Note For a detailed description of how to customize the device selector, see the User Guides for CiscoWorks Common Services.

---

The Device Selector Pane

The device selector pane lists all DFM devices in a group. The devices are listed in the appropriate groups based on group rules.

Enter the search criteria in the Search Input field. The search criteria can be:

•IP Address—Enter the Device IP Address.

•DNS Name—Enter search criteria to match the DNS name.

You can enter multiple criteria separated with a comma. You can also enter a wildcard character (*) or a question mark (?) to select multiple devices.

You have three options:

All

To use this option:

---

Step 1 Select the All tab to include all the devices.

Step 2 Click Search Results to display the list of devices.

From here you can select some or all of the devices to proceed.

Step 3 Click Selection to display the chosen devices and continue with the original task.

---

Simple search

To use this option:

---

Step 1 Enter text in the Search Input text box.

Step 2 Enter the wildcard (*) in the search input, for example 10.77.*.* or *.cisco1.com.

Step 3 Click the search arrow or press Enter.

Step 4 Click Search Results to display the list of devices.

From here you have the option to select some or all of the devices to proceed.

Step 5 Click Selection to display the chosen devices and continue with the original task.

---

Advanced search

To use this option:

---

Step 1 Click the Advanced search tool.

A dialog box that includes the Advanced search options opens.

Step 2 Choose the attributes you want to include and click Add Rule Expression.

The rule is displayed in the Rule Text pane.

Step 3 Add other attributes using the OR, AND, and EXCLUDE expressions. For more information about rules, see Understanding Rules.

A rule is created.

Step 4 Click Check Syntax to check the rule.

Step 5 Enter the search criteria and click Search.

The results are displayed.

Step 6 Click the Search Results tab.

From here you can select some or all of the devices to proceed.

---

---

Note You can create an accumulated list by combining results from different searches. After choosing and placing the devices in the Selection pane, continue your search and selection, then place these in the Selection pane.

---

Understanding Your User Role

When you log into DFM, you enter the username and password assigned to you by a system administrator. Your username is associated with either a CiscoWorks role or a Cisco Secure Access Control Server (ACS) role.

By default, CiscoWorks and ACS roles are the same, but an ACS administrator can modify the ACS roles. User roles control the functions that you are allowed to see and use from the DFM home page.

If you cannot locate a function in the DFM home page, it indicates that this function is not permitted for you user role. For more information, do the following:

•View the CiscoWorks Permission Report to determine which tasks are permitted for each user role. From the Common Services home page, select Server > Reports > Permission Report and click Generate Report.

•View the ACS report by logging onto the ACS server and select Shared Profile Components. See to the ACS online help for more information.

For more information, see:

•Configuring Users (ACS and Non-ACS)

•Using DFM in ACS Mode

Responding to Security Alerts

The first time you select nearly any DFM function, you will see a Security Alert window displayed. You should install the self-signed security certificate. You should do this once, on each of the client system that you use to access DFM.

---

Note If you see a Security Alert Window with a message that the certificate has expired, you should contact a user with System Administrator privileges to create a self-signed security certificate, and then install it.

---

If you do not install the self-signed security certificate, you may not be able to access some DFM application pages.

To install the self-signed security certificate

---

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.

---

Responding to Messages About Device Limits

If you exceed your server's device limit, DFM will continue to work, but it will not allow you to import any more devices. What happens next depends on your device import setting:

•Manual synchronization with DCR—When you use the Device Import page to move devices from the DCR into DFM, DFM will display a warning that you cannot import any more devices (see Understanding the Device and Credentials Repository).

•Customized, filtered import or full import from the DCR—You will notice that devices are not appearing on DFM pages. You can check the license log for more information (see Viewing and Maintaining Log Files).

For information about device-based licensing, see Installation and Getting Started Guide for LAN Management Solution 3.2.