User Guide for Campus Manager 4.0
User Tracking
Downloads: This chapterpdf (PDF - 487.0KB) The complete bookPDF (PDF - 5.15MB) | Feedback

Tracking Users

Table Of Contents

Tracking Users

Understanding User Tracking

Using User Tracking

Understanding Network and Campus Dependencies

Understanding User Tracking Reports

Using User Tracking Reports

Viewing Quick Reports

Viewing Report Jobs List

Viewing Job Details

Stopping Jobs

Deleting Jobs

Using Report Generator

Viewing Duplicates Report

Interpreting Duplicate Reports

Viewing End Hosts Reports

Interpreting End Host Reports

Viewing IP Phones Reports

Interpreting IP Phones Reports

Understanding Switch Port Usage Reports

Viewing Reports on Switch Port Usage

Interpreting Switch Port Usage Reports

Using Custom Reports

Viewing List of Custom Reports

Creating Custom Reports

Editing Custom Reports

Copying Custom Reports

Deleting Custom Reports

Using Custom Layouts

Viewing List of Custom Layouts

Creating Custom Layouts

Editing Custom Layouts

Copying Custom Layouts

Deleting Custom Layouts

Using Archived Reports

Viewing Archived Reports List

Viewing Reports

Deleting Archived Reports

User Tracking Command Line Interface

Troubleshooting User Tracking

User Tracking FAQs

Understanding UTLite

Installing UTLite Script on Active Directory

Installing UTLite Script on Windows

Installing UTLite Script on NDS

Uninstalling UTLite Scripts From Windows

Uninstalling UTLite Scripts From Active Directory

Uninstalling UTLite Scripts From NDS

User Tracking Utility

Understanding UTU 1.1

Definitions

Hardware and Software Requirements for UTU 1.1

Downloading UTU 1.1

Installing UTU 1.1

Accessing UTU 1.1

Configuring UTU 1.1

Searching Users or Hosts

Using Search Patterns

Uninstalling UTU 1.1

Upgrading to UTU 1.1

User Tracking Debugger Utility

Understanding Debugger Utility

Using Debugger Utility


Tracking Users


User Tracking application of Campus Manager allows you to track end stations. This chapter contains the following sections:

Understanding User Tracking

Using User Tracking

Using User Tracking Reports

User Tracking Command Line Interface

Troubleshooting User Tracking

User Tracking FAQsUnderstanding UTLite

User Tracking Utility

User Tracking Debugger Utility

Understanding User Tracking

User Tracking allows you to locate end-user hosts in the network. It collects and presents information gathered by the Asynchronous Network Interface (ANI) Server and held in the ANI database. User Tracking queries the ANI database based on your specifications and displays the resulting information in tabular format.

You can also use User Tracking to find certain kinds of duplicate connections that could indicate potential problems in your network.

Using User Tracking

You can use User Tracking to:

Display information about the relationships between the devices, users, and hosts in your network. For example, you might want to identify all users connected to a particular subnet, or all hosts on a particular device.

Display information about the IP phones registered with discovered Media Convergence Servers.

Use simple queries to limit the amount of information User Tracking displays.

Create and save simple and advanced queries.

Modify, add, and delete usernames and notes. Although you can configure the ANI Server to collect usernames during data collection, doing so adds to the ANI Server's processing time. The ability to add usernames and notes permits you to be selective in choosing the entries to be modified.

Customize User Tracking table layouts. For example, you can design a layout that displays only the MAC addresses of hosts on your network.

View User Tracking reports that identify duplicate IP addresses, duplicate MAC addresses, duplicate MAC and VLAN names, and ports with multiple MAC addresses.

Start workflow applications.

Launch Device Center, host center, phone center.

This section contains:

Understanding Network and Campus Dependencies

Understanding User Tracking Reports

Using Custom Reports

Using Custom Layouts

Using Archived Reports

Understanding Network and Campus Dependencies

For User Tracking to display user and host data, the Campus must collect this data. The Campus device discovery can collect data only for those hosts that are actively connected to a network and which is configured properly for device and logical discoveries. Therefore, before using User Tracking, you must:

1. Set up your network devices so that they can be discovered. This includes enabling Cisco Discovery Protocol (CDP) and Integrated Local Management Interface (ILMI), enabling SNMP, and configuring VLAN Trunk Protocol.

2. Set up the ANI Server so that it can successfully collect data for devices in the network. This includes providing SNMP community strings and selecting a seed device.

3. Run device discovery and ANI data collection.

Understanding User Tracking Reports

User Tracking automatically locates servers and end-user workstations, and Cisco voice over IP (VoIP) telephone handsets and their connections to Layer 2 Cisco switches. During this acquisition process it also tabulates specific connection information about the end station.

The Reports section provides various options to view, create and schedule various reports that User Tracking provides.

Using User Tracking Reports

The Reports section provides various options to view, create and schedule various reports that User Tracking provides. This section contains:

Viewing Quick Reports

Viewing Report Jobs List

Viewing Job Details

Stopping Jobs

Deleting Jobs

Using Report Generator

Viewing Duplicates Report

Viewing End Hosts Reports

Viewing IP Phones Reports

Viewing Reports on Switch Port Usage

Using Custom Reports

Using Custom Layouts

Using Archived Reports

Viewing Quick Reports

You can view end host or IP phone reports using the Quick Report dialog box in the Reports tab of the Campus User Tracking window.

To view the reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports.

The Quick Report dialog box appears.

Step 3 Enter the required information as given in Table 6-1.

Table 6-1 Viewing Quick Reports 

Field
Description
Usage Notes

Select a type

Select the type of report that you wish to view.

The two types of reports that are available are:

End Hosts

IP Phones

QueryExpression

Column

The name of the report column based on which you wish to specify the query expression.

To view a list of valid column names click the drop-down arrow.

Operator

The logical operator for the query expression.

To view a list of valid operators click the drop-down arrow.

Pattern

The pattern for the query expression.

Enter the pattern for the query expression.

To query on the Last Seen field enter the date in the format yyyy/mm/dd. You can also enter the date as a substring of this format.


Step 4 Click Submit.

The selected type of report is displayed in the standard layout. The data displayed depends on the query expression specified.


Viewing Report Jobs List

You can view a list of scheduled jobs and their current status using the Reports > Report Jobs option of Campus User Tracking window.

To view Report Jobs:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Jobs.

The Report Jobs dialog box appears.


