Installing and Migrating to Cisco Prime LAN Management Solution 4.2
Appendix B: User Tracking Utility

Table Of Contents

User Tracking Utility

Understanding UTU

Hardware and Software Requirements for UTU 2.0

Downloading UTU 2.0

Installing UTU 2.0

Installing UTU 2.0 in Silent Mode

Installing UTU 2.0 in Normal Mode

Accessing UTU 2.0

Configuring UTU 2.0

Searching for Users, Hosts or IP Phones

Using Search Patterns in UTU 2.0

Uninstalling UTU 2.0

Upgrading to UTU 2.0

Re-installing UTU 2.0


User Tracking Utility


CiscoWorks User Tracking Utility is a Windows desktop utility that provides quick access to useful information about users or hosts discovered by LMS.

UTU comprises a server-side component and a client utility.

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

This section explains:

Understanding UTU

Hardware and Software Requirements for UTU 2.0

Downloading UTU 2.0

Installing UTU 2.0

Accessing UTU 2.0

Configuring UTU 2.0

Searching for Users, Hosts or IP Phones

Using Search Patterns in UTU 2.0

Uninstalling UTU 2.0

Upgrading to UTU 2.0

Re-installing UTU 2.0

Understanding UTU

User Tracking Utility (UTU) allows users with Help Desk access to search for users, hosts, or IP Phones discovered by LMS. UTU comprises a server-side component and a client utility.

UTU is supported on LMS 3.0 (Campus Manager 5.0.6), LMS 3.1 (Campus Manager 5.1.4), and LMS 3.2 (Campus Manager 5.2.1). To use UTU in LMS 4.2, Network Topology, Layer 2 Services and User Tracking must be enabled and accessible through the network.

UTU 2.0 supports silent installation mode for easy deployment. It supports communication with LMS server in Secure Sockets Layer (SSL) mode.

The following are the list of features supported in the CiscoWorks User Tracking Utility 2.0 release:

Windows Vista Support

Earlier, User Tracking Utility did not work on Windows Vista client systems because of library conflicts.

UTU 2.0 is built on Microsoft .Net Framework and Windows Presentation Foundation (WPF). With this, UTU 2.0 now works on Windows Vista client systems

Support for Phone Number Search

In this release, UTU supports searching phone numbers in addition to existing search criteria.

Hardware and Software Requirements for UTU 2.0

Table B-1 lists the minimum system requirements for UTU.

Table B-1 System Requirements  for UTU 

Requirement Type
Minimum Requirements

System hardware

IBM PC-compatible computer with Intel Pentium processor.

System software

Windows 2008

Windows XP with SP2 or SP3

Windows Vista

Memory (RAM)

512 MB

Additional required software

LMS 3.0 (Campus Manager 5.0.6), or LMS 3.1 (Campus Manager 5.1.4), or LMS 3.2 (Campus Manager 5.2.1), or LMS 4.2 (Network Topology, Layer 2 Services and User Tracking)

Microsoft .Net Runtime 3.5 Service Pack 1

You can download Microsoft .Net Runtime 3.5 Service Pack 1 from http://www.microsoft.com

Network Connectivity

LMS 3.0 (Campus Manager 5.0.6) or LMS 3.1 (Campus Manager 5.1.4) or LMS 3.2 (Campus Manager 5.2.1) or LMS4.0/4.0.1/4.1/4.2 (Network Topology, Layer 2 Services and User Tracking) must be running, and accessible through the network


Downloading UTU 2.0

UTU requires CiscoWorksUserTrackingUtility2.0.exe file to be downloaded and installed.

To download UTU 2.0:


Step 1 Go to the Cisco Download Software page http://www.cisco.com/cisco/software/release.html?mdfid=282641773&flowid=5141&softwareid=280775110&release=2.0.0&relind=AVAILABLE&rellifecycle=&reltype=latest.

You must be a registered Cisco.com user to access this Software Download site. The site prompts you to enter your Cisco.com username and password in the login screen, if you have not logged in already.

Step 2 Select a product release version from the Latest Releases folder and locate the software update to download.

Step 3 Locate the file CiscoWorksUserTrackingUtility2.0.zip

This zip file contains CiscoWorksUserTrackingUtility2.0.exe and setup.iss file (required for silent installation).

Step 4 Click the Download Now button to download and save the device package file to any local directory on Server.

Step 5 Extract the file using any file extractor such as WinZip.


Installing UTU 2.0

You can install UTU 2.0 either in normal installation mode or silent installation mode.

Before you install UTU 2.0, check whether you system meets the requirements mentioned in Hardware and Software Requirements for UTU 2.0.

This section explains:

Installing UTU 2.0 in Silent Mode

Installing UTU 2.0 in Normal Mode

Installing UTU 2.0 in Silent Mode

To install UTU in silent mode, run the following command at the command prompt:

exe-location\CiscoWorksUserTrackingUtility2.0.exe -a -s -f1file-location\setup.iss

where

exe-location is the directory where you have extracted the CiscoWorksUserTrackingUtility2.0.exe file

