User Guide for CiscoWorks Common Services 3.0 CiscoWorks Corporate 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 526-4100 Customer Order Number: DOC-7816571 Text Part Number: 78-16571-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 UCB's 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. CCSP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, SwitchProbe, TeleRouter, The Fastest Way to Increase Your Internet Quotient, TransPath, and VCO 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. (0411R) User Guide for CiscoWorks Common Services Copyright © 1998-2005 Cisco Systems, Inc. All rights reserved. CONTENTS Preface xiii Audience xiii Conventions xiii Product Documentation xiv Related Documentation xvi Additional Information Online xvi Obtaining Documentation xvi Cisco.com xvii Ordering Documentation xvii Documentation Feedback xviii Obtaining Technical Assistance xviii Cisco Technical Support Website xviii Submitting a Service Request xix Definitions of Service Request Severity xx Obtaining Additional Publications and Information xx 1 CHAPTER Overview 1-1 New Features 1-2 Understanding Time Zone Settings 1-3 Learning More About the Common Services 1-3 User Guide for CiscoWorks Common Services 78-16571-01 iii Contents CHAPTER 2 Interacting With CiscoWorks Homepage 2-1 Invoking CiscoWorks Homepage 2-2 Invoking CWHP in Normal Mode (HTTP) 2-2 Invoking CWHP in SSL Enabled Mode (HTTPS) 2-3 Logging Into CiscoWorks 2-4 Using CWHP 2-5 Common Services Panel 2-5 Application Panels 2-6 Supporting Applications on Another Server 2-6 Supporting Traditional Applications With New Navigation 2-7 Device Troubleshooting Panel 2-7 Resources Panel 2-7 CiscoWorks Product Updates Panel 2-7 Tool Bar Items 2-8 Configuring CWHP 2-8 Registering Applications With CWHP 2-8 Registering a New Application 2-9 Importing from other servers 2-10 Unregistering an Application 2-11 Registering Links With CWHP 2-11 Unregistering a Link 2-12 Setting Up CiscoWorks Homepage 2-12 Using Online Help 2-13 Changing Web Server Port Numbers 2-14 CHAPTER 3 Configuring the Server 3-1 Setting up Security 3-1 Managing Security in Single Server Mode 3-1 User Guide for CiscoWorks Common Services iv 78-16571-01 Contents Setting up Browser-Server Security 3-2 Enabling Browser-Server Security From the CiscoWorks Server 3-2 Enabling Browser-Server Security From the Command Line Interface (CLI) 3-4 About User Accounts 3-4 Understanding Security Levels 3-5 Setting up Local Users 3-6 Modifying Your Profile 3-6 Adding a User 3-7 Editing User Profiles 3-8 Deleting a User 3-8 Creating Self Signed Certificate 3-9 Managing Security in Multi-Server Mode 3-10 Setting up Peer Server Account 3-11 Setting up System Identity Account 3-13 Setting up Peer Server Certificate 3-14 Deleting Peer Certificates 3-15 Enabling Single Sign-On 3-15 Navigating Through the SSO Domain 3-16 Registering Server Links 3-17 Launching a new Browser Instance 3-17 Changing the Single Sign-On Mode 3-18 Setting up the AAA Mode 3-20 About Common Services Authentication 3-21 Cisco Secure ACS Support for Common Services Client Applications 3-22 Setting the Login Module to Non-ACS 3-24 Changing Login Module to CiscoWorks Local 3-25 Changing Login Module to IBM SecureWay Directory 3-25 Changing Login Module to KerberosLogin 3-27 User Guide for CiscoWorks Common Services 78-16571-01 v Contents Changing Login Module to Local Unix System 3-28 Changing Login Module to Local NT System 3-29 Changing Login Module to MS Active Directory 3-29 Changing Login Module to Netscape Directory 3-30 Changing Login Module to Radius 3-32 Changing Login Module to TACACS+ 3-33 Understanding Fallback Options for Non-ACS mode 3-35 Setting the Login Module to ACS 3-35 Assigning Privileges in ACS 3-38 Creating and Modifying Roles in ACS 3-39 Resetting Login Module 3-42 Understanding Fallback Options for ACS Mode 3-43 Managing Cisco.com Connection 3-44 Setting up Cisco.com User Account 3-44 Setting Up the Proxy Server 3-44 Generating Reports 3-45 Log File Status Report 3-45 Permissions Report 3-46 Users Logged In Report 3-47 Process Status Report 3-48 Viewing Audit Log Report 3-49 Administering Common Services 3-51 Using Daemon Manager 3-52 Restarting Daemon Manager on Solaris 3-52 Restarting Daemon Manager on Windows 3-53 Managing Processes 3-53 Viewing Process Details 3-54 Starting a Process 3-54 Stopping a Process 3-55 User Guide for CiscoWorks Common Services vi 78-16571-01 Contents Backing Up Data 3-55 Backing up Using CLI 3-57 Data Backed up During CS 3.0 Backup 3-57 Restoring Data 3-58 Restoring Data on UNIX 3-59 Restoring Data on Windows 3-60 Data Restored from Common Services 3.0 Backup Archive 3-61 Data Restored from Common Services 2.2 Backup Archive 3-62 Data Restored from CD One 5th Edition Backup Archive 3-62 Effects of Backup-Restore on DCR 3-63 Master -Slave Configuration Prerequisites and Restore Operations 3-66 Effects of Backup-Restore on Groups 3-67 Licensing CiscoWorks Applications 3-68 Obtaining a License for CiscoWorks Applications 3-68 Licensing the Application 3-69 Viewing License Information 3-70 Updating Licenses 3-70 Collecting Server Information 3-71 Collecting Self Test Information 3-72 Messaging Online Users 3-72 Managing Jobs 3-73 Managing Resources 3-76 Maintaining Log Files 3-78 Maintaining Log Files on UNIX 3-78 Maintaining Log Files on Windows 3-80 Using Logrot 3-81 Configuring Logrot 3-81 Running Logrot 3-82 Modifying System Preferences 3-83 User Guide for CiscoWorks Common Services 78-16571-01 vii Contents CHAPTER 4 Managing Device and Credentials 4-1 DCR Architecture 4-5 Master DCR 4-6 Slave DCR 4-6 Standalone DCR 4-6 Using the Device and Credential Admin 4-7 Managing Devices 4-7 Adding Devices 4-8 Standard Type 4-9 Auto Update Type 4-10 Cluster Managed Type 4-11 Deleting Devices 4-12 Editing Device Credentials 4-13 Importing Devices and Credentials 4-14 Import Using DCA Interface 4-15 Exporting Devices and Credentials 4-18 Export Using DCA Interface 4-19 Excluding Devices 4-21 A Sample CSV Exclude File 4-21 Viewing Devices List 4-22 Generating Reports in DCA 4-23 Managing Auto Update Servers 4-24 Adding Auto Update Server 4-24 Editing Auto Update Server 4-25 Deleting Auto Update Server 4-25 User Guide for CiscoWorks Common Services viii 78-16571-01 Contents Administering Device and Credential Repository 4-26 Changing DCR Mode 4-26 Master-Slave Configuration Prerequisites 4-27 Changing the Mode to Standalone 4-27 Changing the Mode to Master 4-28 Changing the Mode to Slave 4-28 Adding User-defined Fields 4-29 Renaming User-defined Fields 4-30 Deleting User-defined Fields 4-31 Sample CSV File 4-31 A Sample CSV 2.0 File 4-31 A Sample CSV 3.0 File 4-32 Sample CSV 3.0 File for Auto Update Server Managed Devices 4-33 Sample CSV 3.0 File for Cluster Managed Devices 4-34 Mapping CSV 2.0 to CSV 3.0 Fields 4-35 Sample XML File 4-36 Sample XML File (Standard) 4-36 Sample XML File for Auto Update Server Managed Devices 4-37 Sample XML File for Cluster Managed Devices 4-38 Using DCR Features Through CLI 4-39 Adding Devices Using dcrcli 4-39 Deleting Devices Using dcrcli 4-39 Editing Devices Using dcrcli 4-40 Listing the Attributes 4-40 Viewing the Current DCR Mode Using dcrcli 4-41 Viewing Device Details 4-41 Changing DCR Mode Using dcrcli 4-42 Import Using CLI 4-43 Export Using CLI 4-44 User Guide for CiscoWorks Common Services 78-16571-01 ix Contents Implications of ACS Login Module on DCR 4-45 Custom Roles and DCR 4-45 5 CHAPTER Administering Groups 5-1 Group Concept 5-2 Group Hierarchy 5-2 Dynamic Group 5-3 Static Group 5-3 Container Groups 5-3 System-defined and User-defined Groups 5-3 Common Groups and Shared Groups 5-4 Secure Views 5-6 Groups in a Single-Server Setup 5-7 Groups in Multi-Server Setup 5-7 DCR Mode Changes and Group behavior 5-10 Unregistering a Slave 5-13 Group Administration 5-14 Creating Groups 5-14 Specifying Group Properties 5-15 Defining Group Rules 5-17 Assigning Group Membership 5-18 Removing Devices 5-19 Viewing Group Details 5-19 Modifying Group Details 5-20 Refreshing Groups 5-22 Deleting Groups 5-22 System Defined and User Defined Attributes 5-23 User Guide for CiscoWorks Common Services x 78-16571-01 Contents CHAPTER 6 Using Device Center 6-1 Launching Device Center 6-2 Invoking Device Center 6-3 Using Device Center Functions 6-3 Device Selector 6-4 Device Summary 6-4 Management Functions 6-5 Enabling Debugging Tools 6-5 Checking Device Connectivity 6-6 Using Ping 6-8 Using Traceroute 6-9 Using SNMP Walk 6-9 Using SNMP Set 6-11 Using Packet Capture 6-12 Creating a New Packet Capture File 6-13 Editing Device Credentials 6-15 Displaying Reports 6-15 Performing Management Tasks 6-15 CHAPTER 7 Working With Software Center 7-1 Performing Software Updates 7-2 Performing Device Update 7-4 Deleting Packages 7-6 Scheduling Device Package Downloads 7-7 Viewing Activity Logs 7-9 User Guide for CiscoWorks Common Services 78-16571-01 xi Contents CHAPTER 8 Diagnosing Problems With CiscoWorks Server 8-1 Verifying Server Status 8-1 Testing Device Connectivity 8-4 Troubleshooting the CiscoWorks Server 8-6 Frequently Asked Questions 8-6 Troubleshooting Suggestions 8-33 APPENDIX A Understanding CiscoWorks Security A-1 General Security A-2 Server Security A-2 Server­Imposed Security A-2 Files, File Ownership, and Permissions A-3 Runtime A-4 Remote Connectivity A-5 Access to Systems Other Than the CiscoWorks Server A-6 Access Control A-6 System Administrator-Imposed Security A-7 Connection Security A-7 Security Certificates A-7 Terms and Definitions A-8 INDEX User Guide for CiscoWorks Common Services xii 78-16571-01 Preface This document describes CiscoWorks Common Services 3.0 and gives an overview of the features and functions provided by CiscoWorks Common Services. Audience This manual is for network administrators who need to configure and maintain CiscoWorks Common Services. Most of the tools and applications described are available only to systems administrators. Conventions This document uses the following conventions: Item Commands and keywords Variables for which you supply values Displayed session and system information Informa ...