Viewing Job Details

To view the details of a selected job:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Jobs.

The Report Jobs dialog box appears.

Step 3 Check the check box against the job, the details of which you want to view.

Step 4 Click View.


Stopping Jobs

To stop a scheduled job:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Jobs.

The Report Jobs dialog box appears.

Step 3 Check the check box against the job that you want to stop.

Step 4 Click Stop.


Deleting Jobs

To delete a job:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Jobs.

The Report Jobs dialog box appears.

Step 3 Check the check box against the job that you want to delete.

Step 4 Click Delete.


Using Report Generator

The Report Generator option lets you view system-defined reports and custom reports. You can also schedule to run these reports immediately or at a later date.

To use the report generator:


Step 1 Start Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Generator.

The Report Generator dialog box appears.

Step 3 Select the Application for which you want to view reports.

Step 4 Select the Report, pertaining to the selected application that you want to view.

Step 5 To schedule the report, select report type and date on which you want to generate the report.

Step 6 Enter Job Description and E-mail address, if any. Set system preferences for receiving mail.

Step 7 Click Submit.

This generates the report.


Viewing Duplicates Report

You can view the following reports using the Duplicates application in the Reports Generator dialog box:

Duplicate IP addresses

Duplicate MAC addresses

Duplicate MAC and VLANs

Ports with multiple MAC addresses.

To view reports on duplicates:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Generator.

The Report Generator dialog box appears.

Step 3 Select Duplicates from the Select Application list.

Step 4 Select the Report, pertaining to the selected application, that you want to view.

Step 5 Schedule the report by selecting the report type and the date on which you want the report to be generated.

Step 6 Enter Job Description and E-mail address, if any.

Step 7 Click Submit.

The report is generated.


Interpreting Duplicate Reports

Table 6-2 provides details of the columns in Duplicate Report—Standard Layout.

Table 6-3 provides details of the columns in Duplicate Report—All Columns Layout.

Table 6-2 Duplicate Report—Standard Layout Columns 

Field
Description

UserName

Discovered username or the username that you have entered. You can edit this field.

You can configure the Asynchronous Network Interface (ANI) Server to collect user names. See the ANI Server online help for further information.

MACAddress

Media Access Control (MAC) address of network interface card in end-user node.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx)

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

HostName

Name of host.

IPAddress

IP address of host.

Subnet

Subnet of IP address, which is displayed in the format String (xxx.xxx.xxx.xxx).

DeviceName

Name corresponding to IP address of device.

Port

Port in device to which a host is connected.

VLAN

VLAN name associated with port.

LastSeen

Date and time when User Tracking last found an entry for this user or host in a switch. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.

Notes

Notes on this entry, that you enter.


Table 6-3 Duplicate Report—All Columns Layout 

Field
Description

UserName

Discovered username or the username that you have entered. You can edit this field.

You can configure the Asynchronous Network Interface (ANI) Server to collect user names. See the ANI Server online help for further information.

MACAddress

Media Access Control (MAC) address of network interface card in end-user node.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx).

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

HostName

Name of host.

IPAddress

IP address of host.

Subnet

Subnet of IP address.

IPv6 Address

IPv6 address of the host, if any.

Prefix Length

Length of the IPv6 address prefix.

Prefix

IPv6 address prefix.

DeviceName

Name corresponding to IP address of device.

Device

IP address of device to which end user node is attached.

Port

Port name in device to which a host is connected.

Port Name

User assigned port name (port label).

Port State

Configured port mode.

Port Duplex

Operational duplex.

Port Speed

Operational speed.

VLAN

VLAN name associated with port.

VLAN ID

VLAN identifier associated with the MAC address or port.

VLAN Type

Ethernet, Token Ring, FDDI, unassigned, or unknown.

Parent VLAN

Parent VLAN of the host.

Secondary VLAN

Secondary VLAN of the host.

Ring

Ringnumber for Token Ring VLANs.

Bridge

BRF bridge number.

LastSeen

Date and time when User Tracking last found an entry for this user or host in a switch. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.

Notes

Notes on this entry, that you enter.


Viewing End Hosts Reports

You can view a report on all end host entries using the End Hosts option in the Reports Generator dialog box.

To view report on end hosts:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Generator.

The Report Generator dialog box appears.

Step 3 Select End Hosts from the Select Application list.

Step 4 Select the Report, from the Select Report list.

Step 5 Schedule the report by selecting the report type and the date on which you want the report to be generated.

Step 6 Enter Job Description and E-mail address, if any.

Step 7 Click Submit.

The report is generated.


Interpreting End Host Reports

Table 6-4 provides details of the columns in End Hosts Report—Standard Layout

Table 6-5 provides details of the columns in End Hosts Report—All Columns Layout

Table 6-4 End Hosts Report—Standard Layout Columns 

Field
Description

UserName

Discovered username or the username that you have entered. You can edit this field.

You can configure the Asynchronous Network Interface (ANI) Server to collect user names. See the ANI Server online help for further information.

MACAddress

Media Access Control (MAC) address of network interface card in end-user node.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx).

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

HostName

Name of host.

IPAddress

IP address of host.

Subnet

Subnet of IP address, which is displayed in the format String (xxx.xxx.xxx.xxx).

DeviceName

Name corresponding to IP address of device.

Port

Port in device to which a host is connected.

VLAN

VLAN name associated with port.

LastSeen

Date and time when User Tracking last found an entry for this user or host in a switch. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.

Notes

Notes on this entry, that you enter.


Table 6-5 End Hosts Report—All Columns Layout 

Field
Description

UserName

Discovered username or the username that you have entered. You can edit this field.

You can configure the Asynchronous Network Interface (ANI) Server to collect user names. See the ANI Server online help for further information.

MACAddress

Media Access Control (MAC) address of network interface card in end-user node.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx).

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

HostName

Name of host.

IPAddress

IP address of host.

Subnet

Subnet of IP address.

IPv6 Address

IPv6 address of the host, if any.

Prefix Length

Length of the IPv6 address prefix.

Prefix

IPv6 address prefix

DeviceName

Name corresponding to IP address of device.

Device

IP address of device to which end user node is attached.

Port

Port name in device to which a host is connected.

Port Name

User assigned port name (port label).

Port State

Configured port mode.

Port Duplex

Operational duplex.

Port Speed

Operational speed.

VLAN

VLAN name associated with port.

VLAN ID