file-location is the directory where you have the setup.iss file.

Do not use space after the -f1 option. Use the complete path for file-location.

For example, if the install directory for UTU is c:\utu, enter the following at the command prompt:

c:\utu\CiscoWorksUserTrackingUtility2.0.exe -a -s -f1c:\utu\setup.iss

Editing Setup.iss File

UTU is installed in the C:\Program Files\CSCOutu2.0 directory, by default.

If you want to install UTU in some other directory, you must edit the content of the setup.iss file. Change the value of the szDir attribute in the setup.iss file.

For example, if you want to set the installation directory as D:\utu20, change
szDir=C:\Program Files\CSCOutu2.0 to szDir=D:\utu20 in the setup.iss file.

Setup.log File

The setup.log file is created during the installation in the same directory where you have extracted the setup.iss file.

You should see the setup.log file to check the installation completion status.

The value of the ResultCode attribute in the setup.log informs you whether the installation has completed successfully. The value 0 denotes that the UTU installation in silent mode is successful.

When the value of the ResultCode attribute is other than 0, you must install UTU again.

Installing UTU 2.0 in Normal Mode

To install UTU in normal installation mode:


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

Step 2 Navigate to the directory that contains CiscoWorksUserTrackingUtility2.0.exe.

Step 3 Double-click CiscoWorksUserTrackingUtility2.0.exe to begin installation.

The User Tracking Utility Welcome screen appears.

Step 4 Click Next.

A warning message appears if you have not installed .Net Framework 3.5 SP1.

You can install .Net Framework 3.5 SP1 after terminating the current UTU installation or before completing the current UTU installation.

Step 5 Click Next.

A confirmation message appears.

Step 6 Click Yes.

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


Note If you have installed .Net Framework 3.5 SP1 already on the system, the installer directs you to the Choose Destination dialog box, when you click Next in the User Tracking Utility Welcome screen.


If you click No in the confirmation message, the warning message appears again stating that you have not installed .Net Framework 3.5 SP1.

You can download and install .Net Framework 3.5 SP1. and then continue with the UTU installation.

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

or

a. Click Browse to choose a different directory and click OK.

b. Click Next to continue with the installation.

The installation continues.

Step 8 Click Finish to complete the installation.

User Tracking Utility is installed at the destination location you specified and a shortcut to UTU is created on the desktop. To access the utility, see Accessing UTU 2.0.


Accessing UTU 2.0

To access UTU, click either:

Start > Programs > CiscoWorks UTU 2.0 > CiscoWorks User Tracking Utility 2.0

Or

UTU 2.0 shortcut available on the desktop

The UTU band appears. See Figure B-1for UTU 2.0 band.

You can also find an icon in the task bar. You can use this icon to restore the UTU band when minimized.

Figure B-1 User Tracking Utility - Search Band

1 - Settings Icon 2 - Minimize icon

3 - Close icon 4 - UTU task bar icon

After a system restart and during the startup, the system launches the UTU automatically.

Configuring UTU 2.0

You must configure UTU to set the Campus Manager (for releases earlier than LMS 4.0), or LMS 4.2 server configurations.

To configure UTU:


Step 1 Click the Settings icon.

Or

a. Right-click the UTU search band.

A popup menu appears.

b. Click Settings.

The CiscoWorks Server Settings dialog box appears.

Step 2 Enter the name or IP Address of the server on which Campus Manager (for releases earlier than LMS 4.0), or LMS 4.2 is installed.

Step 3 Enter the port number of the LMS server.

The default HTTP port number is 1741.

You can modify the port number if required.

Step 4 Click Enable SSL for communicating with an SSL enabled server.

The port is changed to 443, which is the default port for SSL. See Figure B-2.

You can modify the port number if required.

Figure B-2 Enabling SSL

You can modify the port number if required. See Figure B-2.

Figure B-3 Enabling SSL


Step 5 Enter a valid CiscoWorks Server user name and password.

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

Step 6 Confirm the password by re-entering it.

Step 7 Select the Remember me on this computer checkbox if you want the client system to remember your credentials.

The credentials are preserved only for the current user of Windows system. The credentials are not available when you log into the Windows system with a different user name.

Step 8 Click Apply to save the changes.


Searching for Users, Hosts or IP Phones

You can use UTU Search Band to search for the users, hosts, or IP Phones in your network.


Note UTU search is case-insensitive.


To search for users, hosts, or IP Phones:


Step 1 Right-click the UTU search band.

A popup menu appears with the default search criterion Host name/IP Address selected.

Step 2 Select a search criterion from the popup menu.

You can search using:

User name

Host name or IP Address

Device name or IP Address

MAC Address

Phone number

The default search criterion is host name or IP Address of the host.

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

Step 3 Enter any value related to user name, host name, device name, IP Address, Phone number or the MAC Address in the UTU search field.

For example, you can enter 10.77.208 in the search field.

Step 4 Press Enter.

If your server is not SSL enabled, go to Step 7.

