Cisco CNS NetFlow Collection Engine Installation and Configuration Guide, 5.0.2 February, 2005 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
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.
CONTENTS Supplemental License Agreement v Supplemental License Agreement For Cisco Systems Network Management Software: Cisco NetFlow Collection Engine v Additional License Restrictions v Installation and Use v Reproduction and Distribution v Description Of Other Rights and Limitations About This Guide Objective vii Audience vii vi vii How This Guide Is Organized Command Syntax Conventions viii viii Obtaining Documentation viii World Wide Web viii Ordering Documentation ix Documentation Feedback i
Contents Report Generator BGP Peer 1-7 CHA PTER 2 1-7 Installing CNS NetFlow Collection Engine Verifying System Requirements 2-1 2-1 Using the CNS NetFlow Collection Engine Installation Script Installing on a Solaris or HP-UX Platform CHA PTER 3 2-3 Installing on a Red Hat Enterprise Linux Platform 2-7 Uninstalling CNS NetFlow Collection Engine 5.
Supplemental License Agreement Supplemental License Agreement For Cisco Systems Network Management Software: Cisco NetFlow Collection Engine IMPORTANT–READ CAREFULLY: This Supplemental License Agreement (“SLA”) contains additional limitations on the license to the Software provided to Customer under the Software License Agreement between Customer and Cisco. Capitalized terms used in this SLA and not otherwise defined herein shall have the meanings assigned to them in the Software License Agreement.
Supplemental License Agreement Additional License Restrictions Description Of Other Rights and Limitations Please refer to the Cisco Systems, Inc. Software License Agreement. Cisco CNS NetFlow Collection Engine Installation and Configuration Guide, Release 5.0.
About This Guide Objective The Cisco CNS NetFlow Collection Engine Installation and Configuration Guide, Release 5.0.2 describes the CNS NetFlow Collection Engine application, which is used with the NetFlow services data export feature on Cisco routers and Catalyst 5000 and 6000 series switches. This document also describes the system requirements that must be met to install the CNS NetFlow Collection Engine product, as well as, how to install, start, and configure CNS NetFlow Collection Engine.
About This Guide How This Guide Is Organized How This Guide Is Organized This guide is organized as follows: Chapter 1, “Overview,” describes the CNS NetFlow Collection Engine application. Chapter 2, “Installing CNS NetFlow Collection Engine,” describes how to install the CNS NetFlow Collection Engine. Chapter 3, “Configuring CNS NetFlow Collection Engine,” describes how to configure CNS NetFlow Collection Engine and then validate that it s operating properly. An Index is also provided.
About This Guide Obtaining Technical Assistance Ordering Documentation Cisco documentation is available in the following ways: • Registered Cisco Direct Customers can order Cisco product documentation from the Networking Products MarketPlace: http://www.cisco.com/cgi-bin/order/order_root.pl • Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription Store: http://www.cisco.com/go/subscription • Nonregistered Cisco.
About This Guide Obtaining Technical Assistance • Download and test software packages • Order Cisco learning materials and merchandise • Register for online skill assessment, training, and certification programs You can self-register on Cisco.com to obtain customized information and service. To access Cisco.com, go to the following URL: http://www.cisco.
About This Guide Obtaining Technical Assistance Cisco TAC Escalation Center The Cisco TAC Escalation Center addresses issues that are classified as priority level 1 or priority level 2; these classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer will automatically open a case.
About This Guide Obtaining Technical Assistance Cisco CNS NetFlow Collection Engine Installation and Configuration Guide, Release 5.0.
C H A P T E R 1 Overview This chapter describes the CNS NetFlow Collection Engine application, which is used with the NetFlow services data export feature on Cisco routers and Catalyst 5000 and 6000 series switches.
Chapter 1 Overview What Are NetFlow Services? Catalyst 5000 series switches can identify flows by looking at a subset of these fields. For example, they can identify flows by source and destination address only. Note For Catalyst 5000 series switches, the analog to NetFlow services is integrated Multilayer Switching (MLS) management.
Chapter 1 Overview What Are NetFlow Services? • Version 5 datagrams, up to 30 flows can be sent in a single UDP datagram of approximately 1500 bytes. • Version 7 datagrams, up to 27 flows can be sent in a single UDP datagram of approximately 1500 bytes. • Version 8 datagrams, the number of flows sent in a single UDP datagram varies by aggregation scheme. • Version 9 datagrams, the number of flows is variable, and depends on the number and size of fields defined in one or more templates.
Chapter 1 Overview What Is CNS NetFlow Collection Engine? Caution Throughout this publication there are numerous examples of CNS NetFlow Collection Engine input commands and output results. Included are examples of IP addresses. Be aware that IP address examples are not usable IP addresses. The examples do not represent real-life configurations.
Chapter 1 Overview CNS NetFlow Collection Engine Architectural Overview CNS NetFlow Collection Engine collects and summarizes (aggregates) data into data files based on user-defined criteria specified in a CNS NetFlow Collection Engine aggregator. An aggregator is an aggregation task defined by a set of user-configurable attributes that specify how CNS NetFlow Collection Engine summarizes the traffic flows that are received.
Chapter 1 Overview CNS NetFlow Collection Engine Architectural Overview CNS NetFlow Collection Engine System Architecture 3rd party applications PerfE (PE-PE reports) (FTP, NFS) CNS/XML interface; events NFC 5.
Chapter 1 Overview CNS NetFlow Collection Engine Architectural Overview CNS/XML Interface The CNS/XML Interface is used to send and receive configuration/control requests and responses, and unsolicited event notifications. The CNS/XML interface uses the CNS Integration Bus to communicate with clients.
Chapter 1 Overview CNS NetFlow Collection Engine Architectural Overview Cisco CNS NetFlow Collection Engine User Guide, Release 5.0.
C H A P T E R 2 Installing CNS NetFlow Collection Engine This chapter describes how to install Cisco CNS NetFlow Collection Engine. This chapter includes the following sections: • Verifying System Requirements, page 2-1 • Using the CNS NetFlow Collection Engine Installation Script, page 2-2 • Installing on a Solaris or HP-UX Platform, page 2-3 • Installing on a Red Hat Enterprise Linux Platform, page 2-7 • Uninstalling CNS NetFlow Collection Engine 5.
Chapter 2 Installing CNS NetFlow Collection Engine Using the CNS NetFlow Collection Engine Installation Script For more information on planning and managing memory usage, see the“Tuning Memory Usage”section of the Cisco CNS NetFlow Collection Engine User Guide. For more information on planning and managing disk space usage, see the “Managing Disk Space” section of the Cisco CNS NetFlow Collection Engine User Guide.
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Solaris or HP-UX Platform Installing on a Solaris or HP-UX Platform The procedure for installing CNS NetFlow Collection Engine on Solaris and HP-UX are nearly identical. The primary difference is in the output written by the platform installation programs (pkgadd on Solaris and swinstall on HP-UX.
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Solaris or HP-UX Platform The following example illustrates these steps. The installation script is invoked while logged in as root. Example # ./NFC_setup.sh CSCOnfc-solaris-5.0-2.standard Fri Jan 2 14:00:01 EST 2004 Using software package /var/tmp/./CSCOnfc-solaris-5.0-2.standard. ******************************************************************** CNS Netflow Collection Engine 5.0.
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Solaris or HP-UX Platform If the CNS Netflow Collection Engine is running, an error is indicated and the install is terminated. You must first stop all NFC processes. Next, if the CNS Netflow Collection Engine was already installed, all files under NFC_DIR/logs are automatically moved to the directory NFC_DIR/logs/old, and all files under NFC_DIR/config are moved to NFC_DIR/config/old.
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Solaris or HP-UX Platform Step 9 If a previous installation was detected, you are prompted whether to use old configuration files or to install new configuration files: Please choose one of the following..
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Red Hat Enterprise Linux Platform Step 11 You are asked whether CNS Netflow Collection Engine should be started automatically when the system initializes: Would you like NFC to be started when the system initializes? (y/n) y If you respond y, the following rc scripts are created for autostarting CNS Netflow Collection Engine when the system initializes: • rcdir/init.d/csco_nfcd • rcdir/rc3.d/S999csco_nfcd (symbolic link to ../init.
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Red Hat Enterprise Linux Platform b. If downloading the image over the web: – Download the distribution file to a directory with as least 200 MB of available space. – Untar the distribution tar: tar xf The following files are created: NFC_setup.sh (the install script) CSCOnfc-linux- -..i386.rpm (the install image) – Run the install script specifying the install image as the argument, for example: .
Chapter 2 Installing CNS NetFlow Collection Engine Installing on a Red Hat Enterprise Linux Platform Step 4 The install script checks whether the CNS Netflow Collection Engine is already installed and verifies that the CNS Netflow Collection Engine is not running on the system: Searching for existing copy of CSCOnfc.. Found previous copy of CSCOnfc, performing upgrade... If the CNS Netflow Collection Engine is running, an error is indicated and the install is terminated.
Chapter 2 Installing CNS NetFlow Collection Engine Uninstalling CNS NetFlow Collection Engine 5.0 • rcdir/rc4.d/S99csco_nfcd (symbolic link to ../init.d/csco_nfcd) • rcdir/rc5.d/S99csco_nfcd (symbolic link to ../init.d/csco_nfcd) • rcdir/rc6.d/K99csco_nfcd (symbolic link to ../init.d/csco_nfcd) On Red Hat Enterprise Linux, rcdir is /etc/rc.d.
C H A P T E R 3 Configuring CNS NetFlow Collection Engine This chapter describes how to configure Cisco CNS NetFlow Collection Engine and then validate that it is operating properly.
Chapter 3 Configuring CNS NetFlow Collection Engine UNIX Environment Variables UNIX Environment Variables In releases prior to version 5.0, the CNS NetFlow Collection Engine Installation Guide recommended setting a number of environment variables, such as NFC_DIR and NFC_RESOURCEFILE. These settings should be removed from the environment for this release prior to installing and running CNS NetFlow Collection Engine. The environment is automatically determined by startup scripts in the 5.0 release.
Chapter 3 Configuring CNS NetFlow Collection Engine Verifying That CNS NetFlow Collection Engine Is Running Verifying That CNS NetFlow Collection Engine Is Running To verify that CNS NetFlow Collection Engine is running properly, perform the following steps. Step 1 To display a table of CNS NetFlow Collection Engine statistics, use the web-based user interface as described in the “Status” section of the CNS NetFlow Collection Engine User Guide.
Chapter 3 Configuring CNS NetFlow Collection Engine Browser Requirements Table 3-1 CNS NetFlow Collection engine Configuration Files (continued) File Directory Description nfcbgp-log4j.properties /opt/CSCOnfc/config Logging properties file for the BGP peer. server.xml /opt/CSCOnfc/tomcat/conf Web server configuration file. web.xml /opt/CSCOnfc/tomcat/web apps/nfc/WEB-INF Web application configuration file for web-based UI. Browser Requirements The CNS NetFlow Collection Engine, Release 5.
INDEX B F browser requirements flow cache 3-4 1-2 flows defined C CNS NetFlow Collection Engine architecture overview I 1-4 3-1 IP address 3-2 for configuration 3-4 uninstalling IP packets 1-4 1-1 2-10 Collector subsystem (NFCollector) command conventions viii compatibility IOS software 2-1 2-2 1-1 required patches 2-3 system requirements overview illustration stopping installation 1-2 1-4, 1-5 installation script starting HP-UX 3-3 Device and IOS Release Support func
Index description P 1-3 Version 9 NetFlow export datagram packets IP description 1-3 1-1 S Solaris installation 2-3 required patches 3-1 system requirements system requirements 2-1 2-1 T traffic flows description 1-1 traffic statistics information types 1-3 U UDP exporting NetFlow data to port port number configuration uninstall 1-4 1-4 2-10 UNIX environment variables 3-2 V Version 1 NetFlow export datagram description 1-3 Version 5 NetFlow export datagram description 1-3 Version
