You are on page 1of 128

User Guide for CiscoWorks Assistant

Software Release 1.2

Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883

Text Part Number: OL-17904-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCBs public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. CCDE, CCSI, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0903R) Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental. User Guide for CiscoWorks Assistant 1.2 Copyright 2009 Cisco Systems, Inc. All rights reserved.

CONTENTS
Notices
vii vii

OpenSSL/Open SSL Project License Issues vii Preface


xi xi xii xii xiii

Audience

Document Conventions Product Documentation Related Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines


1

xiv

CHAPTER

CiscoWorks Assistant - Overview Overview of CiscoWorks Assistant Whats New in This Release
1-2

1-1 1-1

Applications Supported by CiscoWorks Assistant Dependencies of CiscoWorks Assistant Application


2

1-4 1-5

CHAPTER

Getting Started with CiscoWorks Assistant Launching CiscoWorks Assistant


2-1 2-4

2-1

Using CiscoWorks Assistant Shortcuts Setting Debug Level Launching Online Help
3
2-4

User Privileges for CiscoWorks Assistant Workflows

2-4

CiscoWorks Assistant Process and the Dependency Processes


2-6

2-5

CHAPTER

Configuring LMS Server Using CiscoWorks Assistant Before You Begin


3-1

3-1

Logging into CiscoWorks Assistant Server Setup Home Page CiscoWorks Assistant Server Setup Home Page Managing LMS Servers 3-6 Viewing Server Details 3-7 Adding a Server 3-7 Adding Server Details 3-8
3-5

3-5

User Guide for CiscoWorks Assistant OL-17904-01

iii

Contents

Accepting Certificate Information 3-9 Setting up the System 3-10 Viewing Server Addition Summary 3-10 Editing Server Details 3-11 Deleting a Server 3-11 Setting up System Identity User 3-13 Setting and Editing the Device Management Mode 3-13 Allocating Device Groups to CiscoWorks Applications 3-15 Viewing Auto Allocation Summary Report 3-16 Viewing Server Management Status 3-17 Setting Default Credential Sets 3-18 Editing a Default Credential Set 3-22 Viewing Credential Sets Status 3-23 Configuring Device Credential Policies 3-24 Adding a Device Credentials Policy 3-24 Editing a Device Credentials Policy 3-25 Deleting a Device Credentials Policy 3-25 Defining the Order of Device Credential Policies 3-26 Viewing Device Credentials Policy Configuration Status Adding Devices 3-27 Adding Devices Using Bulk Import From File 3-27 Adding Devices Using Bulk Import From NMS 3-28 Adding Devices Using Common Services Device Discovery Setting SNMPv2 Parameters 3-38 Setting SNMPv3 Parameters 3-38 Viewing Add Devices Status 3-40 Deleting SNMPv2 Details 3-41 Deleting SNMPv3 Details 3-41 Managing Devices 3-41 About Device Selector 3-42 Viewing Allocate Devices Status

3-26

3-30

3-43

Changing ACS Setup 3-44 Configuring the ACS Mode 3-46 Viewing the Configure ACS Mode Status 3-49 Viewing the Configure ACS Mode Result 3-50 Updating ACS Configuration 3-51 Assigning Device Group 3-52 Viewing the Server Setup Summary
3-53

User Guide for CiscoWorks Assistant

iv

OL-17904-01

Contents

CHAPTER

Troubleshooting Your Network Using CiscoWorks Assistant Generating Device Troubleshooting Report Generating End Host/IP Phone Down Report Selecting an End Host From the End Hosts List Understanding the End Host Down Report
4-20 4-1 4-4

4-1

Understanding the Device Troubleshooting Report


4-15

4-17

Understanding the IP Phone Down Report 4-21 Using Device Selector in Troubleshooting Workflows
A

4-25

APPENDIX

Troubleshooting CiscoWorks Assistant Frequently Asked Questions


A-1

A-1

Troubleshooting Server Setup Workflows

A-2 A-11

Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows


INDEX

User Guide for CiscoWorks Assistant OL-17904-01

Contents

User Guide for CiscoWorks Assistant

vi

OL-17904-01

Notices
The following notices pertain to this software license.

OpenSSL/Open SSL Project


This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).

License Issues
The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org.
OpenSSL License:

Copyright 1998-2007 The OpenSSL Project. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. 2. 3.

Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution. All advertising materials mentioning features or use of this software must display the following acknowledgment: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). The names OpenSSL Toolkit and OpenSSL Project must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org. Products derived from this software may not be called OpenSSL nor may OpenSSL appear in their names without prior written permission of the OpenSSL Project. Redistributions of any form whatsoever must retain the following acknowledgment: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/).

4.

5. 6.

User Guide for CiscoWorks Assistant OL-17904-01

vii

Notices

THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT AS IS' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).
Original SSLeay License:

Copyright 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved. This package is an SSL implementation written by Eric Young (eay@cryptsoft.com). The implementation was written so as to conform with Netscapes SSL. This library is free for commercial and non-commercial use as long as the following conditions are adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com). Copyright remains Eric Youngs, and as such any Copyright notices in the code are not to be removed. If this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. 2. 3.

Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). The word cryptographic can be left out if the routines from the library being used are not cryptography-related.

4.

If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: This product includes software written by Tim Hudson (tjh@cryptsoft.com).

THIS SOFTWARE IS PROVIDED BY ERIC YOUNG AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

User Guide for CiscoWorks Assistant

viii

OL-17904-01

Notices

THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The license and distribution terms for any publicly available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution license [including the GNU Public License].

User Guide for CiscoWorks Assistant OL-17904-01

ix

Notices

User Guide for CiscoWorks Assistant

OL-17904-01

Preface
This document describes the workflows that make up CiscoWorks Assistant. It provides instructions to configure, administer, and operate CiscoWorks Assistant 1.2. The CiscoWorks Assistant User Guide is organized as shown in Table 1.
Table 1 Chapter Organization

Chapter CiscoWorks Assistant - Overview Getting Started with CiscoWorks Assistant

Description Gives you an overview of CiscoWorks Assistant. Provides you with the list of launch points for the CiscoWorks Assistant workflows. You can also review the Privileges that are required for running CiscoWorks Assistant workflows, using the device selector, and setting up the debug log level for CiscoWorks Assistant.

Configuring LMS Server Using CiscoWorks Assistant Troubleshooting Your Network Using CiscoWorks Assistant

Describes how to configure LMS server. Describes how to troubleshoot your network using Device Troubleshooting and End Host/IP Phone Down workflows.

Troubleshooting CiscoWorks Assistant Describes the troubleshooting tips for all the CiscoWorks Assistant workflows.

Audience
This document provides descriptions and scenarios for system administrators, network managers, and other users who might or might not be familiar with CiscoWorks Assistant. Many of the tools described are accessible to system administrators only.

User Guide for CiscoWorks Assistant OL-17904-01

xi

Preface

Document Conventions
This document uses the conventions shown in Table 2.
Table 2 Document Conventions

Item Commands and keywords Variables for which you supply values Displayed session and system information Information you enter Variables you enter Menu items and button names Selecting a menu item in paragraphs Selecting a menu item in tables

Convention boldface font italic font


screen

font font

boldface screen font italic screen

boldface font Option > Network Preferences Option > Network Preferences

Note

Means reader take note. Notes contain helpful suggestions or references to material not covered in the publication.

Caution

Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Product Documentation
Note

We sometimes update the printed and electronic documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates. Table 3 describes the product documentation that is available.
Table 3 Product Documentation

Document Title User Guide for CiscoWorks Assistant 1.2 (this document)

Available Format

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/ps7212/tsd_products_suppo rt_series_home.html

User Guide for CiscoWorks Assistant

xii

OL-17904-01

Preface

Table 3

Product Documentation

Document Title Release Notes for CiscoWorks Assistant 1.2

Available Format

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/ps7212/tsd_products_suppo rt_series_home.html

Context-Sensitive Online Help

Select an option from the navigation tree, then click Help. Click the Help button in the dialog box.

Related Documentation
The CiscoWorks Assistant workflows are dependent on LMS 3.2 applications. The User Guide and Release Notes for the LMS applications, and Installing and Getting Started With CiscoWorks LAN Management Solution 3.2 document are available in the HTML and PDF formats.

Note

We sometimes update the printed and electronic documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates. Table 4 describes additional documentation available.
Table 4 Related Documentation

Document Title User Guide for CiscoWorks Common Services 3.3

Available Format

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/sw/cscowork/ps3996/produ cts_user_guide_list.html

User Guide for CiscoWorks Campus Manager 5.2

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/sw/cscowork/ ps563/products_user_guide_list.html

User Guide for CiscoWorks Resource Manager Essentials 4.3

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/sw/cscowork/ ps2073/products_user_guide_list.html

User Guide for CiscoWorks Device Fault Manager 3.2

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/sw/cscowork/ ps2421/products_user_guide_list.html

User Guide for CiscoWorks Assistant OL-17904-01

xiii

Preface

Table 4

Related Documentation

Document Title User Guide for CiscoWorks Internetwork Performance Monitor 4.2

Available Format

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/sw/cscowork/ ps1008/products_user_guide_list.html

User Guide for CiscoWorks LMS Portal 1.2

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/ps7198/tsd_products_suppo rt_series_home.html

User Guide for CiscoWorks Health and Utilization Monitor 1.2

PDF on the LMS 3.2 Product DVD and Documentation DVD. On Cisco.com at: http://www.cisco.com/en/US/products/ps9303/tsd_products_suppo rt_series_home.html

Obtaining Documentation, Obtaining Support, and Security Guidelines


For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly Whats New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html Subscribe to the Whats New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.

User Guide for CiscoWorks Assistant

xiv

OL-17904-01

CH A P T E R

CiscoWorks Assistant - Overview


The following sections provide an overview of CiscoWorks Assistant application and all the functionalities that are available in CiscoWorks Assistant.

Overview of CiscoWorks Assistant Whats New in This Release Applications Supported by CiscoWorks Assistant Dependencies of CiscoWorks Assistant Application

Overview of CiscoWorks Assistant


CiscoWorks Assistant is a web-based tool that provides workflows to help you to overcome network management and software deployment challenges. CiscoWorks Assistant is available along with CiscoWorks LAN Management Solution (LMS). This application is installed along with CiscoWorks Common Services. A workflow is a compilation of tasks that assist you to deploy LMS servers and troubleshoot your network. The CiscoWorks Assistant Engine, which works in the backend, executes the workflows and allows you to navigate between the various tasks. CiscoWorks Assistant workflows contain functionalities that are available across LMS applications. These functionalities are grouped logically to setup and configure the LMS server and to troubleshoot your network devices. You can use CiscoWorks Assistant 1.2 only with the following LMS applications versions:

Common Services (CS) 3.3 CiscoView (CV) 6.1.9 Campus Manager (CM) 5.2 Resource Manager Essentials (RME) 4.3 Device Fault Manager (DFM) 3.2 Internetwork Performance Monitor (IPM) 4.2 Health and Utilization Monitor (HUM)1.2 Integration Utility 1.9 CiscoWorks LMS Portal 1.2

User Guide for CiscoWorks Assistant OL-17904-01

1-1

Chapter 1 Whats New in This Release

CiscoWorks Assistant - Overview

To know more about LMS applications, see the User Guides: http://www.cisco.com/web/psa/products/index.html

Whats New in This Release


The following are the new features and enhancements in CiscoWorks Assistant 1.2:
Note

We sometimes update the documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates. http://www.cisco.com/en/US/products/ps7212/products_user_guide_list.html

Multiple Default Credential Support in CiscoWorks Assistant HUM Features in Troubleshooting Workflow
Device Availability Device Threshold

RME Features in Troubleshooting Workflow


Generic Online Diagnostics (GOLD) Call Home Embedded Event Manager (EEM)

CiscoWorks Assistant Publisher Process in Daemon Manager Enhancing IP Address to IPv6 Configuring SNMP Fallback Settings

Multiple Default Credential Support in CiscoWorks Assistant

In this release, CiscoWorks Assistant supports Multiple Default Credentials. In the earlier version, the Default Credentials let you decide whether to apply the default credentials. In this release, you can configure multiple default credentials sets and apply the credential sets while adding and importing devices. See Adding Devices for more information. This release has a new step, Device Credentials Policy Configuration in Server Setup Workflow. This step follows the Default Credential Sets step. See Configuring Device Credential Policies for more information. In this release, Set Default Credential is renamed as Default Credential Sets. In the Credential Sets page, there is a Credential Set Name link which is newly added in the Default Credentials list panel. See Setting Default Credential Sets for more information.
HUM Features in Troubleshooting Workflow

The HUM Troubleshooting report contains:

HUM Device Availability in Troubleshooting Workflow In this release, the Device Troubleshooting workflow is enhanced to display the Device Availability report for the devices managed by HUM. The details of this report are fetched from the HUM Device Dashboard page.

User Guide for CiscoWorks Assistant

1-2

OL-17904-01

Chapter 1

CiscoWorks Assistant - Overview Whats New in This Release

You can use the Device Dashboard link to view more details for the selected device. You can use the Poller link to create pollers for the selected device. The link goes to the Poller Management Page. The Poller link is displayed only if the device does not have any Device Availability template. See Understanding the Device Troubleshooting Report for more information.

HUM Device Threshold in Troubleshooting Workflow Device Threshold report is displayed as a section of Device Troubleshooting Workflow for the devices managed by HUM. The details of this report are fetched from the HUM Device Dashboard page. You can use the Device Dashboard link to view more details for the selected device. You can use the Poller link to create pollers for the selected device. The link goes to the Poller Management Page. The Poller link is displayed only if the device does not have any Device Availability template. See Understanding the Device Troubleshooting Report for more information.

RME Features in Troubleshooting Workflow

The RME Troubleshooting workflow contains:

RME Generic Online Diagnostics (GOLD) in Troubleshooting Workflow The Generic Online Diagnostics (GOLD) report is displayed in the Device Troubleshooting workflow for the devices managed by RME. The details for this report are fetched from the RME Application Programming Interface (API). See Understanding the Device Troubleshooting Report for more information. RME Call Home in Troubleshooting Workflow The Call Home report is displayed in the Device Troubleshooting workflow for the devices managed by RME. The details for this report are fetched from the RME Application Programming Interface (API). See Understanding the Device Troubleshooting Report for more information. RME Embedded Event Manager in Troubleshooting Workflow The Embedded Event Manager (EEM) report is displayed in the Device Troubleshooting workflow for the devices managed by RME. The details for this report are fetched from the RME Application Programming Interface (API). See Understanding the Device Troubleshooting Report for more information.

CiscoWorks Assistant Publisher Process in Daemon Manager

In this release, CiscoWorks Assistant Publisher is a new process added to Daemon Manager. The Daemon Manager is enhanced with this process for the following reasons:

To minimize the install time. This will prevent ProcSysBus and OpsXMLRuntime processes from restarting unnecessarily during installation. To avoid Start Service errors while you are installing CiscoWorks Assistant To allow the publisher to run while you are installing CiscoWorks Assistant To simplify the Install, Upgrade and Restore processes

This process will run for a maximum of five minutes after starting Daemon Manager. After the process has completed running, a message appears, Administrator has Shutdown the Server.

User Guide for CiscoWorks Assistant OL-17904-01

1-3

Chapter 1 Applications Supported by CiscoWorks Assistant

CiscoWorks Assistant - Overview

Enhancing IP Address to IPv6

In this release, CiscoWorks Assistant supports the IPv6 Addressing scheme in the following Device Discovery pages:

Ping Sweep CDP SNMP Settings Filter Settings Global Seed Device

In the Device Troubleshooting home page, the existing IP Address field is enhanced to include the IPv6 devices.
Configuring SNMP Fallback Settings

The SNMP Fallback checkbox in the Discovery window, allows the SNMP details to be reverted to the older version. See Adding Devices for more information.

Applications Supported by CiscoWorks Assistant


CiscoWorks Assistant supports the following workflows:

Server Setup The Server Setup workflow helps you to create a Multi-server set up. It also assists you in adding and managing devices and configuring the AAA mode to ACS. You can add devices to Device and Credential Repository and import these devices across LMS applications. This workflow allows you to add Multiple Default Credential sets and configure policies, based on default credentials. See Chapter 3, Configuring LMS Server Using CiscoWorks Assistant.

Device Troubleshooting You can identify the root cause for device unreachabililty. The generated Device Troubleshooting report contains the following details for the selected device:
Alerts and Syslog Messages Last configuration change Details of the device topology Device Credential Verification for RME CDA job GOLD, Call Home and EEM reports Device availability and threshold reports Details on network inconsistencies, misconfiguration in the network device. See Chapter 4,

Troubleshooting Your Network Using CiscoWorks Assistant.

End Host/IP Phone Down You can get the information required to troubleshoot as well as analyze the connectivity issues. See Chapter 4, Troubleshooting Your Network Using CiscoWorks Assistant.

User Guide for CiscoWorks Assistant

1-4

OL-17904-01

Chapter 1

CiscoWorks Assistant - Overview Dependencies of CiscoWorks Assistant Application

Dependencies of CiscoWorks Assistant Application


CiscoWorks Assistant workflow depends on the LMS applications. Some of functionalities will not be available if you have not installed the relevant LMS application. Table 1-1 describes the CiscoWorks Assistant workflows and the corresponding dependent LMS 3.2 applications.
Table 1-1 CiscoWorks Assistant Workflows and the Dependent LMS Applications

CiscoWorks Assistant Workflows Server Setup


LMS Applications Manage Servers Add Servers Change Device Management Mode Auto Allocation Set Multiple Default Credentials Add Devices Change ACS Settings

Common Services 3.3 and all LMS 3.2 applications.

Device Troubleshooting

Device information

Common Services 3.3 (Device and Credential Repository) All installed LMS 3.2 applications.

Connectivity status Topology and Neighbor information Syslog messages Last configuration change Change Audit reports CDA reports DFM Alerts

Common Services 3.3 Campus Manager 5.2 Resource Manager Essentials 4.3 Resource Manager Essentials 4.3 Resource Manager Essentials 4.3 Resource Manager Essentials 4.3 Device Fault Manager 3.2

Discrepancies in this device Campus Manager 5.2 Generic OnLine Diagnostics Resource Manager Essentials 4.3 Call Home Embedded Event Manager Device Availability Device Threshold End Host/IP Phone Down Log Level Settings End Host down IP Phone down Resource Manager Essentials 4.3 Resource Manager Essentials 4.3 Health and Utilization Monitor 1.2 Health and Utilization Monitor 1.2 Campus Manager 5.2 Campus Manager 5.2 None.

User Guide for CiscoWorks Assistant OL-17904-01

1-5

Chapter 1 Dependencies of CiscoWorks Assistant Application

CiscoWorks Assistant - Overview

User Guide for CiscoWorks Assistant

1-6

OL-17904-01

CH A P T E R

Getting Started with CiscoWorks Assistant


CiscoWorks Assistant is installed as part of CiscoWorks Common Services. The following topics help you to work with and understand the CiscoWorks Assistant user interface:

Launching CiscoWorks Assistant Using CiscoWorks Assistant Shortcuts User Privileges for CiscoWorks Assistant Workflows Setting Debug Level CiscoWorks Assistant Process and the Dependency Processes Launching Online Help

Launching CiscoWorks Assistant


CiscoWorks LMS Portal home page is the first page that appears when you launch the LMS application. It serves as an interface, launch point and provides top-level navigation for the frequently used functions in the application. You can view important statistics and details on the LMS applications installed on your CiscoWorks Server, in a single page instead of navigating through several pages to view the required data. If you have installed CiscoWorks Server and are logging in for the first time, use the reserved admin user name and password you have specified during installation. You can launch CiscoWorks Assistant workflows using:

CiscoWorks Assistant home page (See Launching CiscoWorks Assistant from CiscoWorks LMS Portal.) LMS Applications home page (See Launching CiscoWorks Assistant Workflows from LMS Applications Home Page).

User Guide for CiscoWorks Assistant OL-17904-01

2-1

Chapter 2 Launching CiscoWorks Assistant

Getting Started with CiscoWorks Assistant

Launching CiscoWorks Assistant from CiscoWorks LMS Portal

To launch CiscoWorks Assistant from CiscoWorks LMS Portal:


Step 1

Enter the URL for your CiscoWorks Server in your browser.


http://server_name:port_number

Where server_name is the name of the CiscoWorks Server and port_number is the TCP port used by the CiscoWorks Server. In normal mode (HTTP), the default TCP port for CiscoWorks server is 1741. For example: http://ciscoworksserver:1741

Note

If you enter, http://server_name:port_number/login.html in your web browser, the CiscoWorks Server will not launch. Also, do not bookmark the URL with the trailing login.html. On Windows, CiscoWorks Server always uses the normal mode port 1741 and secure mode port 443 in normal and secure modes. The secure mode port will be changed, when Internet Information Services (IIS) is detected. On Solaris, if the default TCP ports are used by other applications, you can select different ports for secure and normal modes during CiscoWorks LMS installation.

For more information, see Installing and Getting Started with CiscoWorks LAN Management Solution 3.2 The login screen appears.
Step 2

Enter the username in the User ID field, and the password for admin user in the Password field of the Login page. Enter the same admin password that you entered while installing CiscoWorks LMS. The default username is admin. Click Login or press Enter. You are now logged into CiscoWorks Server. After you log into CiscoWorks, the CiscoWorks LMS Portal home page is displayed. The CiscoWorks LMS Portal is the primary user interface and the launch point for all applications.

Step 3

Step 4

Click the CiscoWorks Assistant link or the Home link under the CiscoWorks Assistant portlet on the CiscoWorks LMS Portal home page. The CiscoWorks Assistant home page appears in a new window. The CiscoWorks Assistant home page is an easy way to access frequently used operations. The following links are available.

Workflows
Server Setup Device Troubleshooting End Host/IP Phone Down

Administration
Log Level Settings

User Guide for CiscoWorks Assistant

2-2

OL-17904-01

Chapter 2

Getting Started with CiscoWorks Assistant Launching CiscoWorks Assistant

Launching CiscoWorks Assistant Workflows from LMS Applications Home Page

You can launch the Device Troubleshooting and End Host/IP Phone Down workflows from other LMS applications. You should allocate devices in the LMS applications before launching these workflows. Table 2-1 provides the launch points for the CiscoWorks Assistant workflows.
Table 2-1 Launch Points for CiscoWorks Assistant Workflows from LMS Applications

Workflow Device Troubleshooting Workflow

Application Name Campus Manager

Navigation To launch CiscoWorks Assistant from Topology Services:


1. 2.

Select any device from the Topology View: Right-click and select Troubleshoot.

The Device Troubleshooting window appears. CiscoWorks LMS Portal You can also launch Device Troubleshooting workflow from the N-Hop View portlet. N-Hop View portlet is a HTML-based, light-weight feature and is available as part of CiscoWorks Portal. To launch Device Troubleshooting, select any device, right-click and select Troubleshoot. Device Diagnostic Tools Portlet Device Fault Manager To launch this application, select Device Diagnostic Tools > Device Troubleshooting. You can launch CiscoWorks Assistant from Detailed Device View. To start Detailed Device View:
1. 2.

Go to Device Fault Manager> Device Management > Device Details. Select a device from the Device Selector and click View. The Device Details report appears. Click on the device name in the report to open the Detailed Device View page. Click Get Troubleshooting Info to launch the Device Troubleshooting workflow.

3. 4.

End Host/IP Phone Down Workflow

Campus Manager

You can launch End Host/IP Phone report from User Tracking window:
1. 2. 3.

Select Campus Manager > Admin > User Tracking > Reports > Report Generator page. Select End Host & All Host Entries from the drop down box and generate the report. In the report, click on MAC Address or Host Name or IP Address. The Host center page appears.