VLAN identifier associated with the MAC address or port.

VLAN Type

Ethernet, Token Ring, FDDI, unassigned, or unknown.

Parent VLAN

Parent VLAN of the host.

Secondary VLAN

Secondary VLAN of the host.

Ring

Ringnumber for Token Ring VLANs.

Bridge

BRF bridge number.

LastSeen

Date and time when User Tracking last found an entry for this user or host in a switch. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.

Notes

Notes on this entry, that you enter.


Viewing IP Phones Reports

You can view a report on all IP phones in the network using the IP Phones option of the Report Generator dialog box.

To view report in IP phones:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Generator.

The Report Generator dialog box appears.

Step 3 Select IP Phones from the Select Application list.

Step 4 Select the Report, from the Select Report list.

Step 5 Schedule the report by selecting the report type and the date on which you want the report to be generated.

Step 6 Enter Job Description and E-mail address, if any.

Step 7 Click Submit.

The report is generated.


Interpreting IP Phones Reports

Table 6-6 gives details of the columns in IP Phones Report—Standard Layout.

Table 6-7 gives details of the columns in the IP Phones Report—All Columns Layout.

Table 6-6 IP Phones Report—Standard Layout Columns 

Field
Description

PhoneNumber

Phone number.

MACAddress

Media Access Control (MAC) address of network interface card on the phone.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx).

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

IPAddress

IP address of phone.

CCM Address

Cisco CallManager IP address.

Status

Status of the phone, as known to Cisco Call Manager.

PhoneType

Can be SP30, SP30+, 12S, 12SP, 12SPplus, 30SPplus, 30VIP, SoftPhone, or unknown.

PhoneDescr

Description of the phone.

DeviceName

Name corresponding to IP address of device.

Device

IP address of device to which IP phone is attached.

LastSeen

Date and time when User Tracking last found an entry. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.


Table 6-7 IP Phones Report—All Columns Layout 

Field
Description

PhoneNumber

Phone number.

MACAddress

Media Access Control (MAC) address of network interface card on the phone.

For Ethernet topology the MAC address is displayed in the format (xx-xx-xx-xx-xx-xx).

For Token Ring topology the MAC address is displayed in the format (xx:xx:xx:xx:xx:xx).

IPAddress

IP address of phone, which is displayed in the format String (xxx.xxx.xxx.xxx).

CCM Address

Cisco CallManager IP address.

Status

Status of the phone, as known to Cisco Call Manager

PhoneType

Can be SP30, SP30+, 12S, 12SP, 12SPplus, 30SPplus, 30VIP, SoftPhone, or unknown.

PhoneDescr

Description of the phone.

DeviceName

Name corresponding to IP address of device.

Device

IP address of device to which IP phone is attached in the format String (xxx.xxx.xxx.xxx).

LastSeen

Date and time when User Tracking last found an entry. Last Seen is displayed in the format dd mon yyyy hh:mm:ss.


Understanding Switch Port Usage Reports

You can generate three types of reports using Campus Manager, based on the status of the switch ports.

Report on Unused Down Ports

Report on Unused Up Ports

Report on Recently Down Ports

Report on Unused Down Ports

Campus generates report for administratively down ports, which are not connected to any device or end host after the last User Tracking Acquisition.

Report on Unused Up Ports

Campus generates report for administratively up ports, which are not connected to any device or end host after the last User Tracking Acquisition.

Report on Recently Down Ports

Campus generates report for the ports, which were earlier connected to a device or end host, but are not connected when the last User Tracking Acquisition was completed.

Viewing Reports on Switch Port Usage

You can view reports on Switch port usage using the Switch Port Usage option of the Report Generator dialog box. You can view reports on switch ports that have been recently down, unused and down, and unused and up.

To view report on switch port usage:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Report Generator.

The Report Generator dialog box appears.

Step 3 Select Switch Port Usage from the Select Application list.

Step 4 Select the Report, from the Select Report list.

Step 5 Select the device(s) for which you want to view the Switch Port usage.

Step 6 Schedule the report by selecting the report type and the date on which you want the report to be generated.

Step 7 Enter Job Description and E-mail address, if any.

Step 8 Click Submit.

The report is generated.


Interpreting Switch Port Usage Reports

Table 6-8 describes the columns of a Switch Port Usage report.

Table 6-8 Switch Port Usage Report 

Field
Description

Port

Port or interface of the device.

Port Name

User assigned port name (port label)

Operating Status

Operating status of the port

Admin Status

Admin status of the port


Using Custom Reports

You can create, view, edit, copy, and delete user-defined reports for end hosts and IP phones using the Custom Reports option in the Reports tab of Campus User Tracking window. This section contains:

Viewing List of Custom Reports

Creating Custom Reports

Editing Custom Reports

Copying Custom Reports

Deleting Custom Reports

Viewing List of Custom Reports

You can view the list of custom reports using the Custom Reports option in the Reports tab of the Campus User Tracking window.

To view the list of custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Reports.

The Custom Reports dialog box appears with the list of Available Reports.


Creating Custom Reports

You can create custom reports by clicking Create in the Available Custom Reports dialog box.

To create custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Reports.

The Custom Reports dialog box appears with the list of Available Reports.

Step 3 Click Create.

Step 4 Use the Custom Reports wizard to select the Report Type, add Report Name and Description, select the Group, define report properties, specify simple or advanced query pattern, and view a summary of the custom report.


Editing Custom Reports

You can edit custom reports by clicking Edit in the Available Custom Reports dialog box.

To edit custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Reports.

The Custom Reports dialog box appears with the list of Available Reports.

Step 3 Select a report and click Edit.

Step 4 Use the Custom Reports wizard to modify Group, report properties, and query expressions.


Copying Custom Reports

You can copy custom reports by clicking Copy in the Available Custom Reports dialog box.

To copy custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Reports.

The Custom Reports dialog box appears with the list of Available Reports.

Step 3 Select a report and click Copy.

Step 4 Use the Custom Reports wizard to modify the Name of the report, Group, report properties, and query expressions.


Deleting Custom Reports

You can delete custom reports by selecting a report from the Available Custom Reports dialog box and clicking Delete.

To delete custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Reports.

The Custom Reports dialog box appears with the list of Available Reports.

Step 3 Select a report, and click Delete.


Using Custom Layouts

You can create or customize the columns displayed in custom reports using Custom Layouts option in the Reports tab of Campus User Tracking window. This section contains:

Viewing List of Custom Layouts

Creating Custom Layouts

Editing Custom Layouts

Copying Custom Layouts

Deleting Custom Layouts

Viewing List of Custom Layouts

You can view the list of custom layouts using the Custom Layouts option in the Reports tab of the Campus User Tracking window.

To view the list of custom layouts:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Layouts.

The Custom Layouts dialog box appears with the list of Available Layouts.



Note Standard layouts are available after a fresh install. You can edit the standard layouts. However, you cannot delete them.


Creating Custom Layouts

You can create custom layouts by clicking Create in the Available Custom Layouts dialog box.

To create custom layouts:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Layouts.

The Custom Layouts dialog box appears with the list of Available Layouts.

Step 3 Click Create.

Step 4 Select the type of report for which you want to create the layout.

Step 5 Select the columns that you want displayed in the report from the Available Sources list.

Step 6 Use the Up and Down arrow keys to arrange the columns in the order in which you want them displayed.

Step 7 Click Add to add the selected columns to the Selected Sources list.

Step 8 Specify the Name and Description of the customized layout.

Step 9 Click Save.


Editing Custom Layouts

You can edit custom layouts by clicking Edit in the Available Custom Layouts dialog box.

To edit custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Layouts.

The Custom Layouts dialog box appears with the list of Available Layouts.

Step 3 Click Edit.

Step 4 Select the columns that you want displayed in the report from the Available Sources list.

Step 5 Click Add to add the selected columns to the Selected Sources list.

Step 6 Select the columns that you want removed from the Selected Sources list.

Step 7 Click Remove to remove these fields from the customized layout.

Step 8 Specify the Description of the customized layout.

Step 9 Click Save.



Note Editing Standard Layout columns is seen only in Device Center and external applications. They are not seen in UT jobs.


Copying Custom Layouts

You can copy custom layouts by clicking Copy in the Available Custom Layouts dialog box.

To copy custom reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Layouts.

The Custom Layouts dialog box appears with the list of Available Layouts.

Step 3 Click Copy.

Step 4 Select the columns that you want displayed in the report from the Available Sources list.

Step 5 Click Add to add the selected columns to the Selected Sources list.

Step 6 Select the columns that you want removed from the Selected Sources list.

Step 7 Click Remove to remove these fields from the customized layout.

Step 8 Specify the Name and Description of the customized layout.

Step 9 Click Save.


Deleting Custom Layouts

You can delete custom layouts by selecting a layout from the Available Custom Layouts dialog box and clicking Delete.

To delete custom layouts:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Custom Layouts.

The Custom Layouts dialog box appears with the list of Available Layouts.

Step 3 Select the layout that you want to delete and click Delete.


Using Archived Reports

You can create, view, edit, copy, and delete archived reports using the Archives option in the Reports tab of Campus User Tracking window. This section contains:

Viewing Archived Reports List

Viewing Reports

Deleting Archived Reports

Viewing Archived Reports List

You can view a list of scheduled reports using the Reports Archive option of the Reports tab in the Campus User Tracking window.

To view a list of archived reports:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Archives.

The Archives dialog box appears with the list of archived reports.


Viewing Reports

You can view a report using the

Report Jobs option in the Reports tab of Campus User Tracking window

Report Generator option in the Reports tab of Campus User Tracking window

Archives options in the Reports tab of Campus User Tracking window

Device Center feature of CiscoWorks and selecting a report pertaining to the device.

To view a report using the Report Jobs option:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Reports Jobs.

The Report Jobs dialog box appears with the list of scheduled jobs.

Step 3 Select the job for which you want to view the report and click View.


Table 6-4 gives details of the columns in End Hosts Report - Standard Layout

Table 6-6 gives details of the columns in IP Phones Report - Standard Layout

Table 6-5 gives details of the columns in End Hosts Report - All Columns Layout

Table 6-7 gives details of the columns in the IP Phones Report - All Columns Layout.

Table 6-8 gives details of the columns in Switch Port Usage Report.

To view a report using the Report Generator option:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Report > Report Generator.

The Report Generator dialog box appears.

Step 3 Select the an application and a relevant report that you want to view

Step 4 Click Submit.

The report is generated.



Note The Duplicates reports use the end host report format.


Table 6-4 gives details of the columns in End Hosts Report - Standard Layout

Table 6-6 gives details of the columns in IP Phones Report - Standard Layout

Table 6-5 gives details of the columns in End Hosts Report - All Columns Layout

Table 6-7 gives details of the columns in the IP Phones Report - All Columns Layout.

Table 6-8 gives details of the columns in Switch Port Usage Report.

To view a report using the Archives option:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Report > Archives.

The Archives dialog box appears.

Step 3 Select the report that you want to view and click View.


Table 6-4 gives details of the columns in End Hosts Report - Standard Layout

Table 6-6 gives details of the columns in IP Phones Report - Standard Layout

Table 6-5 gives details of the columns in End Hosts Report - All Columns Layout

Table 6-7 gives details of the columns in the IP Phones Report - All Columns Layout.

Table 6-8 gives details of the columns in Switch Port Usage Report.

To view a report from the Device Center:


Step 1 From the CiscoWorks Homepage select Device Troubleshooting > Device Center. The Device Center window appears.

Step 2 In the Device Selector field enter the IP address or name of the device you want to select and click Go, or select a device from the device groups. The Campus Manager reports available for the selected device are displayed under the Reports column in the Functions Available area.

Step 3 Click the report that you would like to view


Table 6-4 gives details of the columns in End Hosts Report - Standard Layout

Table 6-6 gives details of the columns in IP Phones Report - Standard Layout

Table 6-5 gives details of the columns in End Hosts Report - All Columns Layout

Table 6-7 gives details of the columns in the IP Phones Report - All Columns Layout.

Table 6-8 gives details of the columns in Switch Port Usage Report.

Deleting Archived Reports

You can delete an archived report by selecting the report from the list of archived reports and clicking Delete.

To delete an archived report:


Step 1 Select Campus Manager > User Tracking.

The Campus User Tracking window appears.

Step 2 Select Reports > Archives.

The Archives dialog box appears with the list of archived reports.

Step 3 Select the report that you want to delete and click Delete.


User Tracking Command Line Interface

You can execute User Tracking commands from the command line in Solaris and Windows 2000.

Enter ut options -u username -p password.

The options can be one or more of those shown in Table 6-9.


