Installation and Setup Guide for Campus Manager 4.0.6 for Solaris (With LMS 2.6)
Appendix C: User Tracking Utility

Table Of Contents

User Tracking Utility

Understanding UTU

Definitions

Hardware and Software Requirements for UTU

Downloading UTU

Installing UTU

Accessing UTU

Configuring UTU

Uninstalling UTU

Upgrading to UTU 1.1.1

Reinstalling UTU


User Tracking Utility


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

This chapter contains:

Understanding UTU

Hardware and Software Requirements for UTU

Downloading UTU

Installing UTU

Accessing UTU

Configuring UTU

Uninstalling UTU

Upgrading to UTU 1.1.1

Reinstalling UTU

Understanding UTU

User Tracking Utility 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 accessible through the network.

Definitions

Table C-1 explains certain terms and definitions used in User Tracking Utility.

Table C-1 Definitions 

Term
Definition

Host

Any UNIX or Windows system discovered by User Tracking.

Host Name

Name of the discovered host.

Campus Manager Server

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

Port

Port number to which the host is connected

Port number on which Campus Manager is running on the CiscoWorks server

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

Table C-2 lists the minimum system requirements for UTU 1.1.1.

Table C-2 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, Windows XP with Service Pack 2 or higher.

Memory (RAM)

128 MB

Additional required software

Campus Manager 4.0.6

Network Connectivity

Campus Manager 4.0.6 must be running and accessible through the network


Downloading UTU

UTU requires CiscoWorksUserTrackingUtility1.1.1.exe file to be downloaded and installed. To download:


Step 1 Locate the file CiscoWorksUserTrackingUtility1.1.1-k9.zip at:

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

This zip file contains CiscoWorksUserTrackingUtility1.1.1.exe and setup.iss file (required for silent installation).

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


Installing UTU

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 CiscoWorksUserTrackingUtility1.1.1.exe.

Step 3 Double-click CiscoWorksUserTrackingUtility1.1.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

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

b. Click Next to continue with the installation.

The Configure CiscoWorks LMS 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 port number of the Campus Manager server. The default port number is 1741.

Step 8 Click Next.

The following message appears:

Is CiscoWorks LMS Server SSL Enabled?

Step 9 Click Yes if the Campus Manager server is SSL enabled, otherwise, click No.

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

Step 10 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 11 Confirm the password and click Next.

The Setup Complete dialog box appears.

Step 12 Click Finish to complete the installation.

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


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 install UTU in silent mode, enter the following at the command prompt:

exe-location\CiscoWorksUserTrackingUtility1.1.1.exe -a -s -f1file-location\setup.iss

where

exe-location is the directory where you have CiscoWorksUserTrackingUtility1.1.1.exe

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\CiscoWorksUserTrackingUtility1.1.1.exe -a -s -f1c:\utu\setup.iss

To configure the server information, modify the setup.iss file before running the silent install. Edit the following fields:

[SdShowDlgEdit2-0]

szEdit1= <hostname>

szEdit2= <server-port>

Result=1

[AskYesNo-0]

Result=1 <1- SSL Enabled, 0 - SSL Disabled>

[SdShowDlgEdit3-0]

szEdit1=<username>

szEdit2=<password>

szEdit3=<password>

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 the Toolbar option in your machine. You can find the User Search Band option in the popup menu.

Accessing UTU

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 C-1.

Figure C-1 Selecting the Toolbar

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


Configuring UTU

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 Campus Manager Server Configuration dialog box appears.

Step 3 Modify the settings as 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 C-2.

Figure C-2 Enabling SSL

Step 5 Click OK to configure or Cancel to quit.


Uninstalling UTU

Before you uninstall UTU 1.1.1, you must hide the UTU desktop band. To do that, right-click the taskbar of the machine on which you installed UTU, and deselect User Search Band in the Toolbars popup menu.

To uninstall UTU:


Step 1 Go to the Windows taskbar and 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 the shared DLL, UTBand.dll, and click OK.

Or

Click No.

The uninstallation proceeds, but it does not completely uninstall UTU.

To complete the uninstallation process:

a. 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.1

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

When you install UTU 1.1.1 above UTU 1.1, 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.1, previous version of the product must be uninstalled. Do you want to uninstall CiscoWorks User Tracking Utility 1.1.1 now?

Yes/No

Click Yes to upgrade, or No to quit.

Reinstalling UTU

You must not install UTU 1.1.1 on a system that already has this application installed on it. You must check for existing installations of UTU 1.1.1 before attempting to reinstall it.

To check for an existing installation of UTU 1.1.1:


Step 1 Right-click on the Taskbar of the machine.

Step 2 Select Toolbars.

If you see the User Search Band option, it means you have UTU 1.1.1 already installed on the system.

You must first uninstall the current installation of UTU 1.1.1, and only then reinstall it.