Cisco Network Building Mediator Manager User Guide Release 1.1.3 January, 2012 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-21089-04 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. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R) Cisco Network Building Mediator Manager User Guide © 1999–2012 Cisco Systems, Inc. All rights reserved. Send documentation comments to [email protected] CONTENTS New and Changed Information xiii Preface xv Audience xv Organization xv Document Conventions xvi Related Documentation xvii Obtaining Documentation and Submitting a Service Request xvii Cisco Network Building Mediator Manager Documentation Roadmap xix CHAPTER 1 Introduction 1-1 Overview 1-1 Mediator Manager System 1-1 Mediator Manager 6300 Platform 1-2 Mediator Manager Framework 1-2 CHAPTER 2 Getting Started 2-1 Prerequisites 2-1 Hardware Requirements 2-1 General Guidelines 2-1 Setting Up the Mediator Manager 2-2 Connecting the Mediator Manager 2-2 Configuring the Mediator Manager 2-4 Configuring the Hostname and IP Address 2-4 Configuring the Date and the Time 2-4 Upgrading the Mediator Manager 2-5 Downloading the Installation Image File 2-5 Extracting the Installation Image File Contents 2-5 Copying the Installation Image File 2-6 Upgrading the Mediator Manager 2-7 Verifying the Mediator Manager Framework 2-8 Recovering the Mediator Manager 2-8 Modifying User Accounts 2-9 Cisco Network Building Mediator Manager User Guide OL-21089-04 iii Contents Send documentation comments to [email protected] Username Guidelines 2-9 Password Guidelines 2-10 CHAPTER 3 Licensing Requirements 3-1 General Information on Licenses 3-1 License Versions 3-1 Product Configuration 3-2 Ordering Information 3-2 Licenses for Points 3-2 Viewing Licensing Details 3-3 CHAPTER 4 Using configTOOL 4-1 Overview 4-1 Installing configTOOL 4-1 Prerequisites 4-2 Installation Instructions 4-2 Starting configTOOL 4-3 configTOOL Interface 4-3 About Interface Elements 4-3 Using Interface Elements 4-4 Node Tree Right-Click Menu 4-4 configTOOL Tabs 4-5 View Selection Tabs 4-7 Status Bar 4-7 Mediator Units Window 4-8 Specifying the Node Path 4-10 Using the Tooltips and Keyboard Shortcuts 4-10 Customizing the configTOOL Interface 4-11 Accessing Mediators Using configTOOL 4-11 Connecting to a Local Mediator Manager 4-11 Connecting to a Remote Mediator Manager 4-12 Restarting and Rebooting the Mediator Manager 4-12 Managing Remote Mediators 4-13 About Host Management 4-13 Adding a Host Manager 4-13 Adding a Remote Host 4-13 Viewing Nodes 4-14 Using Snippets 4-15 Cisco Network Building Mediator Manager User Guide iv OL-21089-04 Contents Send documentation comments to [email protected] Creating a Snippet 4-15 Importing a Snippet 4-15 Configuring Logs and Exporters 4-15 Configuring Logs 4-16 Configuring Exporters 4-18 Defining Exporters 4-19 Defining Formatters 4-22 Defining Transporters 4-27 Managing Mediator Manager Configuration Files 4-30 Opening Mediator Manager Configuration Files 4-31 Accessing the Open Mediator Submenu 4-31 Stored Configuration File 4-31 Configuration File from the Network 4-31 Configuration File from the Recently Opened Mediator List 4-32 Configuration File from the Favorites List 4-32 Working with the Configuration File XML Code 4-33 Displaying the Configuration File XML Code 4-33 Saving Partial Configuration File XML Code to a File 4-33 Importing Partial Configuration File XML Code to a Node 4-34 Displaying Node Values 4-34 Refreshing the Current Configuration 4-35 Creating an Offline Configuration File 4-35 Saving Mediator Manager Configuration Files 4-36 Saving an Existing Configuration File 4-36 Saving a New Configuration File 4-36 Validating a Configuration 4-36 Exiting the configTOOL 4-36 Uninstalling the configTOOL 4-37 CHAPTER 5 Using perfectHOST 5-1 Overview 5-1 perfectHOST Templates 5-2 Programming Graphics 5-2 Templates and Macros 5-2 Installing perfectHOST 5-3 Prerequisites 5-3 Installation Instructions 5-3 Creating perfectHOST Applications 5-4 Connecting to the Mediator Manager with perfectHOST 5-4 Cisco Network Building Mediator Manager User Guide OL-21089-04 v Contents Send documentation comments to [email protected] Templates and Macro Groups 5-5 Default Templates and Macro Groups 5-6 Most Frequently Used Templates 5-25 absolute 5-27 add 5-27 alarm 5-28 and 5-29 _ao 5-30 _ao_v 5-31 db-cool 5-32 db-heat 5-33 delayon 5-34 delayoff 5-35 _di_on 5-35 div 5-36 dlystart 5-37 _do 5-38 edgedet 5-39 gtthan 5-40 _hoa 5-41 hours 5-41 latch 5-42 latchmax 5-43 latchmin 5-44 ltthan 5-45 minon 5-46 minutes 5-47 multiply 5-48 not 5-49 or 5-49 override1hr 5-50 _p593-3h20 5-51 pid-cool 5-52 pid-heat 5-53 reset 5-54 select 5-55 _setpnt10k 5-56 _st-s3 5-57 _setpntspl 5-57 _st-s3ao 5-58 Cisco Network Building Mediator Manager User Guide vi OL-21089-04 Contents Send documentation comments to [email protected] setresest 5-58 sqrt 5-59 sub 5-60 timeclok 5-60 timepro2at 5-61 trigger 5-62 trimmer 5-63 Adding Templates 5-64 MPX_GET Template 5-64 MPX_SET Template 5-65 Trimmer Template 5-65 Number Template 5-66 Alarm Template 5-67 Schedule Template 5-67 Connecting Templates 5-67 Saving and Compiling a perfectHOST Application 5-68 Creating HTML Monitor Drawings 5-69 Downloading the perfectHOST Application and HTML Drawing to the Mediator Manager 5-69 Viewing perfectHOST HTML Drawings on the Mediator Manager 5-70 Uninstalling perfectHOST 5-70 CHAPTER 6 Ports and Protocols 6-1 About Ports 6-1 About Protocol 6-1 Understanding Secure Remote Node Abstraction Protocol 6-1 Configuring Secure Remote Node Abstraction Protocol 6-2 CHAPTER 7 Getting Started with Mediator Manager Web Client 7-1 System Requirements 7-1 Launching Mediator Manager Web Client 7-1 Understanding Mediator Manager Web Client 7-2 CHAPTER 8 Managing Events 8-1 About Events 8-1 About Event Manager 8-1 About Alarms 8-3 About Triggers 8-4 About Targets 8-5 Cisco Network Building Mediator Manager User Guide OL-21089-04 vii Contents Send documentation comments to [email protected] Types of Alarm Triggers 8-5 About Alarm Exporters 8-6 About Sources 8-7 About Formatters 8-7 About Transporters 8-7 About Global Alarms 8-7 About RSS Feeds 8-8 Using Event Manager 8-8 Filtering Events 8-8 Sorting Events 8-9 Managing Alarms 8-9 Creating Alarms 8-10 Editing Alarms 8-10 Triggering Alarms 8-10 Clearing Alarms 8-11 Deleting Alarms 8-11 Managing Triggers 8-11 Creating Triggers 8-12 Editing Triggers 8-12 Editing Comparison Triggers 8-12 Editing Bound Triggers 8-13 Configuring Targets 8-13 Deleting Triggers 8-14 Managing Alarm Exporters 8-14 Creating Alarm Exporters 8-14 Editing Alarm Exporters 8-15 Adding Exporter Sources 8-15 Editing Exporter Formatter 8-16 Adding Exporter Transporter 8-16 SMTP Exporter Transporter 8-16 FTP Exporter Transporter 8-17 SFTP Exporter Transporter 8-18 Deleting Exporter Transporter 8-18 Managing Global Alarms 8-18 Creating a new Peer/Portal 8-18 Deleting a Peer/Portal 8-19 Checking RSS Feeds 8-19 Cisco Network Building Mediator Manager User Guide viii OL-21089-04 Contents Send documentation comments to [email protected] CHAPTER 9 Managing Security 9-1 About Security Elements 9-1 About Roles 9-2 About Users 9-3 About Policies 9-4 Managing Roles 9-5 Adding Roles 9-6 Deleting Roles 9-6 Managing Users 9-6 Creating Users 9-7 Changing Password Restrictions 9-7 Editing Users 9-8 Editing User Roles 9-9 Deleting Users 9-9 Managing Policies 9-10 Adding Policies 9-10 Editing Policies