When you query for data from an SSL enabled server, the Certificate Viewer dialog box appears. See Figure B-4.

Figure B-4 Certificate Viewer

Step 5 Click Details to view the certificate details.

You can verify the authenticity and correctness of the SSL server here. See Figure B-5.

Figure B-5 Certificate Details

You can click Summary to go back to the Certificate Viewer dialog box.

Step 6 Click Yes in the Certificate Viewer dialog box or Certificate Details dialog box to accept and store the certificate.

SSL connection is established with the server.

If you click No, the certificate is not stored and no connection is established with the server.


Note The Certificate Viewer dialog box appears only for the first time configuration. If you had clicked Yes the first time, you are not prompted to store the certificate during subsequent sessions.


Step 7 Click the X Record(s) Found button to launch the results window.

X denotes the number of matches found. See Figure 6.

For example, if there 4 matches found, the UTU Search band displays 4 Record(s) Found.

Figure 6 UTU Search Band displaying the number of matching records

UTU search returns top 500 records only if the number of matches exceed 500. You must refine your search if you want better and accurate results.

Step 8 Select an entry in the Results window.

UTU displays the search results, which is a list of user names, host names, IP Addresses, or MAC Addresses, in a Results window.

The Results window has the following options:

Copy to Clipboard, where you can copy the selected search result record.

Copy All to Clipboard, where you can copy all the search result records.

Close, which you can use to close the window.

For a selected search result record, the Results window displays the details as described in:

Table B-2 for all search criteria except Phone Number

Table B-3 for search based on Phone Number

See Figure B-7 for IP Phone search results window.

Table B-2 Details for Each Entry in Results Window For a User or Host Search 

Entry
Description

User Name

Name of the user logged in to the host.

MAC Address

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

Host IP Address

IP Address of the host.

Host Name

Name of the host discovered by User Tracking.

Subnet

Subnet to which the host belongs.

Subnet Mask

Subnet mask of the host

Device name

Name of the switch.

Device IP Address

IP Address of the switch

VLAN

VLAN to which the port of the switch belongs.

Port

Port number to which the host is connected.

Port Description

Description of the port number to which the host is connected.

Port State

State of the port: Static or Dynamic.

Port Speed

Bandwidth of the port of the switch.

Port Duplex

Port Duplex configuration details on the device.

Last Seen

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 yyyy/mm/dd hh:mm:ss.


Table B-3 Details for Each Entry in Results Window For a Phone Number Search 

Entry
Description

Phone Number

IP Phone number

MAC Address

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

Phone IP Address

IP Address of the phone.

CCM Address

IP Address of the Cisco Call Manager

Status

Status of the phone, as known to Cisco Call Manager

Phone Type

Model of the phone. Can be SP30, SP30+, 12S, 12SP, 12SPplus, 30SPplus, 30VIP, SoftPhone, or unknown.

Phone Description

Description of the phone.

Device Name

Name corresponding to IP Address of device.

Device IP Address

IP Address of the device

Port

Port number to which the phone is connected.

Port Description

Description of the port to which the phone is connected.

Last Seen

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


Figure B-7 IP Phone Number Search Results Window


Note The search results for the value you enter in the search field depends on the default search criteria.



Using Search Patterns in UTU 2.0

UTU searches for the users, hosts, or IP Phones which match the search criterion. See Searching for Users, Hosts or IP Phones for more information.

You can search for users, hosts, or IP Phones by entering a search pattern or substring of a search pattern.

For example, entering Cisco displays host names that start with, end with or contain Cisco for a search on host names.

You do not have to use wildcard character * to match a pattern or substring of the pattern.

To search for a MAC Address, you can use one of the following MAC Address patterns or a substring of these patterns:

xxxx.xxxx.xxxx

xx:xx:xx:xx:xx:xx

xxxxxxxxxxxx

xx-xx-xx-xx-xx-xx

Here x denotes an hexadecimal number.

Uninstalling UTU 2.0

Ensure that UTU is not running while uninstalling.

If you try to uninstall UTU when it is running, an error message appears and uninstallation terminates.

To uninstall UTU:


Step 1 Select Start > Programs > CiscoWorks UTU 2.0 > Uninstall CiscoWorks User Tracking Utility 2.0 from the windows task bar.

The Uninstallation wizard appears and prompts you to confirm the UTU uninstallation.

Step 2 Click Yes.

The Uninstallation continues.

Step 3 Click Finish to exit the uninstallation wizard.


Upgrading to UTU 2.0

You can install UTU 2.0 on the same system where UTU 1.1.1 is installed.

You can choose to install UTU 2.0 on any directory other than the directory where UTU 1.1.1 is installed.

See Installing UTU 2.0 for installation instructions.

Re-installing UTU 2.0

Re-installation of UTU 2.0 is supported on the normal mode of installation.

In the normal mode of installation, you are prompted with a confirmation message whether you want to continue the installation. You must provide your inputs to continue the installation.

See Installing UTU 2.0 for installation instructions.

The user profiles that are created already are not be lost during re-installation.