4.

On the Host center page, click Troubleshoot.

User Guide for CiscoWorks Assistant OL-17904-01

2-3

Chapter 2 Using CiscoWorks Assistant Shortcuts

Getting Started with CiscoWorks Assistant

Using CiscoWorks Assistant Shortcuts


You can add shortcuts to frequently used CiscoWorks Assistant links in the CiscoWorks LMS Portal. Use these shortcuts to run frequently used tasks and functions. You can register a URL and add it to either Third Party or Custom Tool under External Links portlet view. You can also register the URLs based on the requirement under Frequently Used Links portlet, which works as an shortcut to reach the required applications homepage. For more information on Registering Links With CiscoWorks LMS Portal see the User Guide for CiscoWorks LMS Portal. To access this, go to Help > LMS Portal. You can use the shortcuts as given in Table 2-2.
Table 2-2 CiscoWorks Assistant Shortcut URLs

Task CiscoWorks Assistant Home Device Troubleshooting Workflow End Host/IP Phone Down Server Setup Log Level Settings

URL1 http://ServerName:PortNumber/cwa/CWAHome.jsp http://ServerName:PortNumber/cwa/linkDown.do http://ServerName:PortNumber/cwa/endhostDown.do http://ServerName:PortNumber/cwa/serverSetup.do http://ServerName:PortNumber/cwa/logLevel.do

1. Where, ServerName is the CiscoWorks LMS Server hostname or IP address and PortNumber is the HTTP or HTTPS port number.

User Privileges for CiscoWorks Assistant Workflows


CiscoWorks Assistant uses the privileges that the logged-in user has in the installed applications. In the Server Setup workflow the system identity user or a Local User with all roles assigned can performing all Manage Servers tasks (CiscoWorks Assistant > Server Setup > Manage Servers).

Setting Debug Level


You can use this option to set the logging levels for CiscoWorks Assistant packages. The CiscoWorks Assistant log file (CWA.log) is available in the following location:

NMSROOT/log (on Windows) /var/adm/CSCOpx/log (on Solaris) NMSROOT/objects/wfengine/program/TFTP/Backup/DeviceTrace/CScript

The OPSXML logs are available in the following location: To set the log levels:
Step 1

Select CiscoWorks Assistant > Administration > Log Level Settings. The Set CiscoWorks Assistant Logging Level page appears. Select the appropriate log level from the Logging Level drop-down list.

Step 2

User Guide for CiscoWorks Assistant

2-4

OL-17904-01

Chapter 2

Getting Started with CiscoWorks Assistant CiscoWorks Assistant Process and the Dependency Processes

Step 3 Step 4

Select the Enable Engine Logging check box to enable logging for CiscoWorks Assistant Engine. Click Reset to apply the default logging levels. The default logging level is INFO for CiscoWorks Assistant packages. When you click Reset, the logging level is set to INFO and the CiscoWorks Assistant Engine logging is disabled.

Step 5

Click Apply after you set the log levels. A message appears that the log levels have been successfully updated.

CiscoWorks Assistant Process and the Dependency Processes


Table 2-3 lists the CiscoWorks Assistant processes and their dependency processes. If you stop or restart any of these processes you must stop and restart their dependency processes. See Table 2-3 for the list of dependent processes. You can stop and restart the process using Common Services > Admin > Process.
Table 2-3 CiscoWorks Assistant Process and the Dependency Processes

Process Name OpsXML Runtime

Dependency (Sequential) ProcSysBus OpsxmlDbEngine

Description System service: CiscoWorks Assistant workflow engine.

Log Files DataStore.log GGLogger.log GGScript.log PolicyScheduler.log GGHelper.log GGProxy.log OpsBREngine.log PolicyServer.log None

ProcSysBus

None

System service: Message Bus Service for CiscoWorks Assistant

OpsxmlDbEngine

None

System service: the database None engine for CiscoWorks Assistant Engine. Publishes the OpsXML data to the CiscoWorks Assistant database. Windows: CWAPublisher.log Solaris: deamons.log

CiscoWorks Assistant Publisher

OpsXMLRuntime

User Guide for CiscoWorks Assistant OL-17904-01

2-5

Chapter 2 Launching Online Help

Getting Started with CiscoWorks Assistant

CiscoWorks Assistant Log File Details

Table 2-4 lists the CiscoWorks Assistant Log File Details.


Table 2-4 CiscoWorks Assistant Log File Details

Log File Name

Module

Windows

Solaris

Purpose

ProcSysBus and Server Setup OpsXMLRuntime Workflow logs