NoteUse the -prompt command if you do not want to enter your password from the command line. Using -prompt prevents other users from running ps and seeing your password.

The host option is required if the User Tracking client and the ANI Server are running on different subnets.

All options are available in CLI mode. Only the -debug, -host, and -port options are available in both CLI and GUI modes.


Table 6-9 User Tracking CLI Commands 

Option
Arguments
Function

-cli

No keywords or arguments.

Runs User Tracking in command-line mode.

-prompt

No keywords or arguments.

This command is required if you do not enter your password from the command line.
If -prompt is specified, User Tracking asks you to type in your password.

-help

No keywords or arguments.

Prints the command line usage.

-ping

{enable | disable}

Enables the Ping Sweep option so that the ANI Server pings every IP address on known subnets before discovery. The default is the last setting used.
For more information, see Modifying Ping Sweep Options.

User Tracking does not perform ping sweep on large subnets, for example, subnets containing Class A and B addresses. Hence, ARP cache might not have some IP addresses and the User Tracking may not display the IP addresses. In larger subnets, the ping process leads to numerous ping responses that might increase the traffic on your network and result in extensive use of network resources.

To perform ping sweep on larger subnets, you can:

Configure a higher value for the ARP cache time-out on the routers. To configure the value, you must use the arp timeout interface configuration command on devices running Cisco IOS.

Use any external software, which will enable you to ping the host IP addresses. This will ensure that when you run User Tracking Acquisition the ARP cache of the router contains the IP addresses.

-Perform Major Acquisition

No keywords or arguments.

Acquires data about all users and hosts on the network and updates the ANI database.

This option starts an acquisition but does not wait for its completion.

-query

This option takes one of the following arguments:

Queries the ANI database and updates the User Tracking table.

all

Gets all User Tracking entries. Similar to "All Host Entries"/simple query in the GUI.

name

Runs the named advanced/simple query, created earlier in the GUI.

dupMAC

Finds duplicate MAC addresses.

dupIP

Finds duplicate IP addresses.

hub

Finds ports with multiple MAC addresses (hubs).

-queryPhone

all

Gets all IP Phone entries.

name

Runs the named advanced query, created earlier in the GUI.

-layout

layout_name

Uses the specified main table layout while performing a query to fetch User Tracking display entries.

-layoutPhone

layout_name

Uses the specified IP phone table layout while performing a query to fetch IP phone display entries.

-host

ANI Server device name or IP Address

Specifies the host name or IP address of the machine running the ANI Server.

This option is mandatory if the User Tracking client and the ANI Server are running on different subnets.

-port

ANI Server web port number

Specifies the web server port number of the ANI Server. The default is 1741.

-export

filename

Exports data to a text file.

Note You must first specify the -query option to fetch the data that you want to export.

-import

filename

Imports lost or deleted UserName and Notes fields from the last exported file.

-stat

No keywords or arguments.

Displays statistical information, such as time of last acquisition, acquisition status, number of records in the User Tracking database, and so on.

-debug

No keywords or arguments.

Enables trace and debug messages for the User Tracking client application.


Troubleshooting User Tracking

Use the information in Table 6-10 to troubleshoot the User Tracking application.

Table 6-10 Troubleshooting User Tracking 

Symptom
Probable Cause
Possible Solution

User Tracking cannot discover any users or hosts

or

User Tracking cannot display any IP phones.

There may be no information in the ANI database.

You must have valid ANI seed device(s) and run an ANI discovery prior to running a User Tracking discovery.

See the ANI Server online help for further information.

User Tracking cannot discover certain users or hosts.

The ANI Server might not have discovered one or more devices to which users and hosts are connected.

1. Check the CiscoWorks topology for the missing devices

2. Ensure that CDP and SNMP are enabled on the devices, rediscover these devices,

3. Verify that they appear on the topology view.

User Tracking cannot discover certain IP phones.

The ANI Server might not have discovered the specific Media Convergence Server (MCS) that runs the instance of Cisco CallManager to which the IP phones are registered.

1. Check the CiscoWorks topology for the missing MCS that runs the instance of Cisco CallManager to which the phones are registered.

2. Ensure that Cisco CallManager is shown as a service running on the MCS shown in the topology view if it is discovered by the ANI Server.

3. Rediscover all IP phones.

User Tracking table does not contain device name, IP address, and subnet information for some hosts.

User Tracking cannot find the most recent network information.

Network changes are not currently reflected in ARP information (routers) or bridge tables (switches).

User Tracking does not perform ping sweep on large subnets; for example, subnets containing Class A and B addresses. Hence, ARP cache might not have some IP addresses and the User Tracking may not display the IP addresses. In larger subnets, the ping process leads to numerous ping responses that might increase the traffic on your network and result in extensive use of network resources.

Enable ping sweeps when User Tracking performs discovery. ping sweeps are enabled by default.

To perform ping sweep on larger subnets, you can either:

Configure a higher value for the ARP cache time-out on the routers. To configure the value, you must use the arp time-out interface configuration command on devices running Cisco IOS.

Or

Use any external software, which will enable you to ping the host IP addresses. This will ensure that when you run User Tracking Acquisition the ARP cache of the router contains the IP addresses.

You made changes to the network and then ran User Tracking discover.

However, the changes are not appearing in the User Tracking display.

A complete ANI discovery has not run since you added your changes.

User Tracking discovery is not a full network discovery. It only discovers the user and host data in your network.

Changes that you make to your network might not appear after a User Tracking discovery.

1. Run UT discovery.

2. Try running a complete ANI Server discovery.

3. Generate a new report after discovery is complete to see the changes.


User Tracking FAQs

Use the information in these sections to answer some of your common questions:

Why are outdated entries showing up in my User Tracking table?

Why doesn't the IP phone display act like the User Tracking table?

How long does User Tracking maintain data?

Does User Tracking discover users and hosts connected to non-Cisco Discovery Protocol (CDP) discovered or managed devices?

How does User Tracking log errors?

Q. Why are outdated entries showing up in my User Tracking table?

A. Outdated entries result when:

A user or host is assigned to new VLAN/port/VTP domain.

A power failure occurred.

A workstation has been switched off or removed from the network.

User Tracking does not automatically delete outdated end-user host entries. To delete these entries:

Manually delete selected entries.

Schedule User Tracking to remove old entries.

Q. Why doesn't the IP phone display act like the User Tracking table?

A. The IP phone table and the main User Tracking table display different kinds of information. See the User Tracking table and the User Tracking table for IP Phone data to see what kinds of information each table displays.

The IP phone table appears in a separate window from the window that displays the main User Tracking table. You cannot run any commands from this window. You can only run commands from the main User Tracking table. See the User Tracking command reference for more information.

Q. How long does User Tracking maintain data?

A. Indefinitely, until you delete the information.

Q. Does User Tracking discover users and hosts connected to non-Cisco Discovery Protocol (CDP) discovered or managed devices?

A. User Tracking discovers all users and hosts in the network from the list of devices known to the ANI Server. For more details on ANI discovery, see ANI Server Online help.

Q. How does User Tracking log errors?

A. User Tracking major acquisition errors are logged in the User Tracking error log. Discovery and Data Collection errors are logged in the ANI Server error log. For more details, see ANI Server Online help.

Understanding UTLite

UTLite is a utility that allows you to collect user names from Primary Domain Controllers, Active Directory, and Novell servers. To do this you need to install UTLite in the Windows Primary Domain Controllers and in the Novell servers. You can also install UTLite in an Active Directory server.

This section contains:

Installing UTLite Script on Active Directory

Installing UTLite Script on Windows

Installing UTLite Script on NDS

Uninstalling UTLite Scripts From Windows

Uninstalling UTLite Scripts From Active Directory

Uninstalling UTLite Scripts From NDS

Installing UTLite Script on Active Directory

You must install the UTLite script on the Active Directory server and update the server's logon script to get user logon information from Active Directory hosts.

You must have Administrator privileges on the Active Directory server to install the UTLite logon script.


Step 1 Copy the required files to the Active Directory server:

a. Log into the Active Directory server as Administrator.

b. Obtain the UTLite files from the Server Configuration:

C:\Program Files\CSCOpx\campus\bin\UTLite33.exe

C:\Program Files\CSCOpx\campus\bin\UTLiteNT.bat

where C:\Program Files\ is the directory in which you installed CiscoWorks.

c. Copy the UTLiteNT.bat and UTLite33.exe files into the NETLOGON folder.

NETLOGON is located at %SystemRoot%\sysvol\sysvol\domain DNS name\scripts, where %SystemRoot% is usually c:\winnt and domain DNS name is the DNS name of the domain

Step 2 Edit the UTLiteNT.bat file:

a. Open the UTLiteNT.bat file.

b. Locate the following line and replace domain and ipaddress with the domain name of the Windows domain controller and IP address of the computer running the ANI Server:

start %WINDIR%\UTLite33 -domain domain -host ipaddress -port 16236


Note If port 16236 is already in use, enter a different number. This port number must match the number that you entered in the Use Port Number field, in User Tracking > Admin > Acquisition > Acquisition Settings page. For more details, see Modifying Acquisition Settings.


Step 3 Edit the logon script files to run the UTLiteNT.bat file when users log into the network by adding this line:

UTLiteNT.bat

Step 4 Update the domain controller's logon script for each Windows domain that you add.

The first time users log into the network after you edit this script, UTLite33.exe is copied to the local WINDIR directory on their Windows client system.


Installing UTLite Script on Windows

You must install the UTLite script on the primary domain controller and update the domain controller's logon script to get user logon information from Windows hosts. Do this once for each domain.

You must have Administrator privileges on the primary domain controller to install the UTLite logon script.


Step 1 Copy the required files to the primary Windows domain controller:

a. Log into the Windows primary domain controller as Administrator.

b. Obtain the UTLite files from the Server Configuration:

C:\Program Files\CSCOpx\campus\bin\UTLite33.exe

C:\Program Files\CSCOpx\campus\bin\UTLiteNT.bat

where C:\Program Files\ is the directory in which you installed CiscoWorks.

c. Copy the UTLiteNT.bat and UTLite33.exe files into the NETLOGON folder.

NETLOGON is located at
%SYSTEMROOT%\system32\Repl\Import\Scripts, where, SYSTEMROOT% is the root directory for the Windows operating system files.

Step 2 Edit UTLiteNT.bat file.

a. Open the UTLiteNT.bat file.

b. Locate the following line and replace domain and ipaddress with the domain name of the Windows domain controller and IP address of the computer running the ANI Server:

start %WINDIR%\UTLite33 -domain domain -host ipaddress -port 16236


Note If port 16236 is already in use, enter a different number. This port number must match the number that you entered in the Use Port Number field, in User Tracking > Admin > Acquisition > Acquisition Settings page. For more details, see Modifying Acquisition Settings.


Step 3 Edit the logon scripts. Edit users' logon script files to run the UTLiteNT.bat file when users log into the network by adding this line:

UTLiteNT.bat

Step 4 Update the domain controller's logon script for each Windows domain that you add.

The first time users log into the network after you edit this script, UTLite33.exe is copied to the local WINDIR directory on their Windows client system.


Installing UTLite Script on NDS

You must install the UTLite script on the Novell Server and update the domain controller's logon script, to get user logon information from Windows hosts. You only need to do this once for each domain.

You must have ZenWorks installed and running on the Novell Server, and you must be using NDS 5.0 or later.


Step 1 Copy the required files to the Novell Server.

Step 2 Log into the Novell Server as Administrator.

Step 3 Obtain the UTLite files from the CiscoWorks Server:

C:\Program Files\CSCOpx\campus\bin\UTLite33.exe

C:\Program Files\CSCOpx\campus\bin\UTLiteNDS.bat

where C:\Program Files\ is the directory in which you installed CiscoWorks.

Step 4 Create a folder in \\Novell Server Name\SYS\public and copy UTLiteNDS.bat and UTlite33.exe to the folder.

Step 5 Edit the UTLiteNDS.bat file:

Step 6 Open the UTLiteNDS.bat file.

Step 7 Locate the following line and replace domain and ipaddress with the domain name of the Windows domain controller and IP address of the computer running the ANI server:

start %WINDIR%\UTLite33 -domain domain -host ipaddress -port 16236


Note If port 16236 is already in use, enter a different number. This port number must match the number that you entered in the Use Port Number field, in User Tracking > Admin > Acquisition > Acquisition Settings page. For more details, see Modifying Acquisition Settings.


Step 8 Edit the logon scripts.

Step 9 Enter \\Novell_Server_Name\SYS\public\NaL.exe at the command prompt.