OPSXMLRoot/program/ NMSROOT/objects/wfengine/p Maintains the logs/*.log rogram/OpsXML.log behavior details of CiscoWorks NMSROOT/objects/wfengine/p Assistant workflow rogram/logs/all log files engine.

Device Trace logs Device Trouble OPSXMLRoot/program, /opt/CSCOpx/objects/wfengine Contains the http Shooting/End Host/IP /TFTP/Backup/Device /program/TFTP/Backup/Devic requests and Phone Down eTrace/CScript/all logs files responses of the Trace/CScript/** URL calls that occur while generating the Endhost/IP Phone Down Troubleshooting report. Install Logs Install c:\<install-log> /var/tmp/install-log Registers the errors that occurred during installation.

Launching Online Help


On the CiscoWorks Assistant home page, click Help to Launch the CiscoWorks Assistant Online help. This Help button is available at the top right corner of your CiscoWorks Assistant home page. The CiscoWorks Online help is launched in a separate browser window. The complete User Guide can be viewed in the Adobe Portable Document Format (PDF) from within the Online help. To view the PDF, Adobe Acrobat 6.0 or later is required. Table 2-5 describes the tabs in the CiscoWorks Assistant Online help.
Table 2-5 CiscoWorks Assistant Online Help Tabs

Button Contents (Button) Index (Button)

Description Displays the Online help table of content for the launched LMS application. That is, if you have launched Common Services Online help, the table of content for the Common Services application appears. Displays the index entries for the launched LMS application. That is, if you have launched Common Services Online help, the index entries for the Common Services application appears.

User Guide for CiscoWorks Assistant

2-6

OL-17904-01

Chapter 2

Getting Started with CiscoWorks Assistant Launching Online Help

Table 2-5

CiscoWorks Assistant Online Help Tabs

Button Search (Button)

Description Allows you search any key words within the launched LMS application. That is, if you have launched Common Services Online help, you can search for any keywords within the Common Services Online help.

If you want to search key words in all of the installed LMS application, you must select All in the application drop-down box (second drop-down box). If you want to search key words in specific LMS application, you must select the application name in the application drop-down box (second drop-down box). That is, if you want to search in CiscoWorks Assistant, select CiscoWorks Assistant from application drop-down box.

Main (Link)

This link is available in the top right corner of the CiscoWorks Online Help window. Launches the home page of LMS applications Online help. Based on your LMS installed applications, the table of content area lists the LMS Application Online help. If you have installed all the LMS applications, the table of content lists the following:

Campus ManagerLaunches the Campus Manager Online help. CiscoWorks AssistantLaunches the CiscoWorks Assistant Online help. CiscoWorks Common ServicesLaunches the Common Services Online help Device Fault ManagerLaunches the Device Fault Manager Online help. Device ManagerLaunches the CiscoView application (Basic) and CiscoView device packages (ATM Manager, AP1100, Catalyst 4000 IOS, etc.) Online help. Internetwork Performance MonitorLaunches the Internetwork Performance Monitor Online help. Resource Manager EssentialsLaunches Resource Manager Essentials application (RME User Guide) and device packages (Cisco 10000 Series Routers, Cisco 2600XM Multiservice Router, etc.) Online help.

User Guide for CiscoWorks Assistant OL-17904-01

2-7

Chapter 2 Launching Online Help

Getting Started with CiscoWorks Assistant

User Guide for CiscoWorks Assistant

2-8

OL-17904-01

CH A P T E R

Configuring LMS Server Using CiscoWorks Assistant


The Server Setup workflow helps you to setup and manage CiscoWorks LAN management Solution (LMS) servers. It helps you to simplify the deployment and setting up of single or multiple LMS servers. The Server Setup workflow assists you in:

Managing LMS ServersYou can add servers, set up System Identity User accounts, and set up the device management mode. Setting Default Credential SetsYou can use the Credential Set feature to prevent the management applications from failing if devices added or imported into DCR do not contain all necessary credentials. Credentials are stored in DCR and are not associated with any device. Configuring Device Credential PoliciesYou can configure device credential policies and apply the default credentials for a range of devices to be added or imported to DCR. Adding DevicesYou can populate the servers with network devices, either by dynamic discovery, or bulk import. Managing DevicesYou can manage devices in each application after adding them into DCR. Changing ACS SetupYou can configure the ACS mode and assign device groups. Before You Begin Logging into CiscoWorks Assistant Server Setup Home Page CiscoWorks Assistant Server Setup Home Page Viewing the Server Setup Summary

This chapter also contains:


Before You Begin


Before you start using the Server Setup workflow, review the following topics:

About Single-Server and Multi-Server Setups About AAA Mode Related Documentation Implications of DCR and SSO Modes on Server Setup Workflow Navigating Within Server Setup Workflow

User Guide for CiscoWorks Assistant OL-17904-01

3-1

Chapter 3 Before You Begin

Configuring LMS Server Using CiscoWorks Assistant

About Single-Server and Multi-Server Setups

If the CiscoWorks applications are installed on a single LMS server, the setup is considered as a Single-server setup. For large deployments, you may opt to have multiple servers for a single managed network by distributing applications across multiple servers for better performance and scaling. This setup is considered as a Multi-server setup. The Multi-server setup requires the various LMS servers part of the setup work in sync with each other. You will encounter the following terms and concepts while setting up and working on a Multi-server setup:

Peer Server Certificate Setup Peer Server Certificates are used to allow one CiscoWorks server to communicate with another using SSL. In a Multi-server set up you have two or more servers on which CiscoWorks applications are installed. CiscoWorks allows you to add the certificate of another CiscoWorks server (a peer server) into its trusted store.

System Identity Setup Communication between multiple CiscoWorks servers is enabled by a trust model addressed by certificates and shared secrets. System Identity setup should be used to create a trust user on Slave servers to facilitate communication in Multi-server scenarios. This trust user is called System Identity User. The System Identity User is also used for inter-process communication. A default System Identify User admin is created during installation. During the installation, you should provide the password for System Identity user. This password can be different from the password you provide for the admin user used to log in to CiscoWorks. CiscoWorks Assistant allows you to create a System Identity User in all servers that are part of the Multi-server set up. The System Identity User is a Local User with all privileges. The user will automatically be made a Peer Server User too. If the LMS server is in ACS mode, the System Identity User should be present in ACS user data base with Super Admin privileges assigned.

Peer Server Account Setup Peer Server Account Setup helps you create users who can programmatically login to CiscoWorks servers and perform certain tasks. These users should be set up to enable communication between multiple CiscoWorks servers. Peer Server Account can be set up in Common Services.

Device and Credentials Repository (DCR) The DCR lets you manage the device list, and associated credentials and other user-defined device attributes at a single place, in a management domain. In a Multi-server setup, where each server could host one or more LMS application instances, the DCR serves as a single place from where you can manage the device lists and related attributes, for use by all applications in the setup. DCR helps multiple applications share device lists and credentials using a client-server mechanism, with secured storage and communications. The CiscoWorks applications can read or retrieve the information from this repository.
In a Single-server scenario, the DCR would be operating in a Standalone mode (default mode

after installation)
In a Multi-server scenario, user should designate one of the servers as the Master and configure

the other servers in a Slave mode.

User Guide for CiscoWorks Assistant

3-2

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Before You Begin

The Slave servers keep their copy of the DCR data, in sync with the Master DCR. The Master DCR server refers to the master repository of device list and credential data. There is only one Master repository for each management domain, and it contains the most up-to-date device list and credentials. DCR Slaves are slave instances of DCR on other servers and provide transparent access to applications installed on those servers. Any change to the repository data occurs first in the Master with the changes being propagated to all the Slaves. There can be more than one Slave in a management domain but any slave can become a master at any time. In Standalone mode, DCR maintains an independent repository of device list and credential data. It does not participate in a management domain and its data is not shared with any other DCR. It does not communicate with or contain registration information about any other Master, Slave, or Standalone DCR. Devices newly added in DCR can be managed by an application in following ways

Auto Allocation Off modeIn this mode, automatic addition of devices to LMS applications is disabled. This mode allows you to selectively add devices to the application from DCR and add the previously deleted devices back into the application. Auto Allocation - All DevicesIn this mode, all devices in DCR are added to the selected LMS application. Auto Allocation - Allocate by Groups modeIn this mode, devices that belong to a specific group in Common Services are added to LMS applications.

The Single Sign On (SSO) feature helps you to use a single session to navigate to multiple CiscoWorks servers without having to authenticate to each of them. For Single Sign On, one of the CiscoWorks servers needs to be set up as the authentication server. The SSO authentication server is called the Master, and the SSO regular server is called the Slave. If there is no SSO Master server configured in your setup, the local server is selected as SSO Master. You must perform the following tasks if the server is either configured as Master or Slave:

Configure the System Identity User and password in both Master and Slave. The System Identity User name and password you specify in Master and Slave should be the same. Configure Masters Self Signed Certificate in Slave.

About AAA Mode

CiscoWorks provides a robust security mechanism to manage identity and access to the CiscoWorks applications, and data in a multi-user environment. By default, CiscoWorks Server authentication (CiscoWorks Local) is used to authenticate users, and authorize them to access CiscoWorks applications. After authentication, your authorization is based on the privileges that have been assigned to you. A privilege is a task or an operation defined within the application. The set of privileges assigned to you defines your role. It dictates how much, and what type of system access you have.The CiscoWorks Server authorization scheme has pre-defined roles. In this mode, you cannot change the roles, or the privileges assigned to these roles. However, a user can be assigned a combination of these roles. CiscoWorks Server can be integrated with Cisco Secure Access Control Server (ACS) to provide improved access control using authentication, authorization, and accounting (AAA). Cisco Secure ACS provides authentication, authorization, and accounting services to network devices that function as AAA clients. In ACS mode, you can create custom roles to best suit your business workflow and needs. That is, you can create a user, and assign the user with a set of privileges, that would suit your needs.

User Guide for CiscoWorks Assistant OL-17904-01

3-3

Chapter 3 Before You Begin

Configuring LMS Server Using CiscoWorks Assistant

CiscoWorks Assistant helps you in changing the login module of all servers part of the multi-server set up to ACS mode. See Changing ACS Setup for details. See also, Adding Server Details.
Implications of DCR and SSO Modes on Server Setup Workflow

The Server Setup workflow assists you in setting up a Multi-server set up. You can add servers, create System Identity Users, modify the device mode, add and manage devices, and change the AAA mode to ACS using the workflow. If you are installing the CiscoWorks applications for the first time, the setup will be considered as a Single-server setup, and the local host will be displayed in the table. In a Multi-server setup, the Server Setup workflow runs only on the DCR Master server. In Server Setup workflow, the local server will be treated as DCR Master server if the setup is converted from Single-server setup to Multi-server setup. That is, using CiscoWorks Assistant if you add another server to a Standalone server, the DCR mode of the Standalone server to which the new server is added will be changed to Master. A Multi-server setup must have one SSO Master. The other LMS servers must be in SSO Slave mode. If there is no SSO Master server configured in your setup, the local server is set as SSO Master. If the server is already configured for Multi-server setup, CiscoWorks Assistant automatically performs a Server Discovery to collect all the server information in the setup and displays it. Server Discovery runs once every hour. The existing server setup will be discovered when you invoke the CiscoWorks Assistant workflow pages, if the last discovery occurred before 60 minutes. Also, Server Discovery runs at the end of the Manage Server tasks and CiscoWorks Assistant collects all the updated information. If the SSO Master is not reachable, you cannot perform any operation in the Server Setup workflow. Also, if any of the servers is unreachable, you cannot perform the Manage Servers and Change ACS Mode Setup steps.
Navigating Within Server Setup Workflow

If you are starting the workflow for the first time, click Start Setup to enter into the Server Setup workflow. To get back to the initial Server Setup workflow screen from any other screen, click Cancel. If you have operated the workflow earlier, and logged out from the CiscoWorks, or closed the browser after a particular task, you can continue from that task. To do this, click Enter Setup. The links in the Server Setup table-of contents (at the top-left corner of the screen) are disabled after you enter the workflow. After you enter the Server Setup workflow, you can navigate among the available options using the Back, Skip, Next and Cancel buttons.

Back button Takes you to the previous screen. When you click Back, the previous step will not be rolled back. CiscoWorks Assistant does not retain the values you entered previously.

Skip button Allows you to skip a task, and get to the next task. For example, if you want to get to the Default Credential Sets page from the Manage Servers page, without getting into the System Identity User Setup or Device Management mode page, click Skip.

User Guide for CiscoWorks Assistant

3-4

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Logging into CiscoWorks Assistant Server Setup Home Page

Next button Takes you to the screen that is after the current screen. Cancel button Takes you to the initial Server Setup workflow screen from any screens. When the cancel action is performed during the middle of an task or a process, the task or the process will not be terminated, instead it will be executed from background.

CiscoWorks Assistant runs only one instance of Server Setup workflow. You can end an active session of another user if there are no operations running in that session. To end the session, you need to enter the System Identity User details. If any operations are running, you cannot end the session. Also, multiple operations cannot be initiated by the same user, simultaneously. The operation is allowed only after the operation that is in progress is completed. To go to the CiscoWorks Assistant home page click Home.

Logging into CiscoWorks Assistant Server Setup Home Page


Before you start with the Server Setup workflow, read the Before You Begin topic to help you understand the features better. The initial screen for the workflow is the Current System Identity screen. To access the Server Setup workflow,
Step 1 Step 2 Step 3

Enter the system identify username in the Username field. Enter the password relevant to the user specified in the Password field. Click OK. The Server Application List window appears. See CiscoWorks Assistant Server Setup Home Page for details. To go back to the CiscoWorks Assistant home page, click Cancel.

CiscoWorks Assistant Server Setup Home Page


The Server Application List window appears after entering the system identify user details in the Current System Identity screen. Table 3-1 described the fields in the Server Application List window.
Table 3-1 Server Application List Window Details

Field LMS Server Reachability

Description IP Address of the LMS server or Display Name of the LMS server. Reachability status of the LMS server.

User Guide for CiscoWorks Assistant OL-17904-01

3-5

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

When you click the Expand button of the LMS server, a new pane gets added to the Server Application List window. Table 3-2 described the fields in the new pane.
Table 3-2 Application Version Support Details

Field Applications

Description Name of the application installed in the server. This can be any of the following:

Common Services Campus Manager CiscoView RME Integration Utility Internetwork Performance Monitor Health and Utilization Monitor Device Fault Manager

Version Version Supported

Version number of the CiscoWorks application. If the version of the application is supported by CiscoWorks Assistant, a tick mark in green is displayed. For unsupported applications, a cross in red is displayed. You cannot perform any tasks using the workflow on unsupported applications.

You can perform the following Server Setup workflow tasks:


Manage Servers (See Managing LMS Servers) Set Default Credential Sets (See Setting Default Credential Sets) Configure Device Credential Policies (See Configuring Device Credential Policies) Add Devices (See Adding Devices) Manage Devices (See Managing Devices) Change ACS Setup (See Changing ACS Setup)

After you complete the Server Setup workflow, you can view a detailed summary of all the tasks that you have performed during the workflow. See Viewing the Server Setup Summary for details.

Managing LMS Servers


The Manage Servers page displays the CiscoWorks server Details. This page allows you to:

View server details (See Viewing Server Details) Add a server. (See Adding a Server) Set up System Identity User (See Setting up System Identity User) Set up the Device Management mode (See Setting and Editing the Device Management Mode) Allocate desired devices to a group for all CiscoWorks applications (See Allocating Device Groups to CiscoWorks Applications)

User Guide for CiscoWorks Assistant

3-6

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

You can also:


View Server Addition summary (See Viewing Server Addition Summary) View Device Management status (See Viewing Auto Allocation Summary Report) View Server Management status (See Viewing Server Management Status) Edit a server (See Editing Server Details) Delete a server (See Deleting a Server)

Note

All the servers you want add to create the Multi-server set up should be DNS resolvable. If not, you will not be able to add servers.

Viewing Server Details


To view server details:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Manage Servers from the CiscoWorks Assistant home page. The Server Application List table lists the LMS servers. Click Start Setup. The CiscoWorks Server Details table appears with the following details.

Step 2

Hostname/IP AddressHostname or IP Address of the CiscoWorks server. Server Display NameDisplay name you have set up for the LMS server. ProtocolProtocol of the server. This can be HTTP or HTTPS. PortPort number of the CiscoWorks server. Admin UsernameAdmin username for the server. DCRDCR mode of the server. Mode can be DCR Master, Slave, or Standalone. SSOSSO mode of the server. SSO mode can be Master, Slave, or Standalone.

See the User Guide for CiscoWorks Common Services 3.3 for information on DCR and SSO modes.

Adding a Server
To add a server you must:
Step 1

Enter the server details. See Adding Server Details for details. Accept the necessary certificate information. See Accepting Certificate Information for details.

Step 2

User Guide for CiscoWorks Assistant OL-17904-01

3-7

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

Step 3

Configure the SMTP server and the E-mail ID. See Setting up the System for details. Create a trust user on the servers that are part of a Multi- server setup. See Setting up System Identity User for details.

Step 4

After you add a server, you can set up the Device Management mode for all applications (See Setting and Editing the Device Management Mode). This determines whether the devices should be managed by the different applications when they are added to the DCR. You can view a summary of server addition, after you complete the necessary tasks. See Viewing Server Addition Summary for details.

Adding Server Details


To add details to a CiscoWorks server:
Step 1 Step 2

Select CiscoWorks Assistant > Workflows > Server Setup > Manage Servers. Click Add. The Add Server dialog box appears. Enter the following server details:

Step 3

Hostname/IP AddressHostname or IP Address of the CiscoWorks server. If the server you add is in DCR Master mode, or if it is the slave of another DCR master, it will not allow you to add the server. Administrator UsernameAdmin username for the server. Administrator PasswordAdmin username for the server. ProtocolProtocol of the server. This can be HTTP or HTTPS. PortPort Number of the CiscoWorks server.

If the DCR Master (local server) is in ACS mode, you should enter the Network Device Group (NDG) details. CiscoWorks Assistant will convert the server you add here into ACS mode, after the Manage Servers workflow has completed. Select an option Register all installed applications with ACS to register all the installed applications with the ACS Server for the first time. If an application is already registered with ACS, the current registration will overwrite the previous registration. Hence any custom role that has been created in ACS will be lost for those applications. If the server you are adding has already been integrated with another ACS server, it will get integrated to the ACS server to which the DCR Master (local server) is integrated, after the successful completion of Manage Servers step.

User Guide for CiscoWorks Assistant

3-8

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

You must restart the daemon manager in the server that you have added, after the Manage Server process is complete. If you have added multiple servers, you must restart the daemon manager in all of the servers that you have added. If the DCR Master is in CiscoWorks Local mode, you cannot add servers that are in ACS mode.
Step 4

Click Next to continue. The CiscoWorks server is contacted to validate the Device and Credential Repository settings, and to fetch the Certificate information. See Accepting Certificate Information for details.

Accepting Certificate Information


If a CiscoWorks server needs to communicate to another CiscoWorks server, it must possess the certificate of the other server. You can add certificates of any number of peer CiscoWorks servers to the trusted store. For more information on certificates, and importing peer server certificates, see the following sections in the User Guide for CiscoWorks Common Services 3.3:

Creating Self Signed Certificates Setting up Peer Server Certificate

To view and accept the certificate:


Step 1

Click Next, after adding the server details, The Server Setup window appears with the following certificate information.

VersionCertificate version number Serial NumberCertificate serial number Issued ByInformation on the certificate issuing authority. Issued ToInformation about the certificate holder. Effective FromDisplays the date from which the certificate is valid. Expiry DateExpiry date of the certificate SignatureSignature information of the certificate Sign AlgorithmSign algorithm used by the CiscoWorks for the certificate

Step 2 Step 3

Select the Accept Certificate check box. Click Next to continue. The Server Setup window is displayed. You can set the SMTP server and the CiscoWorks E-mail ID to receive e-mails from CiscoWorks server. See Setting up the System for details.

User Guide for CiscoWorks Assistant OL-17904-01

3-9

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

Setting up the System


The Server Setup window allows you to set up the SMTP server, and the CiscoWorks E-mail ID. The SMTP settings in CiscoWorks Assistant are specific to a server. If you change the SMTP settings in DCR master (local server), the SMTP server name and e-mail ID is set in the DCR master (local server) alone. To change the SMTP settings in slaves, you need to go to the individual servers and set up SMTP details.
Step 1

Enter the SMTP server details in the SMTP Server field. This is the system-wide name of the SMTP server used by CiscoWorks applications to deliver reports. The default server name is localhost.

Step 2

Enter the e-mail ID in the CiscoWorks E-mail ID field. This is the CiscoWorks e-mail ID from which applications send e-mail notifications. There is no default e-mail ID. These fields will be already populated if the SMTP server and e-mail ID have been set up in the Common Services > Server > Admin > System Preferences screen or using LMS Setup Center.

Step 3

Click OK.

Viewing Server Addition Summary


The Add Server Summary page provides the following details:

LMS ServerLMS Server name or IP Address Server Display NameDisplay name of the newly added server. DCR SettingsDisplays the current and the new DCR modes of the server.
Current Settings: DCR mode of the server before it was added to the Multi-server set up. New Settings: DCR mode of the server after it was added to the Multi-server set up.

SSO SettingsDisplays the current and the new DCR modes of the server.
Current Settings: SSO mode of the server before it was added to the Multi-server set up. New Settings: SSO mode of the server after it was added to the Multi-server set up.

When you add a server to the existing setup, the added server will become SSO and DCR Slave. However, if you want to make the added server the SSO Master, select the Set as Master check box. CiscoWorks Assistant does not allow you to convert the DCR mode of the added server from Slave to Master because this could result in applications losing data. You can go to the Setting up System Identity User procedure, after you complete the Add Server procedure. To go to the Default Credential Sets Page, click Skip.

User Guide for CiscoWorks Assistant

3-10

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

Editing Server Details


To edit a server:
Step 1 Step 2

Select CiscoWorks Assistant > Workflows > Server Setup > Manage Servers. Select the server by clicking the Host Name/IP Address radio button, and click Edit. The Edit Server dialog box appears. This dialog box has pre-populated values in Hostname/IP address, Protocol, Port and Current SSO Settings fields. All fields in the Edit Server dialog box can be edited, except the Hostname/IP address, Protocol, Port, and Current SSO settings fields.

If the server is in SSO Slave mode, you can change it to SSO Master, by selecting the Set as Master check box. If the server is in SSO Master mode, you can change it to SSO Slave mode by selecting the Set as Slave check box. The Set as Slave check box is not available on the local server.

Step 3 Step 4

Enter the Server Details and Setup parameters in Edit Server dialog box, and click OK. Click Next. The New System Identity User window appears. You can either:

Step 5

Enter the new System Identity Username and Password, confirm Password, and click Next Click Skip to proceed, if you do not want to change the current System Identity User.

Or

The Device Management Mode page appears.


Step 6

Click Next, after you modify the Device Management mode. See for Setting and Editing the Device Management Mode more information. If you do not want to change the settings, click Next when you get to this page without making any modifications to the existing Device Management mode. The Skip button is disabled in this page. The workflow initiates after you click Next. The modifications you made are saved when the tasks are complete.

Deleting a Server
To delete a server from the setup:
Step 1 Step 2 Step 3

Select CiscoWorks Assistant > Workflows > Server Setup > Manage Servers Select the server by clicking the Host Name/IP Address radio button. Click Delete. The Delete Confirmation popup appears. Click OK to delete the selected server. The Marked for Deletion tag appears adjacent to the server you selected in Step 2.

Step 4

User Guide for CiscoWorks Assistant OL-17904-01

3-11

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

Step 5

Click Next. The New System Identity User window appears. You can skip the New System Identity User procedure if you do not want to change the current System Identity User details. To do this, click Skip. The Device Management Mode page appears. Click Next in the Device Management Mode page. You can change the Device Management mode here. This page does not have a Skip button. You need to click Next to proceed with the tasks. The workflow initiates after you click Next. The server marked for deletion will be removed from the set up after the Manage Servers tasks are complete. The Marked for Deletion tag appears only for servers that are already added. If you add a server and delete it immediately after adding it, that is, if you perform the Add Server and the Delete Server tasks in same UI session, the Marked for Deletion tag does not appear in the screen. In this case, the newly added server is not marked for deletion, and is removed from the screen when you click OK in the Delete Confirmation pop-up.

Step 6

Retaining a Server Marked for Deletion

To retain a server marked for deletion:


Step 1 Step 2

Select the server by clicking the Host Name/IP Address radio button. Click Undelete. The Undelete button appears only if you select a server that is marked for deletion. The Undelete Confirmation pop up appears Click OK to retain the server.

Step 3

If you try to add a server that is marked for deletion back to the set up, using the Add button, the Undelete Confirmation pop-up is displayed. Click OK to retain the server in the setup. After the server is deleted from the setup, the deleted server goes into the DCR Standalone and SSO Standalone modes. The workflow also removes the Trust that is set up from all the deleted servers. You cannot remove the local server from the setup. If you remove the SSO Master, you can assign any other server as the SSO Master. If you do not select another server as the SSO Master, the workflow will assign the local server as the SSO Master. If you remove the SSO Master, the Multi-server setup is not removed. You cannot delete the DCR Master. In a Multi-server setup that has two servers, the workflow will remove the Multi-server setup if you remove one of the servers. In such a case, the local server switches to the Standalone mode.

User Guide for CiscoWorks Assistant

3-12

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

Setting up System Identity User


System Identity setup helps you to create a trust user on servers that are part of a Multi-server setup. This user enables communication among servers that are part of a management domain. There can only be one System Identity user for each server. The System Identity user you configure must be a Peer Server user.

In the Non-ACS mode, the System Identity user that you create must be a Local user, with all privileges. In the ACS mode, the System Identity user should be configured in ACS, with Super Admin privileges, in all applications registered in ACS. You can either configure the System Identity User with the predefined Super Admin role or with a custom role created with all privileges in ACS server.

See User Guide for CiscoWorks Common Services 3.3 for more details on System Identity setup. Before you set up the System Identity user, you must add the server. To set up the System Identity user:
Step 1 Step 2

Select CiscoWorks Assistant > Workflows > Server Setup > Manage Servers. Click Next. The New System Identity Setup page appears. If you want to change the System Identity setup values, enter the new System Identity username and password in the text field, re-enter the password in the confirm password field, and click Next to complete the System Identity User setup. CiscoWorks Assistant ensures the new user you create has all the necessary privileges. CiscoWorks Assistant ensures that the new user you create, has all privileges. Otherwise, click Skip.

Setting and Editing the Device Management Mode


The Device Management mode determines whether the new devices are automatically managed by CiscoWorks applications. You have to add your server before you get to this stage. If you are in a Multi-server setup, you must also set up a System Identity user before you begin this task. See the application-specific User Guides to know more about device management modes in different CiscoWorks applications. To set the Device Management mode:
Step 1

Click Next, after adding the server or setting up the System Identity User. The Device Management Mode page appears. The possible device management modes are given in Table 3-3.

User Guide for CiscoWorks Assistant OL-17904-01

3-13

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

Table 3-3

Device Management Modes

Device Management Mode Auto Allocation Off

Description In this mode, automatic addition of devices to LMS applications is disabled. You can use this option to:

Selectively add devices to the application from DCR. Add the previously deleted devices back into the application.

Auto Allocation - All Devices

Auto Allocation - Allocate by Groups

You can manually add the devices to LMS applications even if you have selected other modes for device management. In this mode, all devices in DCR are added to the selected LMS application. This is also limited by the LMS license you have purchased. In this mode, devices that belong to a specific group in Common Services are added to LMS applications. This is also limited by the LMS license you have purchased. You must select a group name for all applications that are on installed on local and peer servers.

By default, the Device Management Mode page in CiscoWorks Assistant shows the current status of the device management mode of applications that have been set up in their respective Device Management Settings pages.
Step 2

Select any of the following modes from the drop down list for each CiscoWorks server application installed on the local server (Standalone mode) or installed on all peer servers (Master-Slave mode):

Auto Allocation Off Auto Allocation - All Devices Auto Allocation - Allocate by Groups

Note

The applications on the peer servers will not be listed when the peer servers are down or if an earlier version of LMS applications is installed on the servers.

Step 3

Click Next. The workflow performs the assigned tasks when you click Next in the Device Management Mode page. The Manage Servers progress page displays the Server Management status and the Manage Server tasks gets completed here. See Viewing Server Management Status for details.

Step 4

If you have selected the Auto Allocation - Allocate by Groups mode for at least one CiscoWorks application, the Auto Allocation page appears. See Allocating Device Groups to CiscoWorks Applications for details.

User Guide for CiscoWorks Assistant

3-14

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

Allocating Device Groups to CiscoWorks Applications


You must assign the device groups to CiscoWorks applications when you have configured the device management mode as Auto Allocation - Allocate by Groups. The Auto Allocation page that appears after the Device Management page helps you to perform this task. The Assign Groups page appears only when at least one CiscoWorks application is configured with Allocate by Groups mode. To assign the device groups to CiscoWorks applications:
Step 1

Click Next after configuring the Device Management mode. The Auto Allocation page appears. It displays:

A list of CiscoWorks applications configured with Auto Allocation - Allocate by Groups mode Group Selector

You can click Refresh to get the latest information (device groups) in Device Group Selector. You can also create new groups or edit groups in the Common Services Group Administration page. To do so, click Group Admin located at the bottom of the Assign Groups page.
Step 2 Step 3 Step 4

Select an application from the list of CiscoWorks applications displayed. You can select only one application at a time. Select a group from the Group Selector. Click Apply to save the changes. To cancel the selection process, click Cancel. Select another application from the list and assign a group from Group Selector. Click Apply to save the changes. Complete assigning groups to all the applications in the list. Click Next. A detailed report containing the device management status is displayed in tabular format. See Viewing Auto Allocation Summary Report for details.

Step 5 Step 6 Step 7 Step 8

User Guide for CiscoWorks Assistant OL-17904-01

3-15

Chapter 3 Managing LMS Servers

Configuring LMS Server Using CiscoWorks Assistant

Viewing Auto Allocation Summary Report


After you have completed assigning device groups to all CiscoWorks applications whose Device Management mode is Auto Allocation - Allocate by Groups, you can see a detailed report of the device management status. To view the Auto Allocation Report:
Step 1

Click Next on the Auto Allocation page. The Auto Allocation Summary Report appears with the details given in Table 3-4.
Table 3-4 Auto Allocation Summary Report

Field Server Application

Description Name of local or remote CiscoWorks Server. Name of the application in local or peer CiscoWorks Server managing the devices. Number of Devices Currently Number of devices managed by the application before the auto Managed allocation of devices to groups. Number of New Devices After Number of new devices managed by the application after the auto This Rule Change allocation of devices to groups. Number of Devices Deleted Number of devices deleted and not managed by the application after After This Rule Change the auto allocation of devices. This field is applicable only for Campus Manager. This displays NA for the rest of CiscoWorks Applications. Total Number of Devices After Total number of devices managed by the application after the auto This Rule Change allocation of devices. Current License Limit Number of devices that the LMS License allows the application to manage.
Step 2

Click Next to view the Server Management Status.

User Guide for CiscoWorks Assistant

3-16

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing LMS Servers

Viewing Server Management Status


The Manage Servers progress page that appears after you complete the Device Management mode and Group Assignment setup, displays the status of the Manage Server tasks that you have performed. For information on setting up Device Management mode, see Setting and Editing the Device Management Mode. To view the Manage Severs tasks status:
Step 1

Select the Device Management mode and click Next. The Manage Servers Progress page appears. This process takes some time to check the status of various tasks. You can either:

Set up CiscoWorks Assistant to send you an e-mail notification. You can then exit from the workflow before the tasks are complete. You can view the status after you get an e-mail notification that the tasks have completed. See Setting up E-mail Notification After Managing Server Tasks for details.

Or

Wait until the status check has completed to view the status. System Identity user validation. New System Identity user creation, if you have added new System Identity User values. Trust removal from all deleted CiscoWorks servers, if you have deleted any servers. Trust creation for the newly added server by the System Identity setup configuration and certificate addition. Configuring new System Identity user on all servers. Configuring SMTP Server and e-mail. Device Management mode configuration. DCR mode configuration. If you add a Standalone server, it is converted into the Slave of the local server.
In a Single-server scenario, if you add a new server, the local server is made the Master, and the

The status on the following is displayed:


newly added server is made the Slave.


In a Multi-server set up, the newly added server is made the Slave of the DCR Master. If the

local server (DCR Master) is in ACS mode, the AAA mode of the added server is set as ACS.
Step 2

SSO Mode change, if you have changed the SSO mode. Server Discovery step to update the CiscoWorks Assistant database. Groups allocated for all applications, when the Auto Allocation - Allocate by Groups option is selected.

Click on the relevant step link to view the detailed status report for that step. If a step fails, the Last Accessed URL column in the report will display the shortcut URL for that particular step. It will not display anything, if the step is successful.

User Guide for CiscoWorks Assistant OL-17904-01

3-17

Chapter 3 Setting Default Credential Sets

Configuring LMS Server Using CiscoWorks Assistant

Setting up E-mail Notification After Managing Server Tasks

You can exit the workflow after you complete the tasks and return later to view the status. You should do this after getting an e-mail notification. To do this:
Step 1 Step 2

Select the Notify me when Manage Servers Tasks are Complete check box, and click OK. Enter the e-mail ID in the text field. The e-mail ID will be displayed in the text field if you had entered an e-mail ID in the Manage Servers flow. Otherwise, the default e-mail address YourName@YourDomainName.com is displayed. Only one e-mail ID is allowed. The e-mail ID can contain alphabets, numbers, and special characters ($, _, ^, &, #). For example:

user_cwa1@cisco.com Name_12#@abc.co.in

The following message appears:


An e-mail will be sent to the selected E-mail address after the process has completed.

Step 3

Click Cancel. The initial Server Setup workflow page is displayed. You will receive an e-mail after the tasks have completed. Click Enter Setup to view the Manage Server status page after you receive the e-mail notification.

Step 4

Setting Default Credential Sets


DCR manages the details of multiple default credential sets. Each Default credential set comprises of the components listed below. The Default credential set can be associated with the each device while adding or importing devices into DCR. Each default credential set comprises:

Primary Credentials (Username, Password, Enable Password) Secondary Credentials (Username, Password, Enable Password) Rx Boot Mode Credentials (Username, Password) SNMPv2c/SNMPv1 Credentials (Read-Only Community String, Read-Write Community String) SNMPv3 Credentials (Mode, Username, Authentication Password, Authentication Algorithm, Privacy Algorithm, Privacy Password) HTTP credentials (Primary HTTP Username and Password, Secondary HTTP Username and Password, HTTP/HTTPS port, Current Mode) Auto Update Server Managed Device Credentials (Username and Password)

The recommended multiple default credential sets configurations are set to 50 default credential sets. You can use the default credentials for devices and edit their credentials appropriately. You can configure the default credentials and use them in the applications. Similar to Common Services, if the default credentials cannot be accessed from DCR, CiscoWorks Assistant will not assign the credentials.

User Guide for CiscoWorks Assistant

3-18

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Setting Default Credential Sets

All the credential information will be populated from the DCR Master. If the credentials are already available in DCR database, they will be updated by the new values you enter, after setting default credentials. To set the device credentials:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Default Credential Sets. The Default Credential Sets page appears. You can:

Add Credential Set Name (See Adding Credential Set Name) Set Standard credentials (See Setting Standard Credentials) Set SNMP credentials (See Setting SNMP Credentials) Set HTTP credentials (See Setting HTTP Credentials) Set Auto Update Server managed Device Credentials (See Setting Auto Update Server) Set Rx Boot Mode credentials (See Setting Rx Boot Mode Credentials)

Step 2

Click Next to complete the Credentials Settings. The Credential Sets Progress page appears. This page provides the status of the Credential Sets tasks. See Viewing Credential Sets Status.

Adding Credential Set Name

To add the Credential Set name:


Step 1

Click Credential Set Name in the Default Credential Sets page. The Credential Set page appears. Select Add New from the Credential Set drop-down list. Enter the name of the credential set in the Credential Set Name field. This is mandatory. The specified name will be appended with the screen name. Specify the credential set name with the constrains listed below:

Step 2 Step 3

Alphabets A-Z and a-z Numbers 0-9 Special Characters -, _, .

Step 4 Step 5

Enter the credential set description in the Set Description field. Select a credential type from the Default Credentials list panel and enter the respective credential information. You can select any of these credential types from the panel.

Standard Credentials SNMP Credentials HTTP Credentials Auto Update Server Managed Device Credentials Rx-Boot Mode Credential

User Guide for CiscoWorks Assistant OL-17904-01

3-19

Chapter 3 Setting Default Credential Sets

Configuring LMS Server Using CiscoWorks Assistant

Step 6

Enter the following credentials as required:


Standard Credentials (See Setting Standard Credentials) SNMP Credentials (See Setting SNMP Credentials) HTTP Credentials (See Setting HTTP Credentials) Auto Update Server Managed Device Credentials (See Setting Auto Update Server) Rx-Boot Mode Credential (See Setting Rx Boot Mode Credentials)

You must enter a value for at least one credential before applying the default credentials.
Step 7

Click Apply to apply the credential set details in Common Services. You can also apply the changes by clicking Next. To cancel the changes, click Cancel. To delete a default credential set, click Remove. A delete confirmation popup appears.

Setting Standard Credentials

To set Standard credentials:


Step 1

Click Standard Credentials in the Default Credential Sets page. The Standard Credential page appears. Add the following credentials:

Step 2

Primary credentials (Username, Password, Enable Password) Secondary credentials (Username, Password, Enable Password)

Step 3

Re-enter the passwords in the Verify fields.

Setting SNMP Credentials

To set SNMP credentials:


Step 1

Click SNMP Credentials in the Default Credential Sets page. The SNMP Credential page appears. Add the following credentials:

Step 2

SNMPv2c/SNMPv1 credential SNMPv3 credential

You must select the SNMPv3 checkbox to enter the SNMPv3 Credentials. By default, these fields are disabled.
Step 3

Enter the Read-Only Community String and Read-Write Community String for SNMPv2c/SNMPv1 credentials.

User Guide for CiscoWorks Assistant

3-20

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Setting Default Credential Sets

Step 4

Select any one of the following security levels in the Mode field for SNMPv3 credentials.

NoAuthNoPriv AuthNoPriv AuthPriv

You can enter the SNMPv3 credentials based on the selected mode.
Step 5 Step 6

Enter the Authentication Username and Authentication Password. Select an Authentication Algorithm from the drop-down list. The Authentication Algorithm field value can be MD5, SHA-1, or None. Enter the Privacy password. Select a Privacy algorithm from the drop-down list. The Privacy Algorithm field value can be DES, 3DES, AES128, AES192, AES256, or None. Re-enter the passwords in the Verify fields.

Step 7 Step 8

Step 9

Setting HTTP Credentials

To set HTTP credentials:


Step 1

Click HTTP Credentials in the Default Credential Sets page. The HTTP Credential page appears. Add the following credentials:

Step 2

Primary credential Secondary credential

Step 3 Step 4 Step 5

Enter the username and passwords for Primary and Secondary credentials. Re-enter the passwords in the Verify fields. Enter:

HTTP Port HTTPS Port

Step 6

Select either HTTP, HTTPS, or None from the Current Mode drop-down list.

Setting Auto Update Server

To set Auto Update Server Managed Device credentials:


Step 1

Click Auto Update Server Managed Device Credentials in the Default Credential Sets page. The Auto Update Server Managed Device Credential page appears. Enter the username and password. Re-enter the password in the Verify field.

Step 2 Step 3

User Guide for CiscoWorks Assistant OL-17904-01

3-21

Chapter 3 Setting Default Credential Sets

Configuring LMS Server Using CiscoWorks Assistant

Setting Rx Boot Mode Credentials

To set Rx Boot Mode credentials:


Step 1

Click Rx Boot Mode Credentials in the Default Credential Sets page. The Rx Boot Mode Credentials page appears. Enter the username and password. Re-enter the password in the Verify field.

Step 2 Step 3

Editing a Default Credential Set


To edit a default credential set,
Step 1

Click Credential Set Name in the Default Credential Sets page. The Credential Set page appears. Select an existing credential set which needs to be edited, from the Credential Set drop-down list. The details relevant to the selected credential set will be displayed for editing. Specify the credential set name with the constrains listed below:

Step 2

Alphabets A-Z and a-z Numbers 0-9 Special Characters -, _, .

Step 3

Edit the required details, by selecting relevant credential type from the Default Credentials list panel. The available credentials details are:

Standard Credentials SNMP Credentials HTTP Credentials Auto Update Server Managed Device Credentials Rx-Boot Mode Credential

Step 4

Click Apply to apply the changes in Common Services. You can also apply the changes by clicking Next. To cancel the changes, click Cancel.

User Guide for CiscoWorks Assistant

3-22

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Setting Default Credential Sets

Viewing Credential Sets Status


To view the Credential Sets status:
Step 1

Click Next after entering the credentials. The Credential Sets Progress page is displayed. This process takes some time to check the status of various tasks. You can either:

Set up CiscoWorks Assistant to send you an e-mail notification. You can then exit from the workflow before the tasks are complete. You can view the status after you get the e-mail notification that the task have completed. You should do this after getting an e-mail notification.

Or
Step 2

Wait until the status check has completed to view the status.

Click on the relevant step link to view the detailed status report. If a step fails, the Last Accessed URL column in the report will display the shortcut URL for this step. It will not display anything, if the step is successful. See User Guide for CiscoWorks Common Services 3.3 for more information on Default Credentials. Click Next to go to the Configuring Device Credential Policies step. See Configuring Device Credential Policies for details. You can exit the workflow after you complete the tasks and return later to view the status. You should do this after getting an e-mail notification. You will receive an e-mail notification only if you have configured the e-mail address. See Setting up E-mail Notification After Managing Server Tasks for details.

Step 3

User Guide for CiscoWorks Assistant OL-17904-01

3-23

Chapter 3 Configuring Device Credential Policies

Configuring LMS Server Using CiscoWorks Assistant

Configuring Device Credential Policies


You can configure device credential policies and apply the credentials for a range of devices to be added or imported to DCR. The recommended device credentials policy configurations are set to 50. You can create device credential policies based on the following policy types:

IP Address Hostname Display Name

To configure a device credentials policy:


Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Device Credentials Policy Configuration. The Device Credentials Policy Configuration page appears. You can:

Add a device credentials policy (See Adding a Device Credentials Policy) Edit a device credentials policy (See Editing a Device Credentials Policy) Delete a device credentials policy (See Deleting a Device Credentials Policy) Define the order of device credential policies (See Defining the Order of Device Credential Policies)

Step 2

Click Next to complete the device credentials policy configuration. The Device Credentials Policy Configuration Progress page appears. This page provides the status of the policy configuration. See Viewing Device Credentials Policy Configuration Status.

Adding a Device Credentials Policy


To add a new device credentials policy:
Step 1

Click Add in Device Credentials Policy Configuration page to add a device credentials policy. The Add Device Credentials Policy Configuration dialog box appears. Construct a rule expression. To do so:
a.

Step 2

Select a parameter from the Select a Policydrop-down list. The listed parameters are IP Range, Hostname and Display Name. Enter a value for the selected rule parameter in the text field. Examples are provided with the relevant Online help link below, based on the selection made.

b.

User Guide for CiscoWorks Assistant

3-24

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Configuring Device Credential Policies

See the following sections in the Administering Device and Credential Repository of Managing Device and Credentials chapter in User Guide for CiscoWorks Common Services 3.3 for more details:
Patterns in IP Address Default Credential Set Policy Rules Regular Expressions in Default Credential Set Policy Rules

http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html
c. Step 3

Select a default credential set name or No Default from the Credential Set drop-down list.

Click OK to go back to Device Credentials Policy Configuration page. The policy that you have configured is listed in the Device Credentials Policy Configuration page. To close the Add Device Credentials Policy Configuration dialog box, click Cancel. Click Next to apply the device credential policies. The Device Credentials Policy Configuration Progress page appears. See Viewing Device Credentials Policy Configuration Status.

Step 4

Editing a Device Credentials Policy


To edit a device credentials policy:
Step 1 Step 2

Select a policy in the Device Credentials Policy Configuration page. Click Edit. The Edit Device Credentials Policy Configuration dialog box appears. This dialog box has pre-populated values. Edit the required details in the Edit Device Credentials Policy Configuration dialog box. Click OK to go back to Device Credentials Policy Configuration page. The policy that you have edited is listed in the Device Credentials Policy Configuration page. To close the Edit Device Credentials Policy Configuration dialog box, click Cancel. Click Next to apply the device credential policies. The Device Credentials Policy Configuration Progress page appears. See Viewing Device Credentials Policy Configuration Status.

Step 3 Step 4

Step 5

Deleting a Device Credentials Policy


To delete a device credentials policy:
Step 1 Step 2

Select a policy in the Device Credentials Policy Configuration page. Click Delete. The Delete Confirmation popup appears.

User Guide for CiscoWorks Assistant OL-17904-01

3-25

Chapter 3 Configuring Device Credential Policies

Configuring LMS Server Using CiscoWorks Assistant

Step 3 Step 4

Click OK to delete the selected policy. Click Next to apply the changes. The Device Credentials Policy Configuration Progress page appears. See Viewing Device Credentials Policy Configuration Status.

Defining the Order of Device Credential Policies


To specify the order of device credential policies:
Step 1 Step 2

Select a policy in the Device Credentials Policy Configuration page. Click either:

The Up Arrow icon to move the selected device credentials policy up in the displayed order The Down Arrow icon to move the selected device credentials policy down in the displayed order.

or
Step 3

Click Next to apply the changes. The default credential set policies are applied in the order they appear on the Credentials Sets Policy Configuration page. The default credential set policies appearing at the top of the list are applied first. The Device Credentials Policy Configuration Progress page appears. See Viewing Device Credentials Policy Configuration Status.

See Administering Device and Credential Repository section in the Managing Device and Credentials chapter of the User Guide for CiscoWorks Common Services 3.3 for more information on Defining the Order of Device Credential Policies: http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html

Viewing Device Credentials Policy Configuration Status


To view the Device Credentials Policy Configuration status:
Step 1

Click Next after adding or editing device credentials policy. The Device Credentials Policy Configuration Progress page is displayed. You can either:

Set up CiscoWorks Assistant to send you an e-mail notification. You can then exit from the workflow before the tasks are complete. You can view the status after you get the e-mail notification that the tasks have completed. See Setting up E-mail Notification After Managing Server Tasks for details.

Or
Step 2

Wait until the status check has completed to view the status.

Click on the relevant step link to view the detailed status report.

User Guide for CiscoWorks Assistant

3-26

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

If a step fails, the Last Accessed URL column in the report displays the shortcut URL for that particular step. It will not display anything, if the step is successful.
Step 3

Click Next to go to the Adding Devices step. See Adding Devices for details.

Adding Devices
You can add devices to the Device and Credentials Repository (DCR) using the following methods:

Bulk Import from File (See Adding Devices Using Bulk Import From File) Bulk Import from Network Management Station (NMS) (See Adding Devices Using Bulk Import From NMS) Common Services Device Discovery (See Adding Devices Using Common Services Device Discovery)

CiscoWorks Assistant allows you to add devices using multiple methods, simultaneously. You can add devices using the Import from File feature, Import from NMS, and Common Services Device Discovery at the same time. You can also:

View Add Devices Status (See Viewing Add Devices Status) Set SNMP Parameters (See Setting SNMPv2 Parameters and Setting SNMPv3 Parameters) Delete SNMP Details (See Deleting SNMPv2 Details and Deleting SNMPv3 Details) Select CiscoWorks Assistant > Workflows > Server Setup > Add Devices Or Select Manage Servers, and continue in the wizard mode.

To add devices you can either:

Adding Devices Using Bulk Import From File


To import from a file:
Step 1

Select the Import From File check box from the Select Methods pane, and click the Import From File link. The File Information pane appears. This is the default. Enter the file name. Or
a.

Step 2

Click Browse The Server Side File selector dialog box appears. Select the filename.

b.

The Server Side File Selector dialog box displays the files on the remote server on which the Server Setup workflow is running.
Step 3

Select either CSV or XML file formats.

User Guide for CiscoWorks Assistant OL-17904-01

3-27

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Only CSV 2.0 and CSV 3.0 file formats are supported. See the User Guide for CiscoWorks Common Services 3.3 for sample CSV and XML files.
Step 4

Select either the Use data from Import source or the Use data from Device and Credential Repository. This is to resolve conflicts that may occur if the devices are present both in the import source and DCR, but differ in their attributes.

If you select Use data from Import source, the credentials from the import source will be used, and credentials for the device in DCR will be modified. If you select Use data from Device and Credential Repository, the device credentials in DCR will be used. default credential set name Policy Configuration No Default

Step 5

Select any one of the following from the Select A Default Credential Set drop-down list.

Adding Devices Using Bulk Import From NMS


To import from NMS:

Select CiscoWorks Assistant > Workflows > Server Setup > Add Devices Or Select Manage Servers and continue in the wizard mode.

The NMS Information screen appears. You can do a bulk import either from:

Local NMS (See Performing Bulk Import From Local NMS) Or Remote NMS (See Performing Bulk Import From Remote NMS)

Performing Bulk Import From Local NMS

To perform a bulk import from Local NMS:


Step 1 Step 2 Step 3

Select the Import From NMS check box from the Select Methods pane, and click the Import From NMS link. Select the Network Management System type from the NMS type drop-down list. HPOV and Netview are supported. Enter the installation location of Network Management System in the Install Location field. For example: C:\Program Files\HP OpenView

User Guide for CiscoWorks Assistant

3-28

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

Step 4

Select either Use data from Import source or Use data from Device and Credential Repository This is to resolve conflicts that may occur if the devices are present both in the import source and DCR, but differ in their attributes.

If you select Use data from Import source, the credentials from the import source will be used, and credentials for the device in DCR will be modified. If you select Use data from Device and Credential Repository, the device credentials in DCR will be used. default credential set name Policy Configuration No Default

Step 5

Select any one of the following from the Select A Default Credential Set drop-down list.

Performing Bulk Import From Remote NMS

To do a bulk import from Remote NMS:


Step 1 Step 2 Step 3 Step 4 Step 5

Select the Import From NMS check box from the Select Methods pane, and click the Import From NMS link. Select the Remote NMS check box. Select the Network Management System type from the NMS type drop-down list. HPOV, Netview and ACS are supported. Select the Operating System type from the OS type drop-down list. Enter the host name, root username, and install location in the corresponding fields. If you select the NMS type as ACS, enter the root password, port and protocol along with the hostname and root username in the corresponding fields.

Step 6

Select either Use data from Import source or Use data from Device and Credential Repository This is to resolve conflicts that may occur if the devices are present both in the import source and DCR, but differ in their attributes.

If you select Use data from Import source, the credentials from the import source will be used, and credentials for the device in DCR will be modified. If you select Use data from Device and Credential Repository, the device credentials in DCR will be used. default credential set name Policy Configuration No Default

Step 7

Select any one of the following from the Select A Default Credential Set drop-down list.

User Guide for CiscoWorks Assistant OL-17904-01

3-29

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Adding Devices Using Common Services Device Discovery


To run Discovery:

Select CiscoWorks Assistant > Workflows > Server Setup > Add Devices. Or Select Manage Servers and continue in the wizard mode. The Add Devices page appears. This page contains the Run Discovery check box for each server.

To specify Device Discovery Settings:


Step 1

Select the Run Discovery on host_name check box, and click the Run Discovery on host_name link. The Discovery window appears with the following tabs.

Discovery Module Tab Seed Devices Tab SNMP Settings Tab Filter Settings Tab Global Settings Tab

Step 2

Enter the following details to specify the Discovery settings. For more information, see the User Guide for Common Services 3.3 on the Discovery Settings.
Discovery Module Tab

The following are the various protocols and options in the Discovery module: Table 3-5 displays the Layer 3 Discovery Protocols.
Table 3-5 Layer 3 Discovery Protocol

Field Address Resolution Protocol (ARP) Border Gateway Protocol (BGP)

Description Internet Protocol that maps IP Address to a MAC address Exterior gateway protocol. This protocol uses Border Gateway Peer Table to identify its BGP peer.

Open Shortest Path First Protocol (OSPF) Routing Table

Interior gateway routing protocol. Queries and analyzes routing tables on seed routers, and discovers the subnets and next-hop routers.

Table 3-6 displays the Layer 2 Discovery Protocol.


Table 3-6 Layer 2 Discovery Protocol

Field Cisco Discovery Protocol

Description Discovers devices independent of media and protocol used. This protocol runs on all Cisco-manufactured equipment, including routers, access servers, bridges, and switches.

User Guide for CiscoWorks Assistant

3-30

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

Table 3-7 displays the Ping Discovery options.


Table 3-7 Ping Discovery Options

Field Ping Sweep On IP Range

Description Gets a list of IP Address ranges from Discovery configuration and pings each IP Address starting from the seed devices, to check the reachability of devices.

Table 3-8 displays the Cluster Discovery and Hot Standby Router Protocol module details.
Table 3-8 Cluster Discovery and Hot Standby Router Protocol Modules

Field Cluster Discovery Module

Description Discovers the devices in a DSBU cluster. This queries the Cluster MIB to discover all members of the cluster.

Hot Standby Router Protocol (HSRP)

Discovers the devices from the HSRP group which consists of an active router and Standby routers. If the active router fails, one of the Standby router will server as an active router.

Seed Devices Tab

Seed devices are the devices used to initiate network Discovery. A seed device is the starting point from which Common Services Device Discovery discovers the network and its peer or neighbor devices. The following module specific details are displayed in the Seed Devices tab. These modules are displayed based on the selection in the Discovery Module tab.

Address Resolution Protocol Border Gateway Protocol Open Shortest Path First Protocol Routing Table Cisco Discovery Protocol Ping Sweep On IP Range Cluster Discovery Hot Stand by Router Protocol

To add seed devices from this tab:


Step 1

Click Module Specific or Global from the Seed devices panel at the left. The list of modules selected in the Module Settings page is displayed if you have selected Module Specific.

Step 2

Select a module from the list of displayed modules. The Module Specific or Global Seed Devices settings appears at the right.

User Guide for CiscoWorks Assistant OL-17904-01

3-31

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Step 3

Enter the name of the file with its full path in the From File field, if you want to specify the seed devices from a file. If you do not know the path, you can click Browse and select a file from the list. Select Use DCR As Seed List, if you want to specify the devices in DCR as seed devices. This option is not available for the Ping Sweep On IP Range option. You must enter the credentials mentioned in Step 6.

Step 4

Step 5

Select Jump Router Boundaries to extend Discovery beyond the boundaries set by routers on your network. This option is available only for CDP Module. You must be cautious about enabling Discovery to occur beyond router boundaries. This is because Discovery could take much longer if you do not selectively choose the boundaries by excluding specific IP addresses.

Step 6

Enter the following fields which appears only for Ping Sweep On IP Range Discovery module.

ICMP Retry No of retries to connect to a device using ICMP protocol if the device is not reachable or network is down. The default is 1 retry. ICMP Timeout Time within which the device should send its response to the network. The default timeout is 1000 milliseconds. InterPacket TimeoutTime delay between two ICMP packets. The default timeout is 20 milliseconds. Click Add to add a new row. Enter the IP Address or hostname of the seed device in the Seed Device field. Enter the number of hops in the Hop Count field. This field is available for all Discovery modules except Ping Sweep On IP Range. Hop count limits the scope of Device Discovery. Device Discovery cycle may take a longer time if you enter a greater value of hop count. You must enter values greater than 1 as hop count. Enter the Subnet Mask in the Subnet Mask field. The default value is 255.255.255.255. This field is available only for Ping Sweep On IP Range Discovery module.

Step 7

Perform the following if you want to specify the seed devices manually:
a. b. c.

d.

If you enter a smaller Subnet Mask value, it may result in a longer Discovery cycle because Discovery has to sweep IP Addresses from more networks. The addresses in the Seed Device and Subnet Mask fields also support IPv6. You can also do the following:

To add more seed devices, click Add to introduce more rows and enter the seed devices. To delete seed devices, select the checkboxes corresponding to the seed devices and click Delete.

SNMP Settings Tab

You can configure SNMP credentials to run Device Discovery. You must configure either SNMPv2 or SNMPv3 credentials by selecting the appropriate radio buttons.

If you have selected the SNMPv2 radio button, you can select SNMPv2c fallback to SNMPv1. If you have selected the SNMPv3 radio button, you can select SNMPv3 fallback to SNMPv2c.

User Guide for CiscoWorks Assistant

3-32

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

You must configure the respective protocols to enable the fallback options. For example, to fallback to SNMPv2c from SNMPv3, you should have configured SNMPv2c settings. Table 3-9 displays the SNMPv2 details.
Table 3-9 SNMPv2 Credentials

Field SNMP Version Target

Description Displays the SNMP version Denotes the target device. Enter the IP Address of the target device. You can also use wildcard characters to specify the target device. For example, you can enter 2001:*:*:*:*:*:*:* as the target device. Entering a target device is mandatory.

Read Community Time Outs

SNMP Read Community string of the device. Entering the read community string is mandatory Time period after which the SNMP query times out. You must enter the timeout value in seconds. The default value of timeout is 3 seconds. The Discovery time may increase if you specify a larger value for timeout. The timeout doubles for every retry. For example, if the timeout value is 5 seconds and number of retries is 3. Common Services Device Discovery waits for 5 seconds to get the response from the device for the first try, 10 seconds for second retry, and 20 seconds for last retry. Common Services Device Discovery stops querying the device after three retries and the time lapses by 35 seconds.

Retries

Number of attempts made to query the device. You can specify any value between 0 to 8 as number of retries. The default number of retries is 2. You can enter any remarks in this field.

Comments

Table 3-10 displays the SNMPv3 field details.


Table 3-10 SNMPv3 Credentials

Field Target

Description Target device. Enter the IP Address of the target device. You can also use wildcard characters to specify the target device. For example, you can enter 2001:*:*:*:*:*:*:* as the target device. Entering a target device is mandatory

User Name

SNMPv3 username used to access the device

User Guide for CiscoWorks Assistant OL-17904-01

3-33

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Table 3-10

SNMPv3 Credentials

Field Auth Password Auth Algorithm

Description SNMP V3 authentication password used to operate the devices in AuthNoPriv and AuthPriv modes. SNMP V3 authentication algorithm used in AuthNoPriv and AuthPriv modes. The authentication algorithm can be MD5 or SHA-1. SNMP V3 privacy password of the device in AuthPriv mode. SNMP V3 privacy algorithm used in AuthPriv mode. The privacy algorithm can be DES, 3DES, AES128, AES192, and AES256.

Privacy Password Privacy Algorithm

Timeout

Time period after which the SNMP query times out. You must enter the timeout value in seconds. The default value of timeout is 3 seconds. The discovery time may increase if you specify a larger value for timeout. The timeout doubles for every retry. For example, if the timeout value is 5 seconds and number of retries is 3. Common Services Device Discovery waits for 5 seconds to get the response from the device for the first try, 10 seconds for second retry, and 20 seconds for last retry. Common Services Device Discovery stops querying the device after 3 retries and the time lapses by 35 seconds.

Retries

Number of attempts made to query the device. You can specify any value between 0 to 8 as number of retries. The default number of retries is 2.

Comments

You can enter any remarks in this field.

User Guide for CiscoWorks Assistant

3-34

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

Filter Settings Tab

Filters allow you to include or exclude devices from the network. For more information on Filters, see Configuring Discovery Filter Settings section in the User Guide for Common Services 3.3. You can select a filter from the Use Filter drop-down list. The supported filters are:

IP Address DNS Domain SysObjectID SysLocation

You can either include or exclude a filter by selecting either the Include or Exclude radio buttons. From the filter settings you can Add and Delete a Filter. To add a filter:
Step 1

Select a filter from the Use Filter drop-down list. IP Address is the default filter. The address also supports IPv6. Select either the Include or Exclude radio button. Enter the filter in the field corresponding to the Add button. For SysObjectID filter, you can either enter the value manually or select a SysObjectID from the Device Type Selector. The Device Type Selector appears after you have selected a SysObjectID filter from the Use Filter drop-down list.

Step 2 Step 3

Step 4

Click Add. The filter is added into the Added List field.

To delete the filter, select the filter from the Added List and click Delete.

User Guide for CiscoWorks Assistant OL-17904-01

3-35

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Global Settings Tab

In the Global Settings tab, you can view the details shown in Table 3-11.
Table 3-11 Global Settings Tab Details

Field Preferred DCR Display Name

Description You can set the display name of the discovered devices in DCR as any one of the following:

IP AddressPreferred management IP Address of the device. HostnameDNS resolvable name of preferred management IP Address. This is the default option. FQDN Fully Qualified Domain Name consisting of a hostname and a domain name.

Select the appropriate radio button in the Preferred DCR Display Name panel. When you select the preferred management IP Address as None:

Hostname of the device is added as the display name in DCR. Device interface addresses are also added as separate devices in DCR.

Update DCR Display Name

Select this checkbox if you want to update the display name of the devices that already exist in DCR, in the next Device Discovery cycle. For example, consider a device that is discovered by Common Services Device Discovery, exists in DCR with the display name as its hostname. If you change the Preferred DCR Display Name to IP Address for the next Device Discovery, Common Services Device Discovery will update the display name of the device as its IP Address in DCR after the next Device Discovery. The display name of devices are not overwritten in the future Discovery cycles if you have not selected this option.

Use Default Credentials

Select either default credential set name, Policy Configuration or No Default from the Select A Default Credential Set drop-down list, while adding the devices to DCR.

User Guide for CiscoWorks Assistant

3-36

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

Table 3-11

Global Settings Tab Details

Field Preferred Management IP

Description Select one of the following options as preferred Management IP address of the device:

Use LoopBack Address Select this option to manage a device in the address assigned to the loopback interface. If there are multiple loopback IP addresses, the highest loopback address is used to manage the device.

Resolve By Name Common Services Device Discovery uses Domain Name Services (DNS), if available, to perform device name lookups. Select this option to resolve names using the device name. Resolve By SysName Select this option to contact the DNS Server to select the device hostname. None Select this option if you do not want to manage the devices with preferred management IP Address. When you select this option, the devices are added in DCR with their IP Addresses.

Add Discovered Devices to a Group You can later select the devices in this group to perform device operations. Displays the name of the group you have selected already. Group Name You can also change the group name.

The Resolve By Name option is the default option for this field. Select this checkbox when you want to add the discovered devices to a group.

Click Select to open the Select a Group popup window and change the group name. In the Select a Group popup window, you can either specify a new group name or select an existing group from the list of user-defined groups. Enter a valid e-mail ID in this field. Multiple e-mail IDs are allowed in this field. The system uses the e-mail ID to notify you about:

E-mail

Completion status of Device Discovery jobs. Stopped Device Discovery jobs

Caution

There may be a problem in sending e-mails if you enable virus scanner in the CiscoWorks Server.

User Guide for CiscoWorks Assistant OL-17904-01

3-37

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Setting SNMPv2 Parameters


To add or edit SNMPv2 parameters:
Step 1 Step 2 Step 3

Select Run Discovery on the host_name check box, and click the Run Discovery on the host_name link. Click the SNMP Settings tab. Select the SNMPv2c radio button. You can select the SNMPv2c to SNMPv1 Fallback check box, to enable fallback to SNMPv1 from SNMPv2c.

Step 4

Click Add to add the SNMP settings. The SNMP V2 popup appears. Enter the following details in the popup:

Step 5

TargetTarget device Read CommunityRead community string. TimeoutsTime period after which the query times out. RetriesNumber of attempts. CommentsRemarks, if any. OK to save the changes Cancel to exit.

Step 6

Click either

Or
Step 7

Select a row, and click Edit to edit the community strings. The SNMPv2 popup appears with the existing values. Edit the details in the popup and click either:

Step 8

OK to save the changes Cancel to exit.

Or
Step 9

Select a row, and click Delete to delete the community string.

Setting SNMPv3 Parameters


To add or edit SNMPv3 parameters:
Step 1 Step 2

Select Run Discovery on host_name check box, and click the Run Discovery on host_name link. Click the SNMP Settings tab.

User Guide for CiscoWorks Assistant

3-38

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Adding Devices

Step 3

Select the SNMPv3 radio button. You can select the SNMPv3 to SNMPv2c Fallback check box, to enable fallback to SNMPv2c from SNMPv3. You should have configured SNMPv2c settings, to enable fallback to SNMPv2c from SNMPv3.

Step 4

Click Add to add the SNMP settings. The SNMPv3 popup appears. Enter the following details in the popup window:

Step 5

TargetTarget device. UsernameName of the user who has access to the views configured on the device. PasswordPassword of the user. TimeoutsTime period after which the query times out. RetriesNumber of attempts. AuthenticationMethod of authentication. Either SHA-1 or MD5. CommentsRemarks, if any. OK to save the changes. Cancel to exit.

Step 6

Click either:

Or
Step 7

Select a row, and click Edit to edit the community strings. The SNMPv3 popup appears with the existing values. Edit the details in the popup and click either:

Step 8

OK to save the changes. Cancel to exit.

Or
Step 9

Select a row, and click Delete to delete the community string.

User Guide for CiscoWorks Assistant OL-17904-01

3-39

Chapter 3 Adding Devices

Configuring LMS Server Using CiscoWorks Assistant

Viewing Add Devices Status


To view the Add Devices status:
Step 1

Click Next after adding the devices. The Add Devices Progress page is displayed. This process takes some time to check the status of various tasks. You can either:

Set up CiscoWorks Assistant to send you an e-mail notification. mail notification. You can then exit from the workflow before the tasks are complete. You can view the status after you get the e-mail notification that the tasks have completed. You should do this only after getting an e-mail notification. See Setting up E-mail Notification After Adding Devices for details.

Or
Step 2

Wait until the status check has completed to view the status.

Click on the relevant step link to view the detailed status report. If a step fails, the Last Accessed URL column in the report will display the shortcut URL for that particular step. It will not display anything, if the step is successful.

Click Next to go to Manage Devices Tasks. See Managing Devices for details.
Setting up E-mail Notification After Adding Devices

You can exit the workflow after you complete the tasks and return later to view the status. You should do this after getting an e-mail notification. To do this:
Step 1 Step 2

Select the Notify me When Add Devices Tasks are Complete check box, and click OK. Enter the e-mail ID in the text field. The e-mail ID will be displayed in the text field if you had entered an e-mail ID in the Manage Servers flow. Only one e-mail ID is allowed. E-mail ID can contain any characters, numbers, and special characters ($, _, ^, &, #). For example:

user_cwa1@cisco.com Name_12#@abc.co.in

The following message appears:


An e-mail will be sent to the selected E-mail address after the process has completed.

Step 3

Click Cancel. The initial Server Setup workflow page is displayed. You will receive an e-mail after the tasks have been completed. Click Enter Setup to view the Add Devices Progress page after you receive the e-mail notification.

Step 4

User Guide for CiscoWorks Assistant

3-40

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing Devices

Deleting SNMPv2 Details


To delete the SNMPv2 details:
Step 1 Step 2 Step 3 Step 4

Select Run Discovery on the host_name check box, and click the Run Discovery on the host_name link. Click the SNMP Settings tab. Select the row to be deleted. Click Delete. The Delete SNMPV2 Confirmation dialog box appears. Click OK in the Delete SNMP V2 Confirmation dialog box.

Step 5

Deleting SNMPv3 Details


To delete the SNMPv3 details:
Step 1 Step 2 Step 3 Step 4

Select Run Discovery on the host_name check box, and click Run Discovery on the host_name link. Click the SNMP Settings tab. Select the row to be deleted. Click Delete. The Delete SNMPV3 Confirmation dialog box appears. Click OK in the Delete SNMPV3 Confirmation dialog box.

Step 5

Managing Devices
This page helps you to allocate devices to be managed by the applications installed in the CiscoWorks servers. It lists the CiscoWorks servers and the applications that are present in each server. You can select devices from the device selector and add them to the application that you want the device to be managed. You can also:

Use Device Selector to search for devices in DCR (See About Device Selector) View Device Management status (See Viewing Allocate Devices Status)

To manage devices:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Allocate Devices. The Allocate Devices page appears. Go to the Device Selector and select the devices that you want to add.

Step 2

User Guide for CiscoWorks Assistant OL-17904-01

3-41

Chapter 3 Managing Devices

Configuring LMS Server Using CiscoWorks Assistant

Step 3

Select the applications to which you want to allocate the devices. Initially, devices must be added to DCR. After a device is added to DCR, you can add it to the applications.

Step 4

Click Add Devices to add. Or Click Reset to reset the added devices in the application. The Manage Devices screen displays:

LMS ServerLMS Server IP Address ApplicationsApplications installed in the LMS Server Selected Devices Number of devices selected to add in that application

Step 5

Click Next to complete the Manage Devices tasks. The Device Management Progress page appears. You can view the Device Management status in this page. See Viewing Allocate Devices Status for details.

About Device Selector


The Device Selector allows you to search for the devices in Device and Credential Repository (DCR). It helps you to locate the devices and perform the device management tasks quickly. With the Device Selector, you need not remember the device type or application group hierarchy to locate the devices. The devices are categorized under the Device Type based groups, User Defined groups, Subnet Based groups, Application Specific groups or under All Groups. The CiscoWorks Assistant uses the Common Services Device Selector. See the Configuring Device Selector section in the Managing Device and Credentials chapter of the User Guide for CiscoWorks Common Services 3.3 for information on using Device Selector: http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html You can also access this information from Common Services Online help. From CiscoWorks help, select: Common Services > Managing Device and Credentials > Configuring Device Selector > Searching Devices.

User Guide for CiscoWorks Assistant

3-42

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Managing Devices

Viewing Allocate Devices Status


You can view the device management status after you complete the Allocate Devices tasks. To view the status:
Step 1

Click Next after entering the credentials. The Allocate Devices Progress page appears. This process takes some time to check the status of various tasks. You can either:

Set up CiscoWorks Assistant to send you an e-mail notification. mail notification. You can then exit from the workflow before the tasks are complete. You can view the status after you get the e-mail notification that the tasks have completed. You should do this only after getting an e-mail notification. See Setting up E-mail Notification After Device Management Tasks for details.

Or
Step 2

Wait until the status check has completed to view the status.

Click on the step link to view the detailed status report. Table 3-12 describes the fields in the status report.
Table 3-12 Status Report Fields

Field Server Application Status Last Accessed URL Details

Description Host name or IP Address of the local or remote server. Name of the application to which the devices are added after allocation. Status of the Allocate Devices tasks. This status could be Success or Failure. Displays the shortcut URL for a particular step if it fails. It will not display anything if the step is successful. Displays the details of failure, if the Allocate Devices task for an application is not successful. It will not display anything if the step is successful.

Step 3

Click Next to go to the Change ACS Setup tasks. See Changing ACS Setup for details.

Setting up E-mail Notification After Device Management Tasks

You can exit the workflow after you complete the tasks and return later to view the status. You should do this only after getting an e-mail notification. To do this:
Step 1 Step 2

Select the Notify me When Manage Devices Tasks are Complete check box, and click OK. Enter the e-mail ID in the text field.

User Guide for CiscoWorks Assistant OL-17904-01

3-43

Chapter 3 Changing ACS Setup

Configuring LMS Server Using CiscoWorks Assistant

The e-mail ID will be displayed in the text field if you had entered an e-mail ID in the Manage Servers flow. Only one e-mail ID is allowed. The e-mail ID can contain alphabets, numbers, and special characters ($, _, ^, &, #). For example:

user_cwa1@cisco.com Name_12#@abc.co.in

The following message appears:


An e-mail will be sent to the selected E-mail address after the process has completed.

Step 3

Click Cancel. The initial Server Setup workflow page is displayed. You will receive an e-mail, after the tasks have completed. Click Enter Setup to view the Manage Devices Status page after you receive the e-mail notification.

Step 4

Changing ACS Setup


The CiscoWorks server provides mechanisms used to authenticate users for CiscoWorks applications. The login module determines the type of authentication and authorization CiscoWorks uses. By default, the login module is set to the native CiscoWorks authentication mechanism, that is, the CiscoWorks Local Login module. You can change this default value to use Cisco Secure ACS for user authentication and authorization. In CiscoWorks Local mode, you cannot create custom roles, or modify the predefined roles. Cisco Secure ACS allows you to create custom roles and also limit the access to network devices within LMS using Network Device Groups (NDGs). The details for setting up the CiscoWorks server for non-ACS mode are available in User Guide for CiscoWorks Common Service 3.3. Change ACS Setup page shows the ACS Mode Status for each CiscoWorks server in the setup. From this page you can:

Configure ACS Mode (See Configuring the ACS Mode) Assign Device Group (See Assigning Device Group) Cisco Secure ACS Initial Setup TasksThis includes:
Adding the ACS administrator user Adding CiscoWorks server and devices managed by it as AAA clients in Cisco Secure ACS.

The tasks to be performed to complete AAA mode change to ACS can be classified as:

When you change the mode to ACS using CiscoWorks Assistant, you need to manually add the DCR Master server in ACS as an AAA client. When you change the mode of a Slave, CiscoWorks Assistant adds it to the NDG group you specify. See Cisco Secure ACS Initial Setup Tasks for details.

AAA mode configuration in CiscoWorks AssistantSpecifying the Cisco Secure ACS server details and credentials in the Configure ACS Mode page. See Configuring the ACS Mode for details.

User Guide for CiscoWorks Assistant

3-44

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Changing ACS Setup

User Configuration in Cisco Secure ACSAdding users and defining roles in Cisco Secure ACS. See User Configuration in Cisco Secure ACS for details and pointers to documentation. View the ACS mode configuration status after you complete the Configure ACS Mode tasks. See Viewing the Configure ACS Mode Status Update the ACS server details using this option. You should have already completed the ACS Mode change to do this. See Updating ACS Configuration Assign Device Groups. See Assigning Device Group

You can also perform the following tasks:


Cisco Secure ACS Initial Setup Tasks

You must define an Administrator in ACS server to provide remote access. To access the Cisco Secure ACS HTML interface from a browser on a remote machine, you must log in to Cisco Secure ACS using an administrator account. You can perform the necessary steps to do this in the Administration Control tab in the ACS UI. See the white paper, CiscoWorks LMS Integration with Cisco Secure ACS, or the User Guide for Cisco Secure ACS 4.1 for detailed information. You must then add the CiscoWorks server and the devices it manages as AAA clients in ACS. The ACS workflow does not support IPv6 devices. Hence, IPv6 devices will not be added in ACS. To add CiscoWorks server as an AAA client:
Step 1

In the Cisco Secure ACS navigation bar, click Network Configuration. The Network Configuration page appears. Do either of the following:

Step 2

If you are using Network Device Groups (NDGs), click the name of the NDG to which the AAA client is to be assigned. Then click Add Entry below the AAA Clients table. If NDG option is not visible, you can enable Network Device Groups in ACS under Interface Configuration > Advanced.

Or

Click Add Entry below the AAA Clients table, to add an AAA client when you have not enabled NDGs.

The Add AAA Client page appears.


Step 3 Step 4 Step 5 Step 6 Step 7

In the AAA Client Hostname box, enter the name of your CiscoWorks server (up to 32 characters). In the AAA Client IP Address box, enter the IP address of your CiscoWorks server. In the Key box, enter the Shared Secret key that your CiscoWorks server and ACS use to encrypt the data. From the Authenticate Using list, select TACACS + (CiscoIOS) as the network security protocol used by the AAA client. Click Submit + Restart.

Apart from adding your CiscoWorks server as an AAA client, you also need to add the devices to be managed by the CiscoWorks server as AAA clients to Cisco Secure ACS. When you are integrating the AAA clients with Cisco Secure ACS, your devices will not be visible from your CiscoWorks server if you have not added them as AAA clients in Cisco Secure ACS.

User Guide for CiscoWorks Assistant OL-17904-01

3-45

Chapter 3 Changing ACS Setup

Configuring LMS Server Using CiscoWorks Assistant

For information on adding network device groups and AAA client configuration, see the Network Configuration section of the User Guide for Cisco Secure ACS 4.1. To change ACS settings:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Change ACS Setup. The Change ACS Setup page appears. Change ACS Setup page contains these ACS Mode Status details.

ServerName or IP Address of the server. ModeThe current mode of the server. It can be ACS or Non-ACS.

If the mode is ACS, a link is displayed. Click this link to view the ACS Connection Status for the server.
Step 2

Select the Change Mode to ACS check box in the Login Module pane to change the login mode to ACS. If the server is in ACS mode, the Change ACS Setup page will contain the ACS Tasks pane instead of the Login Module pane. The ACS Tasks pane has these radio buttons:

Update ACS Configuration (See Updating ACS Configuration.) Assign Group for missing devices (See Assigning Device Group.)

Configuring the ACS Mode


To change the mode to ACS:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Change ACS Setup. CiscoWorks Assistant checks whether there are pending devices in DFM and RME. If it finds any pending devices, the Pending Device Count table is displayed. It displays:

ServerServer name. ApplicationApplication that contains pending devices. Value will be DFM or RME. Pending CountNumber of pending devices. DetailsReason why CiscoWorks Assistant could not fetch the pending devices count.This column will be blank if the pending devices count is found.

Along with the table, a Notification pop up window appears with the following message:
Pending devices exist or could not check for pending devices in some LMS applications

Step 2 Step 3

Click OK. Click Next. A confirmation pop up appears with the following message:
LMS server(s) ACS configuration will not be proper if there are pending devices in the LMS applications. Make sure there are no pending devices and click OK to continue.

To get further details on pending devices in the applications, go to:


RME > Devices > Device Management > Pending Devices Device Fault Manager > Device Management > Device Summary

The details are displayed in the screens that appear when you select these menu paths.

User Guide for CiscoWorks Assistant

3-46

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Changing ACS Setup

See RME and Device Fault Manager User Guides for more information on pending devices. The Change ACS Setup page appears after you click OK.
Step 4

Select the Change Mode to ACS check box and click Next to go the Configure ACS Mode page.

Note Step 5 Step 6

Ensure that the local server is an AAA client to ACS server.

Click OK on the Notification pop-up window to continue with the ACS Mode change. Enter the required information in the ACS Mode Setup table to change the login mode to ACS. If the DCR Master (local server) is already in ACS mode, the fields other than the passwords and secret keys will be pre-populated. Table 3-13 describes the fields in the ACS Mode Setup table.
Table 3-13 ACS Mode Setup Fields

Field
Server Details

Description Enter the Primary IP Address/Hostname of the ACS server. Enter the ACS TACACS+ port number. The default port number is 49. You can change the port based on the value configured in ACS.

Primary IP Address/Hostname ACS TACACS+ port

Secondary IP Address/Hostname ACS TACACS+ port

Enter the Secondary IP Address/Hostname of the ACS server. Enter the ACS TACACS+ port number. The default port number is 49. You can change the port based on the value configured in ACS.

Tertiary IP Address/Hostname ACS TACACS+ port

Enter the Tertiary IP Address/Hostname of the ACS server Enter the ACS TACACS+ port number. The default port number is 49. You can change the port based on the value configured in ACS.

Login

ACS Admin Name ACS Admin Password Confirm Password ACS Shared Secret Key Confirm Key
System Identity

Enter the administrator username in ACS Enter the administrator password in ACS Re-enter the administrator password in ACS Enter the secret key shared between ACS and the CiscoWorks server. Re-enter the ACS Shared Secret key Enter the system identity user name. This user should be already configured in ACS, with all privileges. Enter the system identity password value Re-enter the password.

User Name Password Confirm Password

User Guide for CiscoWorks Assistant OL-17904-01

3-47

Chapter 3 Changing ACS Setup

Configuring LMS Server Using CiscoWorks Assistant

Table 3-13

ACS Mode Setup Fields

Field
Network Device Group Name

Description Enter the Network Device Group Name value. Network Device Group name should present in the ACS. This field appears only in a Multi-server set up, when you change the mode of a Slave. You must manually add the local server (DCR Master) as an AAA client in ACS, before you change the mode to ACS. The workflow converts the other servers part of the Multi-server to ACS mode and also add missing devices to the NDG that you specify here.

Network Device Group Name

Step 7

Select the Register all Installed Applications with ACS check box, if you are registering the applications for the first time. In case an application is already registered with ACS, the current registration will overwrite the previous registration. When you select the Register all Installed Applications with ACS check box, you are prompted to confirm whether you want to continue with the settings. See Common Services Online help for details. Select the HTTP or HTTPS radio button under Current ACS Administrative Access Protocol. Click Next to complete the Mode change. The Configure ACS Mode Progress page is displayed. You can view the ACS mode configuration status in this page. See Viewing the Configure ACS Mode Status for details.

Step 8 Step 9

Note

In a Multi-server setup, ACS configuration may fail, when master and slave servers are trying to register the applications at the same time. At the time of failure, repeat the above steps to continue with ACS configuration.

User Configuration in Cisco Secure ACS

The System Identity User has to be created in ACS, and assigned Super Admin role in all applications in ACS. You should create a user in ACS with the current System Identity username, and assign Super Admin role to that user in all applications in the TACACS + options pane in Group Setup or User Setup UI in ACS. See Configuring Device Management Command Authorization for a User Group in User Guide for Cisco Secure ACS 4.1.

Note

Restart daemon manager after you create the System Identity User in ACS, and assign the Super Admin role for the changes to take effect.

User Guide for CiscoWorks Assistant

3-48

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Changing ACS Setup

The final step in integrating CiscoWorks Common Services Software with Cisco Secure ACS is to configure the CiscoWorks users within Cisco Secure ACS. Cisco Secure ACS allows you to define access permissions and policies for the registered CiscoWorks applications either for individual users or for a group of users. See the following sections of the Cisco Secure ACS User Guide for more information on managing users and user groups:

User Group Management User Management

While adding the user, you can configure access policies to define what the user is authorized to do, depending on the role. See Configuring Users in ACS section in User Guide for CiscoWorks Common Services 3.3 for information on:

Assigning Privileges in ACS Creating and Modifying Roles in ACS

See also the white paper on CiscoWorks LMS Integration with Cisco Secure ACS, available on Cisco.com

Viewing the Configure ACS Mode Status


You can view the ACS mode configuration status after you complete the Configure ACS Mode tasks. To view the status, click Next after configuring the ACS mode. The Configure ACS Mode Progress page is displayed. This process takes some time to check the status of various tasks. You can either:

Exit the workflow after you complete the tasks and return later to view the status. You should do this only after getting an e-mail notification. See Setting up E-mail Notification After Configuring ACS Mode for details. Wait until the status checks complete to view the status.

Or

The Configure ACS Mode Result page is displayed. See Viewing the Configure ACS Mode Result for details.
Setting up E-mail Notification After Configuring ACS Mode

You can exit the workflow after you complete the tasks and return later to view the status. You should do this after getting an e-mail notification. To do this:
Step 1 Step 2

Select the Notify me When ACS Tasks are Complete check box, and click OK. Enter the e-mail ID in the text field. The e-mail ID will be displayed in the text field if you had entered an e-mail ID in the Manage Servers flow. Only one e-mail ID is allowed. The e-mail ID can contain alphabets, numbers, and special characters ($, _, ^, &, #).

User Guide for CiscoWorks Assistant OL-17904-01

3-49

Chapter 3 Changing ACS Setup

Configuring LMS Server Using CiscoWorks Assistant

For example:

user_cwa1@cisco.com Name_12#@abc.co.in

The following message appears:


An e-mail will be sent to the selected E-mail address after the process has completed.

Step 3

Click Cancel. The initial Server Setup workflow page is displayed. You will receive an e-mail after the tasks have been completed. Click Enter Setup to view the ACS Mode Progress page after you receive the e-mail notification.

Step 4

Viewing the Configure ACS Mode Result


Configure ACS Mode Result page displays the ACS Connection Status of all servers in the setup. To access the Configure ACS Result page you should have changed the server into ACS Mode. To view the Configure ACS Mode Result page:
Step 1

Click Next, after the Configure ACS Mode tasks are complete. The Configure ACS Mode result page appears with the following popup message:
Restart the LMS Daemon Manager of the following servers for the ACS changes to take effect: <Server details> Make sure the configured System Identity User is available in ACS Server.

Step 2

Restart daemon manager, and click OK to view the Configure ACS Mode Result page. To restart daemon manager:
a.

Stop daemon manager.


On Solaris:

Run /etc/init.d/dmgtd stop


On Windows:

Run net stop CRMdmgtd or net stop crmdmgtd


b.

Start daemon manager.


On Solaris:

Run /etc/init.d/dmgtd start


On Windows:

Run net start CRMdmgtd or net start crmdmgtd The following ACS Connection Status details are shown:

TACACS+ Connectivity With ACS StatusReachability status of the ACS server HTTP/HTTPS Connectivity With ACSReachability status of the ACS server using HTTP or HTTPS CiscoWorks System Identity User Configuration in ACS Information on privileges for the ACS server.

User Guide for CiscoWorks Assistant

3-50

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Changing ACS Setup

See the Setting up AAA Mode to ACS section in the User Guide for CiscoWorks Common Services 3.3, for further details.

Updating ACS Configuration


You can update the ACS server details using this option. You should have already completed the ACS Mode change to do this. To update ACS server details:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Change ACS Setup CiscoWorks Assistant checks whether there are pending devices in DFM and RME. If it finds any pending devices, the Pending Device Count table is displayed with the following:

ServerServer name. ApplicationApplication that contains pending devices. Value will be DFM or RME. Pending CountNumber of pending devices. DetailsReason why CiscoWorks Assistant could not fetch the pending device count.This column will be blank if the pending devices count is found.

Along with the table, a Notification pop up window appears with the following message:
Pending devices exist or could not check for pending devices in some LMS applications

Step 2 Step 3

Click OK. Click Next. A confirmation pop up appears with the following message:
LMS server(s) ACS configuration will not be proper if there are pending devices in the LMS applications. Make sure there are no pending devices and click OK to continue.

To get further details on pending devices in the applications, go to:


RME > Devices > Device Management > Pending Devices Device Fault Manager > Device Management > Device Summary

The details are displayed in the screens that appear when you select these menu paths. See RME and Device Fault Manager User Guides for more information on pending devices. The Change ACS Setup page appears after you click OK.
Step 4

Select the Update ACS Configuration radio button from the ACS Tasks pane. The Update ACS Configuration check box appears in the ACS Tasks pane only if the server is in ACS mode.

Step 5

Click Next. The following popup message appears:


Please ensure that local server is an AAA client to ACS server.

Step 6

Click OK to continue. The Configure ACS Mode page appears with the pre-populated values in the ACS Mode Setup.

User Guide for CiscoWorks Assistant OL-17904-01

3-51

Chapter 3 Changing ACS Setup

Configuring LMS Server Using CiscoWorks Assistant

Step 7

Enter the new details in the ACS Mode Setup window. You need to provide the current System Identity Username and Password. The NDG should be already be preset in ACS. You must also provide the Shared Secret key.

Step 8

Click Next to complete updating ACS configuration.

Note

In a Multi-server setup, ACS configuration may fail, when master and slave servers are trying to register the applications at the same time. At the time of failure, repeat the above steps to continue with ACS configuration. Restart daemon manager for the changes to take effect.

Step 9

Assigning Device Group


After you have integrated the CiscoWorks server with Cisco Secure ACS and assigned appropriate roles to the user you would not be able to see the devices added in DCR if the devices are not added as AAA clients to Cisco Secure ACS. CiscoWorks Assistant lets you add the missing devices into the appropriate NDG in ACS. Common Services displays a report that has the list of DCR devices that need to be configured in ACS. See Generating Reports in DCR section of the User Guide for CiscoWorks Common Services 3.3, for details. The Assign Device Group check box appears only if there are missing DCR devices in ACS. You can assign the devices to the appropriate NDG. To assign device groups:
Step 1

Select CiscoWorks Assistant > Workflows > Server Setup > Change ACS Setup CiscoWorks Assistant checks whether there are pending devices in DFM and RME. If it finds any pending devices, the Pending Device Count table is displayed with the following details:

ServerServer name. ApplicationApplication that contains pending devices. Value will be DFM or RME. Pending CountNumber of pending devices. DetailsReason why CiscoWorks Assistant could not fetch the pending device count.This column will be blank if the pending devices count is found.

Along with the table, a Notification pop up window appears with the following message:
Pending devices exist or could not check for pending devices in some LMS applications

Step 2 Step 3

Click OK. Click Next. A confirmation pop up appears with the following message:
LMS server(s) ACS configuration will not be proper if there are pending devices in the LMS applications. Make sure there are no pending devices and click OK to continue.

User Guide for CiscoWorks Assistant

3-52

OL-17904-01

Chapter 3

Configuring LMS Server Using CiscoWorks Assistant Viewing the Server Setup Summary

To get further details on pending devices in the applications, go to:


RME > Devices > Device Management > Pending Devices Device Fault Manager > Device Management > Device Summary

The details are displayed in the screens that appear when you select these menu paths. See RME and Device Fault Manager User Guides for more information on pending devices. The Change ACS Setup page appears after you click OK.
Step 4 Step 5

Select the Assign group for missing devices radio button in the ACS Tasks pane. Click Next. The Assign Device Group page appears. Enter the following information in the Export Devices to ACS table to add the missing devices into ACS:

Step 6

Server detailsIP address and port number of the ACS server. Login detailsACS administrator name, password, and the shared secret key. Current ACS Administrative Access ProtocolProtocol used to connect to ACS server. Network Device Group nameNDG to which you want to add the missing devices.

Step 7

Click Next to complete assigning device group.

Viewing the Server Setup Summary


You can view a summary of the tasks that you performed during the workflow, after you complete the workflow steps. To view the summary, click Next after you perform the workflow steps. The Server Setup Summary page is displayed. with the following details:

Session Details Server Summary ACS Summary Operation Summary

The information on this page depends on the tasks that you performed. You need not perform all of the Server Setup workflow tasks to view the Summary. You may skip the steps that you do not need to perform during a workflow session. For example, you may perform the Manage Servers tasks and skip all the other tasks to get to the Summary page. In such a case, the Summary page displays only the summary related to the Manage Servers tasks.
Session Details

The Session Details table displays the Start Time and the User Name for the current session.
Server Summary

The Server Summary lists all servers in the setup. The fields in the Server Summary and their descriptions are given below.

User Guide for CiscoWorks Assistant OL-17904-01

3-53

Chapter 3 Viewing the Server Setup Summary

Configuring LMS Server Using CiscoWorks Assistant

LMS ServerHost Name or IP Address of the server. ProtocolProtocol of the server. This can be HTTP or HTTPS PortPort Number of the CiscoWorks server. DCRDCR mode of the server. Mode can be DCR Master, Slave, or Standalone. SSOSSO mode of the server. SSO Mode can be Master, Slave, or Standalone.

When you click the Expand button of the CiscoWorks server, it lists the applications installed in that server.
ACS Summary

The ACS Summary table lists all the servers and their current mode. The mode can be ACS or Non-ACS.
Operation Summary

The Operation Summary tables display the tasks that you performed during the Server Setup workflow. The fields in the Operation Summary, and their descriptions are given below

StepStep Name of the workflow. Last runDate and Time when the step was performed. DetailsClick the View link to view the Step Summary dialog box.

Click Finish to go to the Server Setup home page and end the current session.
Related Documentation

For more information on Multi-server setups, DCR and SSO, see the latest versions of following documents on Cisco.com:

User Guide for CiscoWorks Common Services 3.3 http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html

White Paper on CiscoWorks LMS Integration with Cisco Secure ACS http://www.cisco.com/en/US/products/sw/cscowork/ps2425/prod_white_papers_list.html

LMS application User Guides. http://www.cisco.com/en/US/products/sw/netmgtsw/tsd_products_support_category_home.html

User Guide for CiscoWorks Assistant

3-54

OL-17904-01

CH A P T E R

Troubleshooting Your Network Using CiscoWorks Assistant


Cisco Works Assistant helps you collect troubleshooting information from all the servers part of the Multi-server setup and display reports. For Device Troubleshooting workflow and End Host/IP Phone down workflow to work in a Multi-server setup, you should have configured Single Sign-on. You should also have the same System Identity User configured across all servers that are part of the set up. The following sections help you understand the Troubleshooting Workflow:

Generating Device Troubleshooting Report Understanding the Device Troubleshooting Report Generating End Host/IP Phone Down Report Selecting an End Host From the End Hosts List Understanding the End Host Down Report Understanding the IP Phone Down Report

Generating Device Troubleshooting Report


You can analyze the root cause for device unreachability. The generated Device Troubleshooting report contains the following details for the selected device:

Note

You must install Campus Manager, DFM, HUM and RME to view all these details. If these applications are not installed, some of the reports will not be generated.

Alerts and Syslog Messages Differences between the two archived running configurations. Changes in the device configuration file, inventory, and installed image Details of the device topology Check Device Attributes (CDA) information GOLD, Call Home and EEM reports

User Guide for CiscoWorks Assistant OL-17904-01

4-1

Chapter 4 Generating Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Device availability and threshold reports Details on network inconsistencies, misconfiguration in the physical and logical layout in the discovered network.

To generate Device Troubleshooting report:

Note

View Permission Report (Common Services > Server > Reports) to check if you have the required privileges to perform this task. Select CiscoWorks Assistant > Workflows > Device Troubleshooting. The Device Troubleshooting window appears. Select a device using the Device Selector (Using Device Selector in Troubleshooting Workflows). Enter the fields described in Table 4-1.

Step 1

Step 2 Step 3

User Guide for CiscoWorks Assistant

4-2

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Generating Device Troubleshooting Report

Table 4-1

Device Troubleshooting Window Details

Field Name Selected Device Notify me on Workflow Completion

Description The selected device display name or IP Address is populated in this field. You cannot enter device details in the Selected Device field. If you enable this option, you will receive a status report on the Device Troubleshooting report. You can view the detailed report if you click the link available at the end of the e-mail. This will not be available after the data has been purged. The following is a sample e-mail:
Hi, Workflow Name: Device Troubleshooting LMS user: admin Execution started at: 04/01/2009 01:48:26 PM IST Status: Workflow successfully completed User Input Details: Device IPAddress : 10.77.209.132 Device Name : 10.77.209.132 Step Details: Reachability Check : Device connected Trace Route : Trace Route retrieved for the selected device. Syslog Message : No syslog messages for the selected device. Audit Report : Audit summary for the selected device. Generic OnLine Diagnostics : Generic OnLine Diagnostics details for the selected device. Call Home : Call Home Report for the selected device. Embedded Event Manager : Embedded Event Manager report for the selected device. Device Availability : Availability Report for the selected device. Device Threshold : Threshold Report not found for the selected device. Device Credential Verification Report : Verification Report for the selected device. Last Configuration Change : Configuration change fetched for the selected device. DFM Alerts : Alerts not retrieved Complete Report can be viewed at : https://lms-ibm-pc13.cisco.com:19999/cwa/wfReport.do?wfsessionid=OPSBRE.1D3FB6767FD F4C518CA13A0F6195B1A7 Note: This report is not available once purge operation is done. Regards, CiscoWorks Assistant.

E-mail ID

This field is enabled only if you have selected the Notify me on Workflow Completion field. Enter an E-mail ID. You can enter multiple e-mail IDs. For example:

john@abc.com john_smith@abc.co.in

User Guide for CiscoWorks Assistant OL-17904-01

4-3

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Step 4

Click Run. The Device Troubleshooting report appears in a new window. See Understanding the Device Troubleshooting Report for details on the generated report. The report generation may take a while. You can click Exit to return to the CiscoWorks Assistant home page.

Understanding the Device Troubleshooting Report


The generated Device Troubleshooting report contains the following tables:

Device Information Reachability Check Trace Route CDP Neighbors Syslog Messages DFM Alerts Last Configuration Change Audit Report Generic OnLine Diagnostics Call Home Embedded Event Manager Device Credential Verification Report Discrepancy Links to Tools and More Device Information Device Availability Device Threshold

Device Information

This table contains the device information as available in Device and Credential Repository (DCR). Table 4-2 describes the fields in the Device Information Report.
Table 4-2 Device Information Report Fields

Field Name Name IP Address

Description Display Name of the device as entered in DCR. IP Address of the device.

User Guide for CiscoWorks Assistant

4-4

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the Device Troubleshooting Report

Table 4-2

Device Information Report Fields

Field Name Device Type Managed By

Description Device Type Information. For example, Cisco 2511 Access Server, etc. Lists of the LMS applications that manage the selected device. These applications can be from a local CiscoWorks server or from the remote CiscoWorks servers in a multi-server setup.

Reachability Check

This table contains the device connectivity information. Device connectivity information is limited to IPv4 devices. Since Common Services is not supporting IPv6 devices, CiscoWorks Assistant will also not support the same. Table 4-3 describes the fields in the Reachability Check report.
Table 4-3 Reachability Check Report Fields

Field Name Ping

Description Ping status of the selected device. Checks whether the device is reachable. A ping tests an ICMP echo message and its reply.

HTTP

Ping status of the selected device. Sends an HTTP request to the HTTP port 80 of the destination device.

SNMPv1/v2c Read

Status of SNMPv1/v2c Read Community string (service test, port 161) of the selected device. Sends an snmp get request to the destination device for an SNMP read test (SNMPR).

SNMPv1/v2c Write

Status of SNMPv1/v2c Write Community string (service test, port 161) of the selected device. Sends an snmp set request to the device to test SNMP write (SNMPW). Status of SNMPv3 Read credentials (service test, port 161) of the selected device. Sends an snmp get request to the destination device for an SNMP read test (SNMPR).

SNMPv3 Read

SNMPv3 Write

Status of SNMPv3 Write credentials (service test, port 161) of the selected device. Sends an snmp set request to the device to test SNMP write (SNMPW). Telnet status (service test, port 23) of the selected device. Checks whether Telnet is enabled on the device and if the destination device responds to a Telnet request. It does not verify that the Telnet password in the database works.

Telnet

User Guide for CiscoWorks Assistant OL-17904-01

4-5

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Table 4-3

Reachability Check Report Fields

Field Name SSHv1

Description SSHv1 credentials status (service test, port 22) of the selected device. Checks whether SSH is enabled on the device. If the destination device responds to SSH requests, this also tests whether CiscoWorks server can make SSH requests to that device. It does not verify the password in the database.

SSHv2

SSHv2 credentials status (service test, port 22) of the selected device. Checks whether SSH is enabled on the device. If the destination device responds to SSH requests, this also tests whether CiscoWorks server can make SSH requests to that device. It does not verify the password in the database.

Note

SNMPv3 and SSH details will be displayed only if they are enabled and configured for the device. To know more about device connectivity tools, see the User Guide for Common Services at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html
Trace Route

Displays the trace route status of the selected device. It has a maximum of 30 hops. Detects routing errors between the network management station and the target device.
Syslog Messages

This table contains the Syslog messages that are received in the past 24 hours, from the scheduled time of the report. This information is taken from the RME database. The report shows the latest ten Syslog messages. However, only the first four severities will be displayed. Table 4-4 provides the details of the Syslog messages.
Table 4-4 Syslog Messages

Field Name Device Name Interface Timestamp

Description Display Name of the device as entered in DCR. IP address of the interface through which the Syslog was sent out. Date and time the message was logged. This is the timestamp provided by the device. Syslog daemon provides a timestamp if the device does not send one. Facility is a hardware device, a protocol, or a module of the system software; for example, SYS. Refer to the Cisco IOS reference manual System Error Messages for a predefined list of facility codes. SubFacility is the subfacility in the device that generated the Syslog message. In most cases, this is blank. An example of an entry in this field is SYS-5-CONFIG I.

Facility-SubFacility

User Guide for CiscoWorks Assistant

4-6

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the Device Troubleshooting Report

Table 4-4

Syslog Messages

Field Name Severity

Description Message severity level. CiscoWorks Assistant captures the following severity levels: Emergencies(0), Alerts (1), Critical (2), Errors (3). Click on More Details link below the table to see detailed report from RME. Code that uniquely identifies the error message. Note that older Catalyst messages do not display a mnemonic. An example of a mnemonic for an IOS message is CONFIG I. Syslog Message description. Name of the Syslog message. Displays a new window containing the Syslog message description. When you click on the User_URL icon, you are linked to a customized web page, if you have defined one; otherwise, it defaults to a sample Perl script for creating a user URL. When you click the '*', the description of the Syslog message is displayed

Mnemonic

Description Details

To know more about Syslog Changes, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html
CDP Neighbors

You can view the network topology of the devices discovered by Campus Manager ANI, through Topology Maps. You can use Network Views to see different aspects of your network. Only devices and links discovered in your network are displayed in topology maps. Along with the network topology, you can also view the device neighbor. These neighbor devices are physically connected to the selected device. To know more about device topology, see the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps563/products_user_guide_list.html
DFM Alerts

This table contains the alerts that are received in the past 24 hours, from the scheduled time of the report. The report shows the latest ten Alerts. The Alerts provides a consolidated real-time view of the operational status of your network. When a fault occurs in your network, DFM generates an event. All events occurring on the same device are rolled up into a single alert. DFM alerts are limited to IPv4 devices. In case no alerts are listed, one of the possible reasons will be, the detected device might be an IPv6 device. Table 4-5 lists the DFM alert details.
Table 4-5 DFM Alerts

Field Name Event ID Device Name Component

Description Event identifier number. Device name or IP address. Device element on which the event occurred.

User Guide for CiscoWorks Assistant OL-17904-01

4-7

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Table 4-5

DFM Alerts

Field Name Description Time Status

Description Description of the alert. Date and time the alert was logged. This is the timestamp provided by the device. Alert status, based on last polling.

ActiveAlert is live. ClearedAlert is no longer live AcknowledgedAlert was manually acknowledged by a user

Alert ID

Alert identifier number.

To know more about device alerts, see the User Guide for Device Fault Manager 3.2 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2421/products_user_guide_list.html
Last Configuration Change

You can view:


The time when the running configuration was archived in the Configuration Archive. The differences between the two archived running configurations in the Configuration Archive.

To know more about comparing configuration files, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html
Audit Report

This table contains the last 24 hours changes that happened in your network. Change Audit allows RME applications to log change information to a central repository. Device Configuration, Inventory, and Software Management changes can be logged and viewed using Change Audit. Table 4-6 describes the Audit Report fields.
Table 4-6 Audit Report Fields

Field Device Name User Name

Description Display Name of the device as entered in DCR. Click on the device name to launch the Device Center. Name of the user who performed the change. This is the name entered when the user logged in. It can be the name under which the RME application is running, or the name using which the change was performed on the device. Name of the RME application involved in the network change. For example, Archive Mgmt, ConfigEditor, CwConfig, etc. Host name of the machine from which the user accessed the device or the host name of the RME server. Date and time at which the application communicated the network change or when Change Audit saw the change record.

Application Name Host Name Creation Time

User Guide for CiscoWorks Assistant

4-8

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the Device Troubleshooting Report

Table 4-6

Audit Report Fields

Field Connection Mode

Description Connection mode through which the change was made. For example, Telnet, SNMP, or console. The mode is obtained by querying the device and if the query fails, default or NA is shown. Brief summary of the network change. Application details for a particular device displayed in a separate browser window. Select the highlighted Details text to view application details in a separate browser window. Applications that make or detect changes in the network log a change record in Change Audit log and provide a means for getting to the detailed data. The following information is displayed when you click on the Details link for:

Message Details

Archive Mgmt, ConfigEditor, CwConfig, and NetConfigThe Config Diff Viewer window is displayed. ICServerThe Inventory Change report is displayed. This window shows the changed values (previous and current value) of different Inventory entitites such as FlashDevice, FlashPartition, FlashFile.

Software ManagementThe Software Modification History report is displayed. This window shows the changed software image details.

Grouped Records

Similar change details grouped by the same job ID and the same function ID (for example: inventory collection) displayed in a separate summary window. Select the highlighted More Records text in the Grouped Records column to view similar change details in a frame below the summary window. For example, you have completed a software update on five devices. The Change Audit report shows the Software Management summary information about who performed the job, when, and so on. To display all devices affected by this upgrade, click More Records to display the summary information related to the five devices. From here you can look at details of the individual device upgrades.

To know more about Change Audit, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html

User Guide for CiscoWorks Assistant OL-17904-01

4-9

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Generic OnLine Diagnostics

The Generic OnLine Diagnostics (GOLD) report is displayed in Device Troubleshooting workflow for the devices managed by RME. The details for this report is fetched from the RME Application Programming Interface (API).Click the required command from the Command List pane to view the relevant output. To know more about Generic OnLine Diagnostics, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html
Call Home

The Call Home report is displayed in Device Troubleshooting workflow for the devices managed by RME. The details for this report is fetched from the RME API. Click the required command from the Command List pane to view the relevant output. To know more about Call Home, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html Embedded Event Manager The Embedded Event Manager (EEM) report is displayed in Device Troubleshooting workflow for the devices managed by RME. The details for this report is fetched from the RME API. Click the required command from the Command List pane to view the relevant output. To know more about Embedded Event Manager, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html
Device Credential Verification Report

This table contains the device names and credential status for each device. This helps you to ensure that your Device and Credential Repository credentials match your actual device credentials. This table also lists the devices for which the report is not available. You can check the device credentials in Table 4-7.
Table 4-7 Device Credential Verification Report Fields

Field Device Name Read Community

Description Name of the device for which the credential status is verified. SNMP version 2 read community string. Read community string is verified in RME by performing a read operation on the device through the SNMP transport library and checking the result.

Read Write Community

SNMP version 2 write community string. Read write community string is verified in RME by performing snmpget operation on syslocation variable and snmpset with the value returned by the snmpget operation.

SNMPv3

SNMP version 3 username and password. SNMPv3 credentials is verified in RME by operating on the device through the SNMP transport library.

User Guide for CiscoWorks Assistant

4-10

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the Device Troubleshooting Report

Table 4-7

Device Credential Verification Report Fields

Telnet

Telnet username and password. Telnet username and password are verified in RME by trying to log into the device using the Telnet transport library. It also verifies whether the attempt is successful.

Enable by Telnet

Telnet username and password in enable mode. Enable mode password is verified in RME while trying to establish connection using Telnet and entering the enable mode. It also verifies whether the attempt is successful.

SSH

SSH username and password. SSH username and password are verified in RME by trying to log into the device using the SSH transport library. It also verifies whether the attempt is successful.

Enable by SSH

SSH username and password in enable mode. Enable mode password is verified in RME while trying to establish connection using SSH and entering the enable mode. It also verifies whether the attempt is successful.

The Credential Verification status for all the above fields could be any one of the following:

OK Denotes that the device credentials data in the Device and Credential Repository matches the physical device credentials of the selected device. No authentication configuredDevice was not configured with authentication mechanism (Telnet/Local Username/TACACS). IncorrectDenotes that the device credentials verification is completed but the device is unreachable or offline or one of the interfaces on the devices is down. Wrong CredentialsDenotes that the device credentials data in Device and Credential Repository are wrong. Did Not TryDenotes that the device credentials is not performed either because the credentials do not exist or the enable login mode failed. Failed to ConnectDenotes that the connection to device failed because of its non-responding state. Not SupportedDenotes the specific credentials are not supported on the device. This could be because of protocol mismatch. No Value to TestCheck for device credentials is not performed because device credentials data is not entered. Credentials Not VerifiedSpecific credentials were not verified because they were not selected for verification

Device Troubleshooting Workflow displays the details of last Device Credential Verification job. If there are no CDA job details available on the CiscoWorks server, you can start an immediate CDA job. You can use the Run Now link to open the Check Device Credentials page. You can set your options in the Check Device Credentials page and start an immediate CDA job.

User Guide for CiscoWorks Assistant OL-17904-01

4-11

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

To know more about Device Credential Verification report, see the User Guide for Resource Manager Essentials 4.3 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps2073/products_user_guide_list.html
Discrepancy

This table contains the network inconsistencies, anomalies or misconfiguration in the physical and logical layout in the discovered network. This makes it easy to identify configuration errors such as link-speed mismatches on either end of a connection. Table 4-8 describes the fields in the Discrepancy Report.
Table 4-8 Discrepancy Report Fields

Field Name Acknowledge

Description Displays the acknowledge status of the discrepancy. If you acknowledge a discrepancy, it is not displayed in the Discrepancy Report, the next time you generate the report. You can acknowledge the status using Campus Manager. See the User Guide for Campus Manager 5.2 for more details: http://www.cisco.com/en/US/products/sw/cscowork/ps563/products_user_g uide_list.html

Type Severity Summary

Brief description of the discrepancy is displayed here. Severity level of the discrepancy is listed here. Discrepancies are categorized according to their severity as medium, and high. IP addresses of the devices that are affected by the discrepancy. Click the hyper link to view more details on the discrepancy. See the User Guide for Campus Manager 5.2 for more details: http://www.cisco.com/en/US/products/sw/cscowork/ps563/products_user_g uide_list.html

First Found Remarks

Date and time when Campus Manager first discovered the discrepancy. If a fix has been attempted on the discrepancy, it is shown here.

To know more about device discrepancies, see the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowork/ps563/products_user_guide_list.html
Links to Tools and More Device Information

You can launch the windows listed in Table 4-9.


Table 4-9 Links to Tools and More Device Information

Link Name View current config View current inventory

Description Opens a window that displays the current running configuration of the selected device. Opens a window that displays the current inventory collection status of your network.

User Guide for CiscoWorks Assistant

4-12

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the Device Troubleshooting Report

Table 4-9

Links to Tools and More Device Information

Link Name SNMP Walk

Description Allows you to trace the MIB tree of a device starting from a given OID for troubleshooting, or gathering information about the selected device. Captures live data from the CiscoWorks machine to aid in troubleshooting. Allows you to edit the default credential information for the device. You can edit device information in the Device and Credential Repository. Opens a Telnet session of the selected device. Opens the Device Center page for the device. You can view the summary and reports for the selected device. You can perform device-centric activities, such as changing device attributes, updating inventory and Telnet. The activities you can perform depend on the applications that are installed on the CiscoWorks Server.

Packet Capture Edit Device Credentials

Telnet Device Center

SNMP Set

Sets SNMP object or multiple objects on a device for controlling the device.

Device Availability

This table contains the HUM device availability information. This information is taken from the HUM Device Dashboard page and presented using graphs. Table 4-10 describes the fields in the Device Availability Report.
Table 4-10 Device Availability Report Fields

Field 24 Hours (in percentage) 24 Hours One Week One Month Click here (Link)

Description Displays the last 24 hours Device Availability percentage Click to launch a line graph showing device availability details for the last 24 hours. Click to launch a line graph showing device availability details for the last one week. Click to launch a line graph showing device availability details for the last one month. The link is available in the bottom of the report. Launches the Device Dashboard which allows the user to view more details of the selected device.

Click Here to create poller link will be displayed, when there are no reports for the selected device. The link will lead you to Poller Management Page where you can create a poller for the selected device. To know more about Device Availability, see the User Guide for Health and Utilization Monitor 1.2 at this location: http://www.cisco.com/en/US/products/ps9303/products_user_guide_list.html

User Guide for CiscoWorks Assistant OL-17904-01

4-13

Chapter 4 Understanding the Device Troubleshooting Report

Troubleshooting Your Network Using CiscoWorks Assistant

Device Threshold

This table contains the device threshold report. Table 4-11 describes the fields in the Device Threshold Report.
Table 4-11 Device Threshold Report Fields

Field No. of Thresholds Configured No. of Violations in Last 24 hours

Description Total number of thresholds configured in the device. Total number of threshold violations that occurred in the last 24 hours. These are categorized based on the severity levels (such as Critical, Medium or Low). For example, Low: 10, Medium:15, Critical:170 Threshold configured in the device. MIB variable name. For example, cpmCPUTotal15minRev. MIB variable instance for which the threshold is configured. For example, CPU of supervisor. Severity level of the threshold (such as Critical, Medium or Low) Time of threshold violation. By default, only the latest 10 violations are displayed for the device in the Device Threshold Details panel. If you click More, a pop-up window appears displaying details on all the violations in the device. The link is available in the bottom of the report. Launches the Device Dashboard which allows the user to view more details of the selected device.

Threshold Name Variable Name Instance Name Severity Time Stamp More (link)

Click here (Link)

If the poller is not associated with device, the report cannot be generated even though the device is managed by HUM. Click Here to create poller link will be displayed, when there are no reports for the selected device. The link will lead you to Poller Management Page where you can create a poller for the selected device. To know more about Device Threshold, see the User Guide for Health and Utilization Monitor 1.2 at this location: http://www.cisco.com/en/US/products/ps9303/products_user_guide_list.html

User Guide for CiscoWorks Assistant

4-14

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Generating End Host/IP Phone Down Report

Generating End Host/IP Phone Down Report


You can locate and track the End Hosts/IP phone in your network, thus providing you the information required to troubleshoot as well as analyze the connectivity issues. You must install Campus Manager to generate the End Host/IP Phone Down report. To generate End Host /IP Phone Down report:

Note

View Permission Report (Common Services > Server > Reports) to check if you have the required privileges to perform this task. Select CiscoWorks Assistant > Workflows > End Host/IP Phone Down. The End Host/IP Phone window appears. Enter the details given in Table 4-12.
Table 4-12 End Host/IP Phone Down Report Fields

Step 1

Step 2

Field Name Device Type Input Type

Description Select the device type, End Host or IP Phone. Select the input type.

If you have selected End Host as Device Type, you can either select one of the following as the Input Type:
IP AddressIP address of host. Host NameName of host. MAC AddressMedia Access Control (MAC) address of network

interface card in end-user node The MAC Address appears in the format, xx-xx-xx-xx-xx-xx.
User NameDiscovered username or the username that you have entered

If you have selected IP Phone as Device Type, you can select either of the following as the Input Type:
IP AddressIP address of phone. Phone NumberPhone number.

Based on your Input Type following will be displayed for End Host:

Enter the required information.

IP Address Host Name MAC Address User Name

Based on your Input Type following will be displayed for IP Phone:


IP Address Phone Number

User Guide for CiscoWorks Assistant OL-17904-01

4-15

Chapter 4 Generating End Host/IP Phone Down Report

Troubleshooting Your Network Using CiscoWorks Assistant

Table 4-12

End Host/IP Phone Down Report Fields

Field Name Rediscover

Description Select this option if you want to get the latest information from the device. The rediscover is performed only for the selected device. If this option is not selected, the End Host/IP Phone details are obtained from the existing Campus Manager database.

Switch Check

Select this option if you want to check the reachability connection of the Switch/Cisco Call Manager (CCM) to which the End Host/IP Phone is connected. CiscoWorks Assistant also checks the port status of the End Host/IP Phone. If the device is not reachable then it automatically triggers the Device Troubleshooting workflow.

Notify me on Workflow Completion

If you enable this option, you will receive a status report on the End Host/IP Phone Down report. Click on the link in the e-mail to view a detailed report. This will not be available after the data has been purged. For example: The e-mail will contain:
Hi, Workflow Name: End Host / IP Phone Down LMS user: admin Execution started at: 04/25/2007 06:53:11 PM (GMT) Status: Workflow successfully completed User Input Details: Type : End Host IP Address : 12.37.209.22 Step Details Device Connectivity Information : Device Registered with Campus Manager Rediscover : Could not Discover Device Connectivity Information : Last Seen after acquisition is same Complete Report can be viewed at : http://abcd:1741/cwa/wfReport.do?wfsessionid=xyz1230 Note: This report is not available once purge operation is done. Regards, CiscoWorks Assistant.

E-mail ID

This field is enabled only if you have selected the Notify me on Workflow Completion field. Enter an E-mail ID. You can enter multiple e-mail IDs. For example:

john@abc.com john_smith@abc.co.in

UT trigger is limited to IPv4 devices. Acquisition starting process might return failed, in case of IPv6 devices.

User Guide for CiscoWorks Assistant

4-16

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Selecting an End Host From the End Hosts List

Step 3

Click Run. The End Host/IP Phone report appears in a new window. See Understanding the End Host Down Report and Understanding the IP Phone Down Report. The report generation may take sometime. You can click Exit to return to the CiscoWorks Assistant home page.

Selecting an End Host From the End Hosts List


The End Host/IP Phone Down report is generated for only one end host at a time. During the End Host/IP Phone Down report generation, when there are more than one end hosts available for a specified input type (IP Address, Host Name, MAC Address, or User Name) value, the Multiple End Hosts page appears instead of the End Host/IP Phone Down report. The Multiple End Hosts page displays a list of all end hosts that match the specified input type. You must select an end host from the list of duplicate end hosts to generate the End Host/IP Phone Down report. By default, the first end host in the list is selected for report generation. To select an end host for generating End Host/IP Phone Down report:
Step 1

Select CiscoWorks Assistant > Workflows > End Host/IP Phone Down. The End Host/IP Phone window appears. Enter the required details as explained in Generating End Host/IP Phone Down Report. Click Run. The Multiple End Hosts page appears with the details shown in Table 4-13 if there are multiple end hosts for a specified input type (IP Address, MAC Address, Host Name, or User Name) value.

Step 2 Step 3

Table 4-13

Multiple End Hosts Page Details

Input Type IP Address

Multiple End Hosts Page displays ...

MAC Address of end hosts corresponding to the specified IP Address. Host Name of the end hosts corresponding to the specified IP Address, if there are any duplicate values or no value for MAC Address. IP Address of end hosts corresponding to the specified Host Name. MAC Address of the end hosts corresponding to the specified Host Name, if there are any duplicate values or no value for IP Address.

Or

Host Name

Or

User Guide for CiscoWorks Assistant OL-17904-01

4-17

Chapter 4 Selecting an End Host From the End Hosts List

Troubleshooting Your Network Using CiscoWorks Assistant

Table 4-13

Multiple End Hosts Page Details

Input Type MAC Address

Multiple End Hosts Page displays ...

IP Address of end hosts corresponding to the specified MAC Address. Host Name of the end hosts corresponding to the specified MAC Address, if there are any duplicate values or no value for IP Address. IP Address of end hosts corresponding to the specified User Name. MAC Address of the end hosts corresponding to the specified User Name, if there are any duplicate values or no value for IP Address. Host Name of the end hosts corresponding to the specified User Name, if there are any duplicate values or no value for MAC Address.

Or

User Name

Or

Or

If there are any duplicate values or no value for IP Address, MAC Address, and Host Name, an error message appears instead of the Multiple End Hosts page See Examples to understand the details of end hosts displayed on the Multiple End Hosts page.
Step 4 Step 5

Select an end host from the list displayed. Click OK to go to the End Host/IP Phone window. The selected end host is displayed on the Input Type field in the End Host/IP Phone window. Otherwise, click Cancel in the Multiple End Hosts page to go to the End Host/IP Phone window to enter a new value.

Step 6

Click Run to generate the End Host/IP Phone Down report with the selected end host value. See Understanding the End Host Down Report for report details.

Examples
This section contains the following examples:
Example 1

Consider your network has four end hosts configured with the details shown in Table 4-14.
:

Table 4-14

Configuration Details - Example 1

S. No. 1 2 3 4

IP Address 10.77.209.254 10.77.208.97 10.77.209.23 10.77.208.83

MAC Address 00-1a-6c-e6-46-30 00-07-ec-b9-18-54 00-04-23-22-d3-78 00-07-ec-b9-18-54

Host Name endhost1 endhost2 endhost3 endhost4

User Name endhost endhost endhost testdevice

User Guide for CiscoWorks Assistant

4-18

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Selecting an End Host From the End Hosts List

When you specify the Input Type as User Name and the value of the User Name as endhost, the Multiple End Hosts page displays the IP Address of end hosts:

10.77.209.254 10.77.208.97 10.77.209.23

You must select a IP Address from the displayed list to generate the End Host/IP Phone Down report.
Example 2

Consider your network has four end hosts configured with the details shown in Table 4-15.
Table 4-15 Configuration Details - Example 2

S. No. 1 2 3 4

IP Address 10.77.209.254 10.77.208.97 10.77.209.254 10.77.208.83

MAC Address 00-1a-6c-e6-46-30 00-07-ec-b9-18-54 00-04-23-22-d3-78 00-07-ec-b9-18-54

Host Name endhost1 endhost2 endhost3 endhost4

User Name endhost endhost endhost testdevice

When you specify the Input Type as User Name and the value of the User Name as endhost, the Multiple End Hosts page displays the MAC Address of end hosts:

00-1a-6c-e6-46-30 00-07-ec-b9-18-54 00-04-23-22-d3-78

The IP Address of the end hosts will not be displayed in the Multiple End Hosts page because there are duplicate values in IP Address. You must select a MAC Address from the displayed list to generate the End Host/IP Phone Down report.
Example 3

Consider your network has four end hosts configured with the details shown in Table 4-16.
Table 4-16 Configuration Details - Example 3

S. No. 1 2 3 4

IP Address 10.77.209.254 10.77.208.97 10.77.209.254 10.77.208.83

MAC Address 00-1a-6c-e6-46-30 00-07-ec-b9-18-54 00-04-23-22-d3-78 00-07-ec-b9-18-54

Host Name endhost1 endhost2 endhost3 endhost4

User Name endhost endhost endhost endhost

When you specify the Input Type as User Name and the value of the User Name as endhost, the Multiple End Hosts page displays the Host Name of end hosts:

endhost1 endhost2 endhost3 endhost4

User Guide for CiscoWorks Assistant OL-17904-01

4-19

Chapter 4 Understanding the End Host Down Report

Troubleshooting Your Network Using CiscoWorks Assistant

The IP Address or MAC Address of the end hosts will not be displayed in the Multiple End Hosts page because there are duplicate values. You must select a Host Name from the list to generate the End Host/IP Phone Down report.
Example 4

Consider your network has four end hosts configured with the details shown in Table 4-17.
Table 4-17 Configuration Details - Example 4

S. No. 1 2 3 4

IP Address 10.77.209.254 10.77.208.97 10.77.209.254 10.77.208.83

MAC Address 00-1a-6c-e6-46-30 00-07-ec-b9-18-54 00-04-23-22-d3-78 00-07-ec-b9-18-54

Host Name endhost1 endhost2 endhost1 endhost3

User Name endhost endhost endhost endhost

When you specify the Input Type as User Name and the value of the User Name as endhost, the Multiple End Hosts page will be displayed with Click Here link. Click the link to modify the user name details of the end host. On modifying the User Name with a unique value, the End Host/IP Phone Down report can be generated. The IP Address, MAC Address or Host Name will not be displayed in the Multiple End Hosts page because there are duplicate values.

Understanding the End Host Down Report


The algorithm used while generating the End Host Down reports is:
1. 2. 3. 4.

CiscoWorks Assistant checks whether Campus Manager Server has discovered the selected End Host. If the selected device is not managed by Campus Manager, the report generation will stop without performing the further steps. If you want to run Discovery again, select Rediscover. Campus Manager rediscovers the End Host and IP phones in the network. If you have selected the Switch Check option, then CiscoWorks Assistant will check the reachability status for the selected device to which the End Host is connected. It also checks the status of the port to which the End Host is connected to. If the device is not reachable then it automatically triggers the Device Troubleshooting workflow. Device connectivity information is limited to IPv4 devices. Since Campus Manager is not supporting IPv6 devices, CiscoWorks Assistant will also not support the same.

The End Host Down report displays the following information:


End Host Details Device Connectivity Information Status Information for the Port Rediscover

User Guide for CiscoWorks Assistant

4-20

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the IP Phone Down Report

End Host Details

Table 4-18 contains the End Host details.


Table 4-18 End Host Details

Field IP Address Host Name MAC Address User Name


Device Connectivity Information

Description IP Address of the End Host. Host name of the End Host MAC address of the End Host Name of the user for the particular host.

Table 4-19 contains information about the Campus Manager that manages the selected device.
Table 4-19 Campus Manager Details

Field IP Address MAC Address

Description IP Address of Campus Manager server. Media Access Control (MAC) address of network interface card in end-user node. The MAC Address appears in the format, xx-xx-xx-xx-xx-xx. Host name of the End Host Name of the Switch Address of the IP Switch. Port number to which the End Host is connected. 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 mm yyyy hh:mm:ss.

Host Name Switch Name Switch IP Address Port Number Last Seen

End Host Ping Status Displays the status whether the status is a success or failure.

Understanding the IP Phone Down Report


The algorithm used while generating the IP Phone Down reports is:
1. 2. 3.

CiscoWorks Assistant checks whether Campus Manager server manages this IP Phone. It does this by contacting all of the Campus Manager servers. If IP Phone is not managed by any Campus Manager servers, the report generation will stop without performing any further steps. If you have selected the Rediscover option, then CiscoWorks Assistant checks the reachability of the Cisco Call Manager (CCM) server to which the IP Phone is connected.

User Guide for CiscoWorks Assistant OL-17904-01

4-21

Chapter 4 Understanding the IP Phone Down Report

Troubleshooting Your Network Using CiscoWorks Assistant

4. 5.

CiscoWorks Assistant also checks the connection status between the CCM Server and the IP Phone. If it is not connected properly the report generation will stop without performing any further steps. If you have selected the Switch Check option, CiscoWorks Assistant checks for the reachability status for the device to which the IP Phone is connected. CiscoWorks Assistant also checks the port status of the IP Phone to find the cause for the IP Phone down.

The IP Phone Down report displays the following information:


IP Phone Details Device Connectivity Information Reachability Information for the CCM Server Connection status of IP Phone and CCM Server Status Information for the Port Reachability Check for the Switch Check Status of the Port Rediscover

IP Phone Details

Table 4-20 contains the IP Phone details.


Table 4-20 IP Phone Details

Field Phone Number

Description Phone Number of the IP Phone. This is displayed only if you have selected Phone Number as the Input Type while generating the IP Phone report.

IP Address
Device Connectivity Information

IP Address of the IP Phone.

Table 4-21 contains information about the Campus Manager to which the device is managed.
Table 4-21 Campus Manager Details

Field Phone Number

Description Phone Number of the IP Phone. This is displayed only if you have selected Phone Number as the Input Type while generating the IP Phone report.

IP Address Campus Manager MAC Address

IP Address of the IP Phone. IP Address of Campus Manager server. Media Access Control (MAC) address of network interface card in end-user node. The MAC Address appears in the format, xx-xx-xx-xx-xx-xx. IP Address of the Cisco Call Manager.

Cisco Call Manager server

User Guide for CiscoWorks Assistant

4-22

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the IP Phone Down Report

Table 4-21

Campus Manager Details

Field Switch Name Switch IP Address Port Number Last Seen IP Ping Status

Description Name of the Switch. IP Address of the Switch. Port number to which the End Host is connected. 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 mm yyyy hh:mm:ss. Displays the reachability status of the IP Phone.

Reachability Information for the CCM Server

You can view the reachability status of the CCM server. This is determined using the Ping protocol.
Connection status of IP Phone and CCM Server

You can view the connection status of the CCM server and the IP Phone.
Status Information for the Port

The status information for the port is displayed only if you have selected the Switch Check option while generating the End Host/IP Phone Down report. If you selected the Switch Check option, you can also verify the device connectivity status. If you have selected the Switch Check option, the Reachability Check for the Switch table is displayed.
Reachability Check for the Switch

Table 4-22 contains the device reachability information to which the End Host/IP Phone is connected.
Table 4-22 Device Reachability Details

Field Ping

Description Ping status of the selected device. Checks whether the device is reachable. A ping tests an ICMP echo message and its reply.

HTTP

Ping status of the selected device. Sends an HTTP request to the HTTP port 80 of the destination device.

SNMPv1/v2c Read

Status of SNMPv1/v2c Read Community string (service test, port 161) of the selected device. Sends an snmp get request to the destination device for an SNMP read test (SNMPR).

SNMPv1/v2c Write

Status of SNMPv1/v2c Write Community string (service test, port 161) of the selected device. Sends an snmp set request to the device to test SNMP write (SNMPW). Status of SNMPv3 Read credentials (service test, port 161) of the selected device. Sends an snmp get request to the destination device for an SNMP read test (SNMPR).

SNMPv3 Read

User Guide for CiscoWorks Assistant OL-17904-01

4-23

Chapter 4 Understanding the IP Phone Down Report

Troubleshooting Your Network Using CiscoWorks Assistant

Table 4-22

Device Reachability Details

Field SNMPv3 Write

Description Status of SNMPv3 Write credentials (service test, port 161) of the selected device. Sends an snmp set request to the device to test SNMP write (SNMPW). Telnet status (service test, port 23) of the selected device. Checks whether Telnet is enabled on the device and if the destination device responds to a Telnet request. It does not verify that the Telnet password in the database works.

Telnet

SSHv1

SSHv1 credentials status (service test, port 22) of the selected device. Checks whether SSH is enabled on the device. If the destination device responds to SSH requests, this also tests whether CiscoWorks server can make SSH requests to that device. It does not verify the password in the database.

SSHv2

SSHv2 credentials status (service test, port 22) of the selected device. Checks whether SSH is enabled on the device. If the destination device responds to SSH requests, this also tests whether CiscoWorks server can make SSH requests to that device. It does not verify the password in the database.

Check Status of the Port

You can view the following status of the device port:

Reclaim Unused Up and Reclaim Unused Down PortsCampus Manager queries ports that are administratively down and ports that were previously connected to an endhost but are unconnected atleast for a period of one day. Campus Manager also queries ports that are administratively up and ports that were previously connected to an endhost but are unconnected atleast for a period of one day. Reclaim Unused Up and Reclaim Unused Down reports provide information on ports that were previously connected to an endhost, but are unconnected now.

Report on Recently Down PortsCampus Manager 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.

For more information on Switch Port, see the User Guide for Campus Manager: http://www.cisco.com/en/US/products/sw/cscowork/ps563/products_user_guide_list.html
Rediscover

You can view the rediscovery information of the End Host/IP Phone. This information is available only if you have selected the Rediscover option while generating the End Host/IP Phone Down report.

User Guide for CiscoWorks Assistant

4-24

OL-17904-01

Chapter 4

Troubleshooting Your Network Using CiscoWorks Assistant Understanding the IP Phone Down Report

Using Device Selector in Troubleshooting Workflows


The Device Selector allows you to search for the devices in Device and Credential Repository (DCR). It helps you to locate the devices and perform the device management tasks quickly. With this device selector, you need not remember the device type or application group hierarchy to locate the devices. The devices are categorized under the Device Type based groups, User Defined groups, Subnet Based groups, Application Specific groups or under All Groups. The CiscoWorks Assistant uses the Common Services device selector. See the Configuring Device Selector section in the Managing Device and Credentials chapter of the User Guide for CiscoWorks Common Services Device Fault Manager 3.2 for information on using Device Selector: http://www.cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_list.html You can also access this information from Common Services Online help. From CiscoWorks help, go to CiscoWorks Common Services > Common Services > Managing Device and Credentials > Configuring Device Selector.

User Guide for CiscoWorks Assistant OL-17904-01

4-25

Chapter 4 Understanding the IP Phone Down Report

Troubleshooting Your Network Using CiscoWorks Assistant

User Guide for CiscoWorks Assistant

4-26

OL-17904-01

A P P E N D I X

Troubleshooting CiscoWorks Assistant


This section contains how to troubleshoot CiscoWorks Assistant.

Frequently Asked Questions Troubleshooting Server Setup Workflows Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Frequently Asked Questions


The following are the frequently asked questions in CiscoWorks Assistant:

Q.How do I install CiscoWorks Assistant 1.2? Q.Can I integrate CiscoWorks Assistant with other LMS application versions? Q.I am not able to view some of the information in Device Troubleshooting report. What is the issue? Q.I am not able to run the End Host/ IP Phone report. What is the problem?

Q. How do I install CiscoWorks Assistant 1.2? A. CiscoWorks Assistant 1.2 is part of LMS 3.2 image.

For more information, see Installing and Getting Started with CiscoWorks LAN Management Solution 3.2
Q. Can I integrate CiscoWorks Assistant with other LMS application versions? A. No, you can integrate CiscoWorks Assistant only with the following LMS application versions:

Common Services (CS) 3.3 CiscoView (CV) 6.1.9 Campus Manager (CM) 5.2 Resource Manager Essentials (RME) 4.3 Device Fault Manager (DFM) 3.2 Internetwork Performance Monitor (IPM) 4.2 Health and Utilization Monitor (HUM)1.2 Integration Utility 1.9

User Guide for CiscoWorks Assistant OL-17904-01

A-1

Appendix A Troubleshooting Server Setup Workflows

Troubleshooting CiscoWorks Assistant

Q. I am not able to view some of the information in Device Troubleshooting report. What is the issue? A. The Device Troubleshooting report depends on the following LMS 3.2 applications. Ensure that you

have installed all of these applications:


Campus Manager (CM) 5.2 Resource Manager Essentials (RME) 4.3 Device Fault Manager (DFM) 3.2 Health and Utilization Monitor (HUM) 1.2 Q. I am not able to run the End Host/ IP Phone report. What is the problem? A. The End Host/IP Phone report depends on Campus Manager 5.2. You must install Campus Manager

application to run this report.


Q. Can I configure a multi-server setup with local server as SSO slave? A. Yes, you can configure a multi-server setup with local server as SSO slave. When you add a server

from Manage Server, a peer certificate will be generated, which allows you to set the added server as master by selecting a checkbox.

Troubleshooting Server Setup Workflows


Table A-1 lists the errors and their recommended solutions for Server Setup workflows:
Table A-1 Error Messages for Server Setup Workflows

Error Message ID CWA026

Error Message Error while saving log level.

Probable Cause Could not save the new log level into the property file. This is because the disk space may be full or the properties file may not be available in the system.

Possible Action Ensure that there is enough free space and the properties file exists on the system.

CWA100 CWA101

Error occurred when fetching data. Could not fetch server information from the database.

Invalid XML character in the data.

Please try again later.

Server Discovery may be in Please try again. progress. Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and try again.

CWA102

Could not update the CiscoWorks Assistant database with new values. runtime process (OpsXMLDbEngine) may not be running.

User Guide for CiscoWorks Assistant

A-2

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting Server Setup Workflows

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID CWA104

Error Message Could not get the logged in user details.

Probable Cause Either:

Possible Action Please log in again.

Browser session terminated. Session timed out. Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and try again.

Or

CWA109

Could not get the CiscoWorks Assistant workflow instance details. runtime process may not be running.

CWA110

Could not fetch the details CiscoWorks Assistant from the database. database engine may not be running.

Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and please try again.

CWA111

Session was ended by another user. An operation initiated by the same user is in progress in the backend. Invalid data. ACS server is not reachable. Network Device Group does not exist in ACS server. Error while communicating with the DCRServer process. Could not login to local server as System Identity User. Could not login to the remote server as System Identity User.

Another user has ended the active session and started a new session.

Please contact the CiscoWorks Server administrator or Cisco Technical Assistance Center.

CWA112

Multiple operations cannot Please try after the operation is completed. be initiated by the same user simultaneously. Incorrect parameters passed. Please try again. ACS server may be down or Enter valid ACS server details and make sure that you may have entered the ACS server is running. invalid ACS server details. Create the Network Device group in the ACS server. Restart the DCRServer process. To do this, go to Common Services > Server > Admin > Processes and try again.

CWA116 CWA118

CWA119

CWA121

DCRServer process is not running in the LMS server.

CWA122

System Identity User details Please ensure that the System Identity User is provided is not valid. configured and try again. The server is not reachable or the System Identity User is not the same as in DCR Master server. Please ensure that the server is reachable, and the same System Identity User is configured as in DCR Master server, and try again.

CWA123

User Guide for CiscoWorks Assistant OL-17904-01

A-3

Appendix A Troubleshooting Server Setup Workflows

Troubleshooting CiscoWorks Assistant

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID CWA124

Error Message Could not fetch the auto manage mode for the servers.

Probable Cause CiscoWorks Assistant runtime process may not be running.

Possible Action Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and try again. If the problem persists, contact the CiscoWorks server administrator or Cisco Technical Assistance Center.

CWA125

Could not stop the last run CiscoWorks Assistant step. runtime process may not be running.

Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and please try again. If the problem persists, contact the CiscoWorks Server administrator or Cisco Technical Assistance Center.

CWA126 CWA127

Operation in progress for the active session. Operation timed out for local server.

Active session was created by another user.

Please try after the operation has completed. Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and please try again.

Could not get response from the local server. The local LMS server may be very slow CiscoWorks Assistant runtime process may not be running. Could not get response from the LMS server. The remote server may not be accessible or may be very slow. CiscoWorks Assistant runtime process may not be running.

Or

CWA128

Operation timed out for remote server.

Check if the OpsXMLDbEngine process is running in the local server. To do this, go to Common Services > Server > Admin > Processes. If the process is not running, restart the process and please try again.

Or

CWA129 CWA4001

Could not get the System Identity User details.

Please try again. Make sure the LMS server is reachable.

Server name: LMS server LMS server is unreachable. is not reachable.

User Guide for CiscoWorks Assistant

A-4

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting Server Setup Workflows

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID CWA4002

Error Message Cannot add peer server certificate. Invalid IP Address or server name entered for the mail server.

Probable Cause Certificate is not valid.

Possible Action Please make sure the certificate is valid. See User Guide for Common Services 3.3 for details on certificates.

CWA4003

You have entered an invalid SMTP server.

Either:

Enter a valid SMTP server name Leave the SMTP Server field blank.

Or

CWA4004

Cannot add the server.

CiscoWorks Assistant does not support the installed Common Service version.

Install the Common Services version supported by CiscoWorks Assistant.

CWA4005

Cannot add the server The selected server is part of Make sure the added server is in DCR standalone since the selected server is another multi-server setup. mode. a DCR Master of another multi-server setup. Cannot add the server Server is part of another since the selected server is multi-server setup. a DCR Slave of another multi-server setup. Cannot add the server since the selected LMS server is not reachable. Could not configure SMTP server address. Could not configure System Identity User. LMS software is not installed on the selected server or the LMS server is not running. You have entered either an invalid IP address or an invalid hostname. Make sure the server is in DCR standalone mode.

CWA4006

CWA4007

Either install LMS software or restart the LMS server.

CWA4012

Enter a valid hostname, IP address or leave the SMTP Server field blank.

CWA4013

Either the username does not Make sure that the user has System Identity User exist or the user does not privileges. have the System Identity User privileges. The DCR Master is not reachable. Either System Identity User is not configured or trust between the servers is not established by downloading the certificates. Make sure the DCR Master is reachable.

CWA4014

Could not configure the LMS server as DCR Slave. Could not configure the LMS server as Single Sign-On slave.

CWA4015

Make sure System Identity User is configured. Establish trust between the servers by adding Peer Server certificate using Common Services > Server > Security > Multi-Server Trust Management > Peer Server Certificate Setup.

CWA4017 CWA4018

Could not get response from the LMS server. Authentication with the LMS server failed.

LMS server not accessible Please make sure that the server is reachable and is from CiscoWorks Assistant. accessible with the given port and protocol. You may have entered invalid Username or Password Enter valid username and password, and try again.

User Guide for CiscoWorks Assistant OL-17904-01

A-5

Appendix A Troubleshooting Server Setup Workflows

Troubleshooting CiscoWorks Assistant

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID CWA4019

Error Message

Probable Cause

Possible Action Make sure that the certificate is valid. If not, re-generate the certificate and restart Daemon Manager

Could not fetch peer Certificate is invalid. server certificate from the LMS server. Cannot add the server

CWA4021

The selected server is in Make sure that the LMS server you have selected ACS mode and DCR Master is in non ACS mode. server is in non-ACS mode. Either:

CWA4022

No http response from LMS server

Click on the step link to see the server details.


The server may be unreachable. The server may be down

Check whether the server is reachable. Restart Daemon Manager.

Or

CWA4023 CWA4024

Cannot add peer certificate System Identity User validation failed.

Cannot connect to Host This could be because:

Please make sure that the host is reachable from this server. Ensure that:

The System Identity User you entered may not exist in the ACS server The System Identity User may not have the required privileges The ACS server may be down or not accessible.

The System Identity User is available in the ACS server. The System Identity User has all the required privileges. The ACS server is running and is accessible.

CWA4500 CWA4501

Invalid file format. File does not exist.

Data in the selected file is not in the expected format. You have selected a non-existent file or the selected file or directory does not have the required permissions. Invalid Install location.

Please see the Online help for the correct file format and reselect the file. Select a file with the required permissions.

CWA4507 CWA4508 CWA4510

Could not import from local NMS. Import from local NMS failed. You are not authorized to perform the Credential Sets task. Could not connect to ANIServer.

Enter valid install location for NMS application

NMS daemon may be down. Restart NMS daemon. You can configure Default Please log in as user with privileges to configure Credentials only if you have Default Credentials. required privileges. The ANIServer process is not running. Restart the ANIServer process. To do this, go to Common Services > Server > Admin > Processes.

CWA4511

User Guide for CiscoWorks Assistant

A-6

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting Server Setup Workflows

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID CWA4512

Error Message Could not access local NMS server with given NMS username. ANIServer is initializing.

Probable Cause Either the User does not exist in the NMS server or does not have enough privileges. ANIServer is still initializing.

Possible Action Please enter valid NMS username with required privileges.

CWA4514

Make sure that ANIServer is started and running. To do this, go to Common Services > Server > Admin > Processes Please go to the DCR master DCR Master Name to run the Server Setup workflow. Enter the details to import devices from NMS.

Local server Server Name LMS server selected to run is not the DCR master. Server Setup Workflow is DCR slave. Enter the details for importing from NMS. Enter the details for Discovery on Server Name. Invalid separators found while importing. You have not entered the details to import devices from NMS.

Details to run Discovery on Enter the details to run discovery on the selected the selected server were not server. entered. The file has invalid separators. Select a file with valid separator. File must contain only one seed device in each line. See the CiscoWorks Assistant Online help for supported import file format. Enter valid IP Address or Hostname [A-Z a-z 0-9_-].

Data is invalid IP Address or Hostname. Selected file has invalid data.

You have selected a file with Select a file with valid data format. File must an invalid data format contain only one seed device in each line. See the CiscoWorks Assistant Online help for details. Please try again.

Could not upload the file. Either the: Upload operation timed out. File selected for upload is corrupted.

Or

Username is required. Password is required. Invalid Username. Password and Confirm Password must be same. Could not validate the Username and Password.

Username field is blank Password field is blank Invalid username. The passwords you have entered do not match. Validation of the username and password failed.

Enter Username. Enter Password. Enter valid username. It should have at least five characters. Make sure both passwords are same. Enter correct username and password and try again. Enter the Hostname or the IP Address.

Hostname or IP Address is Hostname/IP Address field required. is blank.

User Guide for CiscoWorks Assistant OL-17904-01

A-7

Appendix A Troubleshooting Server Setup Workflows

Troubleshooting CiscoWorks Assistant

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID

Error Message Hostname or IP Address already exists in the Seed Devices list. Admin Username is required. Admin Password is required. Port is required. Invalid Port. Invalid CiscoWorks E-mail ID. Target is required. Time out should be an integer. Invalid Retries. Retries should be an integer. Read Community is required. Install location is required. Import From File is required.

Probable Cause Hostname/IP Address already exists in the Seed Devices list. Admin Username field is blank. Admin Password field is blank. Port field is blank Port entered is not an integer. You have entered an invalid e-mail ID. Target field is blank.

Possible Action Enter a different Hostname or IP Address.

Enter Admin Username. Enter Admin Password. Enter the Port number. Enter a valid integer for the Port. Enter valid e-mail ID. Enter Target.

Time out value entered is not Enter an integer value. an integer. Invalid or no Retry value entered. Retries entered is not an integer. Read Community field is blank. Install Location field is blank Import From File field is blank. Enter valid Retries. Valid range is 0 - 8. Enter a valid integer. Valid range is 0 - 8. Enter Read Community. Enter install location. Enter Import From File details. Select a file that exists in the server. Make sure both passwords are the same.

File name does not exist in Selected file does not exist the server. in the server. Standard Primary The passwords you have Credentials Password and entered do not match. Verify Password must be same. Standard Primary Credentials Enable Password and Verify Password must be same. The passwords you have entered do not match.

Make sure both passwords are the same.

Standard Secondary The passwords you have Credentials Password and entered do not match. Verify Password must be same.

Make sure both passwords are the same.

User Guide for CiscoWorks Assistant

A-8

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting Server Setup Workflows

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID

Error Message Standard Secondary Credentials Enable Password and Verify Password must be same. SNMP Credentials RO Community and Verify must be same. SNMP Credentials RW Community and Verify must be same. SNMP Credentials Password and Verify Password must be same. HTTP Primary Credentials Username is required.

Probable Cause The passwords you have entered do not match.

Possible Action Make sure both passwords are the same.

The community strings you have entered do not match. The community strings you have entered do not match. The passwords you have entered do not match. HTTP Primary Credentials Username field is blank

Make sure both RO community strings are the same. Make sure both RW community strings are the same. Make sure both passwords are the same.

Enter HTTP Primary Credentials Username.

HTTP Primary The passwords you have Credentials Password and entered do not match. Verify Password must be same. HTTP Secondary Credentials Username is required. HTTP Secondary Credentials Username field is blank

Make sure both passwords are the same.

Enter HTTP Secondary Credentials Username.

HTTP Secondary The passwords you have Credentials Password and entered do not match. Verify Password must be same. Invalid HTTP Port. HTTP port entered is not valid

Make sure both passwords are the same.

Enter a valid integer [1-65535]. Enter a valid integer [1-65535]. Make sure both passwords are the same.

Invalid HTTPS Port. Enter HTTPS port entered is not a valid integer. valid Auto Update Server Password and Verify Password must be same. Rx-Boot Credentials Mode Password and Verify Password must be same. Failed to get SSO Master session details. The passwords you have entered do not match. The passwords you have entered do not match.

Make sure both passwords are the same.

SSO Master is not reachable.

Make sure the SSO Master is reachable and please try again after some time. Select the methods to add the devices.

Select one or many Methods to add the devices methods to add devices to were not selected. LMS.

User Guide for CiscoWorks Assistant OL-17904-01

A-9

Appendix A Troubleshooting Server Setup Workflows

Troubleshooting CiscoWorks Assistant

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID

Error Message Enter a valid IP Address or Hostname. IP Address or Hostname exists in the list. Since the process has already completed, the e-mail cannot be sent. Page is loading.

Probable Cause No/Invalid IP Address or Hostname entered. Either the Hostname or the IP Address already exists. The process completed before the e-mail address could be updated.

Possible Action Enter valid Hostname or IP Address. Enter a different Hostname or IP Address.

Operation cannot be Please wait until the page loads completely. performed while the page is loading. One or more LMS servers in Make sure that the LMS servers are reachable and the Multi-server setup are CiscoWorks Common Services version is not reachable or has an LMS supported by CiscoWorks Assistant. version not supported by CiscoWorks Assistant.

Manage Servers task cannot be run because: 1. LMS servers is unreachable. 2. CiscoWorks Common Services version is not supported by CiscoWorks Assistant.

Change Mode to ACS task One or more LMS servers in Make sure that the LMS servers are reachable and cannot be run because: the Multi-server setup are CiscoWorks Common Services version is not reachable or has an LMS supported by CiscoWorks Assistant. LMS servers is version not supported by unreachable. CiscoWorks Assistant. CiscoWorks Common Services version is not supported by CiscoWorks Assistant. SSO Master [SSO Master] SSO master is not reachable Make sure that the SSO Master is reachable from is unreachable. from the DCR master. DCR Master and please try again. Connectivity failure with primary server Either the:

Either:

Primary ACS server is not reachable. Primary ACS server details are incorrect.

Restart ACS server. Enter valid ACS server details.

Or

Or

NDG name Network Device Group does not exist in primary server. Error while communicating with device selector.

Specified Network Device Group does not exist in the primary ACS server.

Create the Network Device Group in the primary ACS server.

Either the DCRServer or the Restart DCRServer or OGSServer processes OGSServer processes are (Common Services > Server > Admin > not running. Processes).

User Guide for CiscoWorks Assistant

A-10

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Table A-1

Error Messages for Server Setup Workflows (continued)

Error Message ID

Error Message Data unchanged. Could not fetch the DCR mode of the server.

Probable Cause

Possible Action Please edit details to configure default credentials.

CiscoWorks Common Make sure that CiscoWorks Common Services is Services version may not be supported. supported by CiscoWorks Assistant. Invalid data in DCR configuration file.

Could not fetch the DCR master details.

Common Services version may not be supported by CiscoWorks Assistant. Invalid data in DCR configuration file.

Make sure that CiscoWorks Common Services is supported.

SSO Master Server Name SSO master is not reachable Make sure that the SSO Master is reachable from is unreachable. from the DCR master. DCR Master and please try again.

Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows


The Table A-2 lists the errors and their recommended solutions for End Host/IP Phone and Device Troubleshooting workflows
Table A-2 Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA001 CWA002 CWA003

Error Message Cookie is not set. Could not log into server. Authentication failed.

Probable Cause Session is invalid. No response from server. System Identity User is not set properly.

Possible Action Please log in and try again. Check the server connection and ensure that the server is reachable. Check the username and password of the System Identity User. You can set the System Identity User in the Common Services application (Common Services > Server > Security > System Identity Setup).

CWA004 CWA005

Could not log into Slave Server. You are not authorized to access the page.

Session is invalid. You do not have the correct privileges.

Please log in and try again. Please check the Permission Report (Common Services > Server > Reports) and review the required permissions. Contact the CiscoWorks Server administrator to get the required permission.

User Guide for CiscoWorks Assistant OL-17904-01

A-11

Appendix A Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Troubleshooting CiscoWorks Assistant

Table A-2

Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA006

Error Message License expired.

Probable Cause LMS application license expired.

Possible Action Upgrade your LAN Management Solution license. Check your license status in the Common Services application (Common Services > Server > Admin > Licensing) See the User Guide for Common Services 3.3 to upgrade your license. http://www.cisco.com/en/US/products/sw/cscowo rk/ps3996/products_user_guide_list.html

CWA007

The selected device does not respond to ping.

This could occur because the Please check the device connectivity and the device may not be reachable system resources. or ICMP is disabled for the selected device. This could also occur because the response from the CiscoWorks Server is slow.

CWA008

Could not find the The device may not be Please check the device connectivity and the traceroute for the selected reached or the response from system resources. device. the CiscoWorks Server may be slow. Internal server error. The server or the tomcat processes may be down Restart the daemon manager of the server: On Windows:
1. 2.

CWA009

Enter net stop crmdmgtd Enter net start crmdmgtd Enter /etc/init.d/dmgtd stop Enter /etc/init.d/dmgtd start

On Solaris:
1. 2.

CWA010

Error while Either: communicating with DCR DCR Master is not Server. reachable or

Make sure that DCR Master is reachable. Restart the DCRServer process (Common Services > Server > Admin > Processes).

DCR Server process is not running on the LMS server. Log into the CiscoWorks server. Contact the CiscoWorks server administrator to get the required permission. Check the server connection.

CWA011 CWA012 CWA014

User session expired. ACS user does not have full privileges. No HTTP response.

You have logged out from the CiscoWorks server. Server is down.

User Guide for CiscoWorks Assistant

A-12

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Table A-2

Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA015

Error Message Workflow is not supported.

Probable Cause Server discovery workflow could not find the server information. Required application is not installed.

Possible Action Check the server connection. Install the required application. See Dependencies of CiscoWorks Assistant Application.

CWA016 CWA019

HTTP parse error. Could not find Device information in RME

Could not access the device selector.

Restart these processes:


CMFOGSServer CampusOGSServer RMEOGSServer

To do this, go to Common Services > Server > Admin > Processes. CWA020 Switch IP address for the specified End Host /IP Phone is not available. IP address of the device to which the End Host/IP Phone node is connected is Null in the report.
1.

Run Campus Manager Data Collection for the device to which the End Host/IP Phone node is connected. Run UT Acquisition.

2.

See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html CWA021 Port number of the switch Device port connected to the to which specified End host is null. Host/IP Phone connected is not available.
1.

Run Campus Manager Data Collection for the device to which the End Host/IP Phone node is connected. Run UT Acquisition.

2.

See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html CWA022 VLAN ID for the specified End Host is not available. VLAN ID associated with port is null.
1.

Run Campus Manager Data Collection for the device to which the End Host/IP Phone node is connected. Run UT Acquisition.

2.

See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html

User Guide for CiscoWorks Assistant OL-17904-01

A-13

Appendix A Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Troubleshooting CiscoWorks Assistant

Table A-2

Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA023

Error Message Could not find the Last Seen information for the specified End Host /IP Phone.

Probable Cause

Possible Action

Date and time when User Run UT Acquisition for the device to which the Tracking last found an entry End Host/IP Phone node is connected. for End Host /IP Phone in a See the User Guide for Campus Manager 5.2 at switch is null. this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html

CWA024

Campus Manager is not managing the specified End Host/IP Phone.

Discover the End Host / IP Phone in Campus Manager and run the workflow. See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html

CWA025

Could not launch the workflow.

CiscoWorks Assistant engine may not be running

Restart the daemon manager of the server: On Windows:


Enter net stop crmdmgtd Enter net start crmdmgtd Enter /etc/init.d/dmgtd stop Enter /etc/init.d/dmgtd start

On Solaris:

CWA026

Error while saving the log Could not save the new log level. level into the property file. This is because the disk space may be full or the properties file may be available in the system.

Ensure that there is enough free space and the properties file exists on the system.

CWA027

CiscoWorks Assistant does not support the installed Campus Manager version. CiscoWorks Assistant does not support the installed Device Fault Manager version. CiscoWorks Assistant does not support the installed Resource Manager Essentials version.

You have installed an unsupported version of the application. You have installed an unsupported version of the application. You have installed an unsupported version of the application.

Upgrade Campus Manager to the version supported by CiscoWorks Assistant.

CWA028

Upgrade Device Fault Manager to version supported by CiscoWorks Assistant.

CWA029

Upgrade Resource Manager Essentials to version supported by CiscoWorks Assistant.

User Guide for CiscoWorks Assistant

A-14

OL-17904-01

Appendix A

Troubleshooting CiscoWorks Assistant Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Table A-2

Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA030

Error Message CiscoWorks Assistant does not support the installed Internetwork Performance Monitor version. CiscoWorks Assistant does not support the installed Integration Utility version. CiscoWorks Assistant does not support the installed CiscoView version. CiscoWorks Assistant does not support the installed Common Services version Cannot get the device information.

Probable Cause You have installed an unsupported version of the application.

Possible Action Upgrade Internetwork Performance Monitor to version supported by CiscoWorks Assistant.

CWA031

You have installed an unsupported version of the application. You have installed an unsupported version of the application. You have installed an unsupported version of the application. Either:

Upgrade Integration Utility to version supported by CiscoWorks Assistant.

CWA032

Upgrade CiscoView to version supported by CiscoWorks Assistant.

CWA033

Upgrade Common Services to version supported by CiscoWorks Assistant.

CWA034

Make sure that DCR Master is reachable. Restart the DCRServer and CMFOGSServer processes (Common Services > Server > Admin > Processes).

DCR Master is not reachable DCR Server process is not running on the LMS server.

or

CWA035

Cannot run the Troubleshooting workflow while Server Addition is in progress.

The Server Addition process Complete the Server Setup workflow and then of the Server Setup re-run the Troubleshooting workflow. workflow is running.

CWA036

Cannot run the Server The Server Addition process Complete the Server Setup workflow and then Discovery workflow while of the Server Setup re-run the Trouble shooting workflow. Server Addition is in workflow is running. progress. Install Campus Manager before running the End Host/IP Phone workflow. The End Host/IP Phone workflow does not support the installed version of Campus Manager Campus Manager is not installed You have installed an unsupported version of Campus Manager. Install Campus Manager and re-run the End Host/IP Phone workflow. Install the correct version of Campus Manager.

CWA037

CWA038

User Guide for CiscoWorks Assistant OL-17904-01

A-15

Appendix A Troubleshooting End Host/IP Phone and Device Troubleshooting Workflows

Troubleshooting CiscoWorks Assistant

Table A-2

Error Messages for End Host/IP Phone and Device Troubleshooting Workflows

Error Message ID CWA039

Error Message Device must have IP Address or Hostname information in DCR for Device Troubleshooting to continue. CiscoWorks Assistant does not support the installed Health Monitor Utilization version.

Probable Cause

Possible Action

IP Address or Host name is Set an IP Address or Host Name for the selected not available in the DCR for device in DCR. a selected device.

CWA040

You have installed an unsupported version of Health Monitor Utilization.

Install the correct version of Health Monitor Utilization.

Device IP address is Null.

1. 2.

Run Discovery for the device to which the End Host/IP Phone node is connected. Run UT Acquisition.

See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html Device Name is Null.
1. 2.

Run Discovery for the device to which the End Host/IP Phone node is connected. Run UT Acquisition.

See the User Guide for Campus Manager 5.2 at this location: http://www.cisco.com/en/US/products/sw/cscowo rk/ps563/products_user_guide_list.html

User Guide for CiscoWorks Assistant

A-16

OL-17904-01

INDEX

A
ACS configure
3-49 3-51 3-50

Configure Device Credential Policies

3-6 3-24

Configuring Device Credentials Policies

updating configuration viewing mode result Add Devices Allocating device groups Auto allocation
3-15 3-15 3-6

D
Deleting Device Credentials Policy Device
3-24 3-25

Adding a Device Credentials Policy

assigning

3-52 4-13 4-10

Device Availability

Device Credential verification report Device groups allocation


3-16 3-15

Auto Allocation Summary report

Devices adding
3-27 3-27 3-28 3-30

C
Call Home cautions significance of CDA report
4-10 4-7 3-6 i-xii 4-10

adding devices using bulk import from file adding devices using bulk import from NMS information managing trace route viewing
4-4 3-41 4-5

adding using common services device discovery

reachability check
4-6 3-40 4-14

CDP Neighbors

Change ACS Setup Dependencies Getting Started Launching launching Online help Processes short-cuts Workflows workflows
2-1 2-1 2-6 2-5 2-4

CiscoWorks Assistant
1-5 2-5

Device Threshold DFM Alerts Discrepancy


4-7 4-12

Device Troubleshooting Report

4-4

Dependency processes
2-1

E
Editing a Default Credential Set
2-4 3-22 3-25

Editing a Device Credentials Policy Embedded Event Manager End Host Down report Error messages
4-20 4-10

User Privileges
1-4 2-3

User Guide for CiscoWorks Assistant OL-17904-01

IN-1

Index

Server Setup workflow

A-2

S
Server Details
3-7 3-1 3-6 2-4 3-18

F
Filter Settings tab
3-35

Server Setup Workflow Set Default credentials Setting Debug Level

Setting Default Credential Sets

G
Generic OnLine Diagnostics Global Settings tab
3-36 4-10

Setting up ACS Mode


3-44 3-13

Device Management Mode System Identity User Single Sign On


3-3 3-13

L
Last Configuration change Launching Online help
2-6 4-8

SNMP deleting V2 V2parameter V3


3-41 3-38 3-32 3-41 3-38

V3parameter

M
Manage Devices Manage Servers
3-6 3-6

SNMP setting tab standalone Summary


3-53 3-3

operation

3-54

O
Order of Device Credential Policies Overview CiscoWorks Assistant
1-1 3-26

server summary ACS

3-53

3-54 4-6 3-2

syslog messages

system identity setup

P
peer server account setup peer server certificate setup
3-2 3-2

T
Troubleshooting CiscoWorks Assistant Device Troubleshooting, End Host, IP Phone
A-11 A-2,

R
Report End Host/IP Phone down
4-15

Troubleshooting workflows Device Troubleshooting End Host/IP Phone Down


4-1 4-15

User Guide for CiscoWorks Assistant

IN-2

OL-17904-01

Index

U
Understanding reports Device Troubleshooting End Host Down IP Phone Down
4-20 4-21 4-4

V
Viewing Credential Sets Status
3-23

Viewing Device Credentials Policy Configuration Status 3-26

User Guide for CiscoWorks Assistant OL-17904-01

IN-3

Index

User Guide for CiscoWorks Assistant

IN-4

OL-17904-01

You might also like