Step 10 Click NWAdmin32 to run the Novell Netware Administrator program.

Step 11 Right-click on the users or organizational units whose logon scripts you want to modify and select Details.

Step 12 Click Login Script and enter:

@\\%FILE_SERVER%\sys\public\your_folder_name\UTLiteNDS.bat where your_folder_name is the name of the folder you created in Step 1.


Uninstalling UTLite Scripts From Windows

If you choose not to have ANI automatically collect user names, follow these instructions to properly remove the UTLite scripts.


Step 1 Remove UTLiteNT.bat and UTLite33.exe files from each primary domain controller.

Step 2 Remove the call to run UTliteNT.bat from users' logon scripts.

Step 3 Delete UTLite33.exe from the WINDIR directory of all Windows clients. To quickly locate the WINDIR directory, enter set windir from a command prompt window on each client.


Uninstalling UTLite Scripts From Active Directory

If you choose not to have ANI automatically collect user names, follow these instructions to properly remove the UTLite scripts.


Step 1 Remove UTLiteNT.bat and UTLite33.exe files from each Active Directory server.

Step 2 Remove the call to run UTliteNT.bat from users' logon scripts.

Step 3 Delete UTLite33.exe from the WINDIR directory of all Windows clients. To quickly locate the WINDIR directory, enter set windir from a command prompt window on each client.


Uninstalling UTLite Scripts From NDS

If you choose not to have ANI automatically collect user names, you must perform these steps to properly remove the UTLite scripts:


Step 1 Remove UTLiteNDS.bat and UTLite33.exe files from the Novell Server.

Step 2 Remove the line added to the login scripts for all users and organizational units.

Step 3 Delete UTLite33.exe from the WINDIR directory of all clients.

To quickly locate the WINDIR directory, enter set windir from a command prompt window on each client.


User Tracking Utility

CiscoWorks User Tracking Utility 1.1 (UTU) is a Windows desktop utility that provides quick access to useful information about users or hosts discovered by the Campus Manager User Tracking application. This section contains:

Understanding UTU 1.1

Hardware and Software Requirements for UTU 1.1

Downloading UTU 1.1

Installing UTU 1.1

Accessing UTU 1.1

Configuring UTU 1.1

Searching Users or Hosts

Using Search Patterns

Uninstalling UTU 1.1

Upgrading to UTU 1.1

Understanding UTU 1.1

User Tracking Utility 1.1 (UTU 1.1) allows users with Help Desk access to search for users or hosts discovered by Campus Manager User Tracking application. UTU comprises a server-side component and a client utility.

To use UTU, Campus Manager must be installed and functioning on your machine, and accessible through the network.


Note UTU does not support SSL transport mode. Do not enable SSL on the Campus Manager server.


Definitions

Table 6-11 explains certain terms and definitions used in User Tracking Utility.

Table 6-11 Definitions 

Term
Definition
Host

Any UNIX or Windows system discovered by User Tracking.

Host Name

Name of the discovered host.

Campus Manager Server

Device name or IP address of CiscoWorks server on which you have installed Campus Manager.

Port

Port number to which the host is connected.

Subnet

Subnet to which the host belongs.

User Name

Name of the user who has logged into the host.


Hardware and Software Requirements for UTU 1.1

Table 6-12 lists the minimum system requirements for UTU.

Table 6-12 System Requirements 

Requirement Type
Minimum Requirements

System Hardware

IBM PC-compatible computer with Intel Pentium processor.

System software

Windows 2000 (Professional or Server) with Service Pack 3 or higher.

Memory (RAM)

128 MB

Additional required software

Campus Manager 4.0

Network Connectivity

Campus Manager 4.0 must be in operation, and accessible through the network



Note User Tracking Utility 1.1 does not support SSL transport mode. Do not enable SSL on the Campus Manager server.


Downloading UTU 1.1

UTU requires CiscoWorksUserTrackingUtility1.1.exe file to be downloaded and installed.


Step 1 Locate the file CiscoWorksUserTrackingUtility1.1.exe at:

http://www.cisco.com/cgi-bin/tablebuild.pl/cw2000-campus

Step 2 Save the file to a temporary directory on your system.


Installing UTU 1.1

To install UTU 1.1:


Step 1 Log into the system with local system administrator privileges.

Step 2 Navigate to the directory that contains CiscoWorksUserTrackingUtility1.1.exe.

Step 3 Double-click CiscoWorksUserTrackingUtility1.1.exe to begin installation.

The User Tracking Utility Welcome screen appears.

Step 4 Click Next.

The Choose Destination Location dialog box appears. By default, UTU is installed in the directory C:\Program Files\CSCOutu.

Step 5 Click Next to install UTU in the default directory.

or

Click Browse to choose a different directory and click OK; then, click Next to continue with the installation.

The Configure CiscoWorks Campus Manager Server Details dialog box appears.

Step 6 Enter the name or IP address of the server on which Campus Manager is installed.

Step 7 Enter the HTTP port number of the Campus Manager server. The default port number is 1741.

Step 8 Click Next.


Note User Tracking Utility 1.1 does not support SSL transport mode. Do not enable SSL on the Campus Manager server.


The Configure CiscoWorks Campus Manager Server Authentication dialog box appears. You can also configure these server details after installation.

Step 9 Enter a valid CiscoWorks Campus Manager Server user name and password.

This is used to verify the validity of the user when searching for users or hosts.

Step 10 Confirm the password and click Next.

The Setup Complete dialog box appears.

Step 11 Click Finish to complete the installation.

User Tracking Utility 1.1 is installed at the destination location you specified in Step 5 above. However, it does not create a program group under Start > Programs. To access the utility, see Accessing UTU 1.1.


You cannot re-install UTU on a system that already has this application installed on it. You must check for existing installations of UTU before beginning a fresh installation.

To confirm UTU installation on your system, right-click the taskbar and select Toolbars of your machine. You can find User Search Band option in the popup menu.

Accessing UTU 1.1

To display the UTU desktop band on the taskbar:


Step 1 Right-click the taskbar of the machine on which you installed UTU.

Step 2 Select Toolbars > User Search Band, as shown in Figure 6-1.

Figure 6-1 Selecting the Toolbar

The UTU desktop band appears on the taskbar with the title User Information.


Configuring UTU 1.1

You must configure UTU only if you want to change the Campus Manager server configurations that you entered while installing UTU.

To configure UTU:


Step 1 Right-click the User Information search area on the taskbar of the machine on which you installed UTU.

A popup menu appears.

Step 2 Select Configure.

The CiscoWorks Campus Manager Server dialog box appears.

Step 3 Modify the settings as required.

Step 4 Click OK to finish or Cancel to quit.


Searching Users or Hosts

You can use UTU search band to search for the users or hosts in your network. You can search using user name, host name or IP address, or MAC address. The default search criterion is host name or IP address of the host.


Note UTU search is case-sensitive.


To search for users or hosts:


Step 1 Enter host name or IP address in the User Information field on the taskbar of the machine.

The default search criterion is host name or IP address of the host. To customize this search criterion:

a. Right-click the Users Information search area.

A popup menu appears with the default search criterion (Host/IP) as selected.

b. Select User, Host/IP, or MAC Address from the popup menu.

The selected criterion will be set for future searches until you change the criterion.

Table 6-13 describes the search criteria in UTU 1.1.

Table 6-13 Search Criteria in UTU 

Search Criterion
Description

User

User name of the hosts in the network.

Host/IP

Host name or IP address.

MAC Address

MAC address of the hosts in the network.


Step 2 Enter any value related to user name, host name, IP address, or the MAC address in the User Information field.

For example, you can enter 10.77.208* in the User Information field.

Step 3 Press Enter.

UTU displays the search results, which is a list of user names, host names, IP addresses, or MAC addresses, in a Select Entry popup box. The Select Entry popup box has an option Copy All to Clipboard, where you can copy the complete search result.

Step 4 Select an entry in the Select Entry popup box.

A new popup box appears with the details for that particular entry, as described in Table 14.

Table 14 Details for Each Entry in Select Entry Box 

Entry
Description

User Name

User name of the user logged in to the host.

Host Name

Name of the host discovered by User Tracking.

MAC Address

MAC address of the host.

IP Address

IP address of the host.

Subnet

Subnet to which the host belongs.

Switch

Device name or IP address of the switch.

Port

Port number to which the host is connected.

Port State

State of the port: Static or Dynamic.

VLAN

VLAN to which the port of the switch belongs.

Port Speed

Bandwidth of the port of the switch.

Port Duplex

Port Duplex configuration details on the device.

Last Seen

Last time the User Tracking discovered this host.

Copy to Clipboard

Copies the entries and the details to clipboard.



Note The search results for the value you enter in the User Information field depends on the default search criterion.



Using Search Patterns

UTU searches for the user or hosts, which match the user name, host name or IP address, or MAC address. You can search for users or hosts by entering a pattern. For example:

Entering Cisco will display users or hosts, where the user name or host name matches Cisco.

Entering Cisco* will display users or hosts beginning with the word Cisco

Entering 10.77.208* will display host IP addresses, which begin with 10.77.208.

Uninstalling UTU 1.1

To uninstall UTU 1.1:


Step 1 From the Windows taskbar, select Start > Settings > Control Panel > Add/Remove Programs.

The Add/Remove Programs dialog box appears.

Step 2 Select CiscoWorks User Tracking Utility.

Step 3 Click Change/Remove.

The system prompts you to confirm uninstallation.

Step 4 Click Yes.

The Remove Programs From Your Computer dialog box appears.

Step 5 Click Yes to remove shared file, UTBand.dll, and click OK.

If you click No, the uninstallation proceeds, but it does not completely uninstall UTU. To complete the uninstallation process, you must:

a. Hide the UTU desktop band.

Right-click the taskbar of the machine on which you installed UTU.

Deselect Toolbars > User Search Band.

b. At the command prompt, go to the directory where have you installed UTU. The default directory is C:\Program Files\CSCOutu.

Enter regsvr32 /u UTBand.dll

The following message appears:

DLLUnregisterServer in UTBand.dll failed

Click OK.

Enter del UTBand.dll

This removes the UTU installation completely from the machine.

Step 6 Restart your system.


Upgrading to UTU 1.1

You can upgrade User Tracking Utility from UTU 1.0 to UTU 1.1.

When you install UTU 1.1 above UTU 1.0, UTU prompts you to uninstall the previous version. A message appears:

WARNING: The setup program has detected a previous version of 
CiscoWorks User Tracking Utility. To install CiscoWorks User Tracking 
Utility 1.1, previous version of the product must be uninstalled. Do 
you want to uninstall CiscoWorks User Tracking Utility 1.0 now?
Yes/No

Click Yes to upgrade, or No to quit.

User Tracking Debugger Utility

The User Tracking Debugger Utility is a command line tool to help debug common problems with User Tracking. This section contains:

Understanding Debugger Utility

Using Debugger Utility

Understanding Debugger Utility

The utility provides a report on the reasons why User Tracking failed to discover end hosts on specific ports.

In many cases, User Tracking may fail to perform as expected due to unexpected behavior by other applications like ANI Server (e.g., devices not discovered by ANI) and Topology Services (e.g., inadequate VLAN discovery).

You can run the utility to troubleshoot problems, or provide the report, and log generated by the utility when you contact TAC for help in diagnosing problems.

The debugger utility directly makes all the calculations from the data collected by ANI Server and reports exactly the reason behind missing ports in UT. This tool also has an SNMP component embedded which runs a SNMP query for the table as a part of verification for SNMP failure, e.g., SNMP bugs in Catalyst operating system, due to which User Tracking may fail to discover devices. This generates an Action Report for which may be used for analyzing the data.

The Debugger Utility:

1. Checks the switch ports in a sequential order.

2. Reports violation of basic rules for each of the missing ports such as link ports and trunk ports.

3. Checks for SNMP retrieval of data, if the ports pass the validity check.

4. Generates an Action Report suggesting possible remedial actions for retrieving the valid missing ports.

Using Debugger Utility

The Debugger Utility is available at $NMSROOT/campus/bin/ (where $NMSROOT is the directory where you have installed CiscoWorks).

To run the Debugger Utility, run the command:

utdebug -switch switch-ip -port port1[,port2 ...] [-export filename]

where,

switch is the switch to which the end hosts are connected.

ports are the ports on the switch which have missing end hosts User Tracking.

-export filename specifies that the debug messages be stored in the file specified. If this option is not used, the messages are displayed on the console.

For example,
utdebug -switch 10.29.6.12 -port 5/12
utdebug -switch 10.29.100.10 -port Fa0/10
utdebug -switch 10.29.6.14 -port Gi6