COPYRIGHTS AND DISCLAIMERS

Transcription

1 CXMon User Guide

2 COPYRIGHTS AND DISCLAIMERS Published Date: April 13th, 2010 This publication contains information proprietary and confidential to Memotec Inc. Any reproduction, disclosure or unauthorized use of this publication is expressly prohibited except as Memotec Inc. may otherwise authorize in writing. Memotec Inc. reserves the right to make changes without notice in product or component design as warranted by evolution in user needs or progress in engineering or manufacturing technology. Changes which affect the operation of the unit will be documented in the next revision of the manual. We have made every effort to ensure the accuracy of the information presented in our documentation. However, Memotec assumes no responsibility for the accuracy of the information published. Product documentation is subject to change without notice. Changes, if any, will be incorporated in new editions of these documents. Memotec may make improvements or changes in the products or programs described within the documents at any time without notice. Mention of products or services not manufactured or sold by Memotec is for informational purposes only and constitutes neither an endorsement nor a recommendation for such products or services. Memotec Inc. is a wholly owned subsidiary of Comtech EF Data Corp., and its parent company Comtech Telecommunications Corp (NASDAQ: CMTL). CXMon, CXTool, CX-U Series, CX-UA Series, and AbisXpress are either registered trademarks or trademarks of Memotec Inc.in Canada, the United States of America, and in other countries. Belden is a registered trademark of Belden Inc.in the United States of America and in other countries. Windows is a registered trademark of Microsoft Corporation in the United States and other countries. Whatsup and WhatsupGold are registered trademarks of Ipswitch Inc. in the United States and other countries. Any other trademarks are the property of their respective companies. Copyright 2010 Memotec Inc. Memotec Inc Henri Bourassa Blvd. West Montreal, Quebec Canada H4S 1P7 Tel.: (514) FAX: (514)

3 Contents Chapter 1: Overview of CXMon Monitoring CX Equiment with CXMon What CXMon Delivers How to Work with CXMon Organization of this User Guide Feedback on the Documentation CXMon System Requirements System Limitations Chapter 2: Installing CXMon Preparing your PC to run CXMon Installing and Configuring WhatsUp The CXMon Installer Process Upgrading from a previous CXMon version Remove CXMon (pre-windows Vista) Remove CXMon (Windows Vista) Launching the Installation Program Registering the Memotec MIBs (optional) Windows Vista Operation Configuring CXMon Configuring the Data Acquisition Parameters Configuring the WAN Ratio Graph Configuring the Data/Log Storage Options Configuring the Graph Display Options CXMon Authorization Key Management Transferring the CXMon License Key Chapter 3: Monitoring a CX Device Configuring CX Devices Vpstats index values Vpstats wandix values Vpstats vrsr index values Discovering CX Devices in WhatsUp iii

4 CXMon User Guide 3. 3 Starting the CXMon Application Monitoring Device Data Device Information Voice/GSM Traffic System Savings SNMP Traps T1 Port/E1 Port Monitors WAN Port Monitor WAN Port Details Viewing the Log Usage Statistics Reading the Traffic Map Viewing Detailed Information on a User Port Displaying Ratio of Traffic Types on a Port Displaying the ratio of duplicated silence packets Displaying the Ratio of Voice Packets Displaying the ratio of TRAU/TCH Channels Displaying the Ratio of Traffic Compression Displaying the ratio of discarded voice packets Displaying the Current Discard Level Logging Traffic Data to a CSV File Viewing the Log Usage Statistics Savings log file WAN log file BWSavings log file Traffic log file Voice Silence log file Discard Level log file PktDiscards log file Traps log file Chapter 4: Troubleshooting Installation/Launching Issues SNMP Trap Issues Device Information Issues WAN Port Monitor Issues Index Index-1 iv

5 List of Tables Table 1-1: Topic Structure of the User Guide Table 1-2: Firmware supported by CXMon Table 2-1: Different modes for handling traps Table 2-2: SNMP Settings Table 2-3: Meter Bar Settings Table 2-4: Log Settings dialog box parameters Table 2-5: Graph Settings parameters Table 3-1: CXTool version supporting CXMon Table 3-2: vpstats index values Table 3-3: vpstats wanidx values Table 3-4: vpstats vrsridx values Table 3-5: Device information fields Table 3-6: Voice/GSM Traffic System Savings Information Table 3-7: SNMP Traps fields Table 3-8: Port LED color description Table 3-9: WAN Port Monitor Fields Table 3-10: WAN Port Details fields Table 3-11: Log Status parameters Table 3-12: Traffic Mapping dialog box Table 3-13: Traffic Types Table 3-14: Counters in Traffic Mapping dialog box Table 3-15: Different Mode supported by User Port Details window Table 3-16: Discard Level legend Table 3-17: Port Error Counters in User Port Details Table 3-18: Packet Counters in EDGEPlus Mode Table 3-19: Packet Counters in DCME Mode Table 3-20: Packet Counters in GSM Abis/Ater Mode Table 3-21: Packet Counters in AbixXpress Mode Table 3-22: Packet Counters in ATM/TDM/IMA Mode v

6 CXMon User Guide Table 3-23: Log Status parameters Table 4-1: Solutions to installation or launching problems Table 4-2: Solutions to SNMP Trap Problems Table 4-3: Solutions to Device Information Problems Table 4-4: Solutions to WAN Port Monitor Problems vi

7 List of Figures Figure 1-1: The CXMon main window Figure 2-1: Windows Components Wizard Figure 2-2: Enabling the Simple Network Management Protocol Figure 2-3: Start of the CXMon installation process Figure 2-4: Memotec MIBs file location Figure 2-5: Registration batch file location Figure 2-6: MIBs registration in WUP Figure 2-7: SNMP Setting dialog box Figure 2-8: Meter Bar Settings dialog box Figure 2-9: Graph Settings dialog box Figure 2-10: Overview of CXMon Licensing Process Figure 2-11: CXMon Application Splash Screen Figure 2-12: License Configuration dialog box Figure 2-13: License Configuration dialog box Figure 2-14: Unauthorized Program running on PC Figure 2-15: Step 2 of the Transfer License wizard Figure 2-16: Transfer in Progress Wizard Figure 3-1: SNMP configuration in CXTool Figure 3-2: Vista Addresses in CXTool Figure 3-3: Launching device discovery in WUP/WUG Figure 3-4: WUP Map with discovered Memotec CX/CX-U devices Figure 3-5: Logging into the CXMon device Figure 3-6: CXMon main window Figure 3-7: Device information panel Figure 3-8: Voice/GSM Traffic System Savings panel Figure 3-9: SNMP Traps panel Figure 3-10: Resizing the Trap Columns Figure 3-11: T1 Port/E1 Port Monitors panel Figure 3-12: WAN Port Monitor panel vii

8 CXMon User Guide Figure 3-13: WAN Port Details panel Figure 3-14: Log Status dialog box Figure 3-15: User Port Details for EDGEPlus Mode Figure 3-16: T1/E1 Port Monitor buttons Figure 3-17: User Port Details: Traffic graph Figure 3-18: User Port Details: Silence within Voice Traffic Ratio graph Figure 3-19: User Port Details: Traffic Optimization Ratio graph Figure 3-20: WAN Discards Level Distribution graph Figure 3-21: Current Discard Level graph Figure 3-22: Example of a Log file as a spreadsheet Figure 3-23: Log Status dialog box viii

9 1 Overview of CXMon This chapter provides a high-level overview of the CXMon product, information on how to get started with the application, and overview of its documentation set. 1-1

10 CXMon User Guide 1.1 Monitoring CX Equiment with CXMon CXMon provides a graphic interface for monitoring CX equipment in GSM Abis/Ater and DCME networks. The Windows based user interface makes it easy to use and its integration with the WhatsUp Professional (WUP) and WhatsUp Gold (WUG) applications provides many added features. Once CXMon is installed, it can be launched directly from the Map view of WhatsUp Professional/Gold, by right clicking on a CX device in the Map. Once it is started, CXMon will begin acquiring statistics from the selected CX device. Statistics from the WAN interface and from the various DIM ports will be presented in two different panels. Statistics are either displayed as counters or in a group What CXMon Delivers The CXMon monitoring tool makes it easy to observe the status of Memotec equipment and the general health of GSM Abis/Ater or DCME applications. The main information windows are: Figure 1-1: The CXMon main window Device information (top left): Provides quick access to the device type, uptime, and configured alias to easily differentiate the various CX devices in the network. 1-2

11 Overview of CXMon Voice/GSM Traffic System Savings: Displays the evolution over time of the GSM Abis optimization performed by the CX device. WAN information (bottom right/left): Displays WAN link usage status information and error counters. T1/E1 Port information (middle): Provides visual indication of the presence of alarms on a port and information on the type of traffic present. Trap information (top right): Displays SNMP Traps collected from a CX device How to Work with CXMon In a typical CXMon session, you will perform the following workflow steps: 1. Launch WhatsUp Pro. 2. Log into the CX device to be monitored. 3. Configure how the device statistics are to be monitored. 4. Monitor the high-level data for the device (the main window). 5. View the Port Monitor data (T1/E1 Port Monitors) 6. View the traffic mapping on the ports Organization of this User Guide This user guide includes the following sections: Chapter 1: Overview Chapter2: Installing CXMon Chapter 3: Monitoring a CX Device Chapter 4: Troubleshooting Provides a list of the requirements for running CXMon and the installation steps. Launching CXMon from WhatsUp Professional/Gold is included. Explains how to install CXMon and setup WUP to start monitoring the CX in your network. Explains how to use the CXMon user interface, the various graphics, the counters, the menus and sub-menu and the different configuration settings. Provides solutions for the common problems encountered with CXMon and WhatsUp. Table 1-1: Topic Structure of the User Guide Feedback on the Documentation Our Technical Publications group welcomes your feedback. Please help us improve future releases of this document by sending us your comments and suggestions. You can communicate with us by at docs@memotec.com. 1-3

12 CXMon User Guide 1.2 CXMon System Requirements To successfully install and run CXMon, the following system requirements must be met: Pentium 3 class processor PC, running at 450 MHz or more Recommended: Pentium 4-2 GHz or more for more than 10 simultaneous CXMon sessions The following versions of MS Windows: - Windows Server 2008 R2 - Windows Vista - Windows 2003 R2 Server - Windows XP SP1 or later - Windows 2000 SP4 or later Microsoft SNMP Service must be installed IpSwitch s WhatsUp Professional 2005/2006 or WhatsUp Gold 11/12 (or higher) must be installed Graphics card that displays a minimum of 65K (16 bit) colors. Minimum screen resolution of 1024 x 768 WARNING: The main window is designed to be viewed as maximized. If you launch the application in a screen resolution greater than 1024 x 768, then lower the resolution, and re-maximize the window, parts of the window may not appear. When you launch the application on a desktop, you should not change the screen s resolution and resize the main window. 500 MB or more of free disk space Logging the data acquired by CXMon will occupy between 1 MB and 4 MB of disk space per day, for each CXMon session 512 MB or more of RAM Recommended: 1024 MB or higher for more than 10 simultaneous CXMon sessions NOTE: Windows Vista and Windows Server 2008 R2 are supported only with WhatsUp Gold 12 or higher. 1-4

13 Overview of CXMon System Limitations Under any Windows OS, the user must have administrator rights to install or run CXMon. It is possible to run more than one CXMon session at the same time, allowing for simultaneous monitoring of more than one CX device. The maximum number of CXMon sessions that can run at the same time is limited by the software license needed for CXMon and the system resources. Only one application on the PC may listen for SNMP Traps. In order to use the CXMon SNMP Trap collection function, other applications that collect trap information must have this function disabled. There is a special mode that allows both WUP/WUG and CXMon to receive SNMP traps (see Configuring the Data Acquisition Parameters on page 2-11). CXMon makes use of SNMP objects in the CX to help monitor the traffic. These new objects are automatically configured when using the correct CXTool revision (see Configuring CX Devices on page 3-2). To use these new objects in CXMon, you must upgrade from an older configuration to a minimum firmware revision for all CX devices being monitored. The following table lists the minimum firmware supported for each application. Abis/Ater on CX Application Minimum firmware required for CXMon support 0435H DCME on CX Abis/Ater with EDGEPlus on CX Abis/Ater with EDGEPlus and DCME on CX-U EDGEPlus/DCME on C flavor (CX/CX-U) ATM/TDM/IMA (CX-U) Abis/Ater with AbisXpress (CX-U) 0510R 0520T 0210A 0210A Table 1-2: Firmware supported by CXMon Only the CX900s, CX960e, CX2000, and the CX-U1000 series of products work with CXMon. In order for CXMon to be able to receive traps from the CX device being monitored, the Windows firewall application must be disabled for all supported Windows versions. To do this, follow these steps: - Open the Windows Control Panel and open the Firewall option. - Select the radio button that disables the firewall and click OK. 1-5

14 CXMon User Guide 1-6

15 2 Installing CXMon This chapter explains how to install and register CXMon, how to activate your license, and how to configure your devices to work with CXMon. 2-1

16 CXMon User Guide 2.1 Preparing your PC to run CXMon WARNING: This procedure applies to all versions of MS Windows EXCEPT MS Windows Vista and Windows Server 2008R2. If you have Vista, you can skip ahead to Installing and Configuring WhatsUp on page 2-4. Before installing CXMon, make sure that the SNMP service is available on the system. This section is not required for users who have Windows Vista installed, since SNMP traps are enabled by default. To verify that it is installed, follow these steps: 1. Select Start > Settings > Control Panel. 2. Select Add /Remove Programs. 3. On the left side on the panel select Add/Remove Windows Components. 4. Scroll the list until you see, Management and Monitoring tools. Figure 2-1: Windows Components Wizard NOTE: If the checkbox is not enabled, the service is not installed. 5. If the checkbox is not set, enable the checkbox and click the Details button. 2-2

17 Installing CXMon 6. Verify that Simple Network Management Protocol is set. Figure 2-2: Enabling the Simple Network Management Protocol 7. If this subcomponent is not selected, select it and click OK. 8. Click Next and follow the installation instructions. NOTE: A PC restart is normally required at the end of the installation. Windows may ask for your Windows CD and Windows may reject your request because of insufficient rights to perform this operation. If you have any problems, contact your network administrator. 2-3

18 CXMon User Guide 2.2 Installing and Configuring WhatsUp The WhatsUp application (Ipswitch Inc.) monitors critical network devices and services, allowing you to quickly identify problems and increase your understanding of your network performance and availability. If not already installed, complete the steps to install WhatsUp Gold since CXMon is designed to work in conjunction with WhatsUp Gold. A 30-day evaluation version is available on the CD-ROM provided by Memotec. In order to prevent SNMP trap collection conflicts with CXMon, exercise caution when setting up WhatsUp and CXMon. CXMon v5.0 and higher support three modes of handling the traps (see table below) CXMon Trap Handling mode Trap Configuration in WhatsUp Professional/ Gold Results CXMon only Disabled CXMon is listening to the traps and only CXMon can receive them. The default UDP port 162 is used. Traps are displayed in CXMon only. From WUP Enabled Traps are forwarded to a common port (usually UDP port 3000) WhatsUp (WUP or WUG) is listening to the traps on the default UDP port 162 and is forwarding them to CXMon on a common UDP port (usually UDP port 3000). Traps are displayed in CXMon and WhatsUp. The common port is set to 3000 by default when installing CXMon. Disabled Enabled Traps are displayed in WhatsUp only. To disable traps in WhatsUp, launch WhatsUp and perform the following steps: 1. Select Configure > Program Options 2. Select Passive Monitor Listeners. 3. Highlight the SNMP Trap entry. 4. Click Configure. Table 2-1: Different modes for handling traps 5. De-select Listen for messages on port 162. For more information on setting the Trap handling mode in CXMon, see Configuring the Data Acquisition Parameters on page

19 Installing CXMon 2.3 The CXMon Installer Process Once you have prepared your PC and configured it (see Preparing your PC to run CXMon on page 2-2 and Installing and Configuring WhatsUp on page 2-4), you can now install CXMon. Installing CXMon will make the following modifications to your WhatsUp installation: Add discovery support for all CX device types (including CX900s, CX960e, CX2000, and the CX-U1000 series), when performing device discovery. Integrate CXMon into the WhatsUp user interface, allowing users to start CXMon by right-clicking a CX device in the Map view. Optional: Integrate the Memotec MIBs into WhatsUp, making it possible to browse the different counters present in the CX, using WhatsUp s SNMPView. If this step is performed, the CXMon installation program will require some files located on the CD-ROM provided by Memotec. The files needed are: - Memotec MIBs file: you must uncompress this file in a local folder (ex: c:\mibs) - memotec.bat file: this is available for supported WhatsUp versions, except WhatsUp Gold 12. For WhatsUp 12 Standard Edition, the user only needs to take the extracted Memotec MIBs files and copy them into the \Data\mibs folder of WhatsUp Gold. 2-5

20 CXMon User Guide 2.4 Upgrading from a previous CXMon version If you already have CXMon installed, you must remove the previous version before installing the new one. Uninstalling the previous CXMon version will not remove the license files you have already purchased. If you install the new CXMon in the same folder, the new CXMon will be able to use the same license files. If you didn t install CXMon in the default path, take note of its current install path so that you can select the same path when you install the latest version of CXMon. WARNING: Do not manually delete any files in the CXMon folder as it may affect the license files and cause CXMon to stop functionning Remove CXMon (pre-windows Vista) To remove the previous CXMon for all supported Windows versions (Windows XP, Windows 2000, Windows 2003 Server), follow these steps: 1. Select Settings > Control Panel > Add/Remove Programs. 2. From the list of installed applications, select CXMon (or Memotec CXMon for previous versions). 3. Click Remove. When the previous version of CXMon is removed, you can install the newer version Remove CXMon (Windows Vista) To remove the previous CXMon on Windows Vista, follow these steps: 1. Open the Control Panel and select Program and Features. 2. From the list of installed applications shown, select Memotec CXMon. 3. Click Uninstall. When the previous CXMon is removed, you can install the newer version. 2-6

21 Installing CXMon 2.5 Launching the Installation Program 1. From the Memotec CD-ROM, run the setup.exe program in the \CXMon folder. Figure 2-3: Start of the CXMon installation process 2. Click Next. The License Agreement screen for CXMon appears. 3. If you agree with the License Agreement, select I accept and click Next. If you disagree with the License, click No and the installation will stop. 4. Enter your name and the name of your organization and click Next. 5. Specify the destination folder where CXMon will be installed and click Next. By default, the installation program will install itself in the following directory: C:\Program Files\Memotec\CXMon\ NOTE: If you had a valid CXMon license, you should install CXMon in the same path as the previous version to reuse the same license. 6. Type the UDP port number to allow trap handling and click Next. Unless you have a customized UDP port for this purpose, the default value of 3000 should be correct. To be able to receive traps in both WhatsUp and CXMon, WhatsUp must be configured to forward the traps to CXMon, using a common UDP port number. 7. Optional: the installation process will prompt you to register the MIBs. 2-7

22 CXMon User Guide To register the MIBS, make sure you have the Memotec CD in hand and click YES. See Registering the Memotec MIBs (optional) on page 2-8. If you select NO, the installation proces will begin immediately. When the installation is over, select Finish to terminate the installation program. Your next step should be to configure your CX devices, so refer to Configuring CX Devices on page 3-2. NOTE: CXMon is provided as a trial program that is valid for 30 days only. To continue using this program after the trial period is over, you must input a valid license key, which can be obtain by purchasing CXMon. Refer to CXMon Authorization Key Management on page 2-18 for more information on obtaining a license key Registering the Memotec MIBs (optional) When you register the MIBs, you will be able to use them from inside WUP/ WUG, with the SNMP Viewer tool (a MIB browser) or when defining new monitors for a device. This registration process only applies to computers that have WhatsUp Gold version 11 or WhatsUp Professional 2005/2006 installed since WhatsUp Gold 12 uses a different method. For WhatsUp Gold 12, you only need to extract the Memotec MIBs files and copy them into the WhatsUp MIBs directory. If WhatsUp Gold 12 is installed in the default location then it can be found at this location: C:\Program Files\Ipswitch\WhatsUp\Data\Mibs After this step is completed, you can proceed to Configuring CX Devices on page 3-2. This step is not needed for CXMon to work correctly. NOTE: For Windows Vista users, proceed directly to Windows Vista Operation on page To register the Memotec MIBs, follow these steps: 1. Double-click the self-extracting file in the \CXProductMibs folder on the Memotec CD. Extract the file to a a local path (ex: C:\Mibs). 2. When the MIBS are extracted to a local folder, click OK to go to the next step. 2-8

23 Installing CXMon 3. Specify the path where you extracted the Memotec MIBS locally (in the first two steps) by either typing the path in the field or using Browse. When done, click OK. Figure 2-4: Memotec MIBs file location 4. Type the location of the memotec.bat file in the Location field, or use Browse to select it, and click OK. This batch file copies the Memotec MIBs to the right location and calls the command line tools provided by WhatsUp to register the new MIBs. This file is located on the Memotec CD, in the \WhatsUp\Customizing WhatsUp\ folder. Figure 2-5: Registration batch file location NOTE: The memotec.bat file is different for each firmware release. Be sure to select the version that corresponds to the software revision in the CX device. 2-9

24 CXMon User Guide Figure 2-6: MIBs registration in WUP When the registering process is completed, you will be prompted to restart your PC to finalize the CXMon installation. The registration process can take anywhere from ten seconds to two minutes to complete Windows Vista Operation NOTE: This note applies only to older versions of CXMon (before version 6.0). For Windows Vista, the CXMon.exe executable file must be given administrator rights for it to run correctly. To do this, follow these steps: 1. Right-click the CXMon.exe file and select Properties. 2. Select the Compatibility tab and enable the Run this program as an administrator checkbox 3. Click OK. This will enable the CXMon application to run correctly in Windows Vista. 2-10

25 Installing CXMon 2.6 Configuring CXMon Four configuration areas are available, from the Settings menu: SNMP Settings Meter Bar Settings Log Settings Graph Settings Configuring the Data Acquisition Parameters You can configure data acquisition parameters for CXMon using the SNMP settings dialog box. To access these parameters select Settings > SNMP Settings. Figure 2-7: SNMP Setting dialog box Parameter Default Description Timeout 1000 ms Defines the time to wait, in milliseconds, for a response to an SNMP request. Table 2-2: SNMP Settings 2-11

26 CXMon User Guide Parameter Default Description Retry Count 3 Defines the number of times an SNMP request will be made before the request is abandoned. Requests are repeated when the Timeout value is reached. Read Community public Displays the community string used to read values from a CX device. This value is only configurable from WhatsUp. Write Community private Displays the community string used to write values to a CX device. This value is only configurable from WhatsUp. Refresh Rate 5 secs Displays the Global refresh rate used to plot graphs and to update all status information and counters. Choices are: 5, 10, 30 and 60 seconds. CXMon will update each graphs/counters at this rate. This value can be overridden for a particular graph by changing the refresh rate in the Graph Settings. Display period 15 min Sets the Global visible period, when plotting graphs. When the Display period is greater than the default value for the current Refresh rate, CXMon will average as many graph points needed to show the desired display period. Choices are: Refresh Rate of 5 secs: 15 mins, 1 hour, 4 hours, 12 hours and 24 hours. Refresh Rate of 10 secs: 30 mins, 1 hour, 4 hours, 12 hours and 24 hours. Refresh Rate of 30 secs: 90 mins, 3 hours, 6 hours, 12 hours and 24 hours. Refresh Rate of 60 secs: 3 hours, 6 hours, 9 hours, 12 hours and 24 hours. Table 2-2: SNMP Settings 2-12

27 Installing CXMon Parameter Default Description Trap Options --- Sets the way traps are handled on the PC. The choices are: CXMon only: Traps are received by CXMon only. Any other application on the PC that tries to collect the traps will fail or will prevent CXMon from collecting them. CXMon will monitor the UDP port 162 for traps. From WUP/WUG: Traps are received by WUP/ WUG and forwarded to CXMon, using forwarding UDP port (3000 by default). Disable: Traps are not collected by CXMon. Other applications (like WUP/WUG) can collect them. All CXMon session running on a PC share these settings. When the trap options are changed in CXMon, CXMon itself will change the configuration of WUP, so it matches the one in CXMon. Changes to the trap handling usually require restarting WUP. Sometime, restarting the PC is necessary. Trap Reception port 162 Identifies the port from which CXMon expects to get the traps. The value of this read-only field depends on the Trap Options value: CXMon only: UDP port 162, the default SNMP port for traps. From WUP: UDP port 3000, the default port set by CXMon at installation time. This field can only be change by installing CXMon. Table 2-2: SNMP Settings 2-13

28 CXMon User Guide Configuring the WAN Ratio Graph For Serial and Ethernet based WAN, CXMon will get a reference value from the CX device in order to calculate the ratio of the WAN that is used. This ratio is shown in the meter bar, next to the WAN graph. Sometimes, the reference value is too high for the amount of traffic (ex: A fast Ethernet card uses a reference value of 100 Mbps). For VR WAN, there are no reference values so the user always needs to enter custom values. The meter bar settings panel is used to configure custom bandwidth reference, for the meter bar in the WAN port monitor. To access these parameters, select Settings > Meter Bar Settings. Figure 2-8: Meter Bar Settings dialog box Parameter Default Description WAN Index --- Select the WAN index (Port or VR) to customize Custom Bandwidth Reference uncheck To customize the reference value for the selected WAN index, select this checkbox Tx 0 Reference bandwidth (kbps) values to use for Tx direction. Default value is the value read from the CX device (for Ethernet and Serial). For VR, the default value is 0. Rx 0 Reference bandwidth (kbps) values to use for Rx direction. Default value is the value read from the CX device (for Ethernet and Serial). For VR, the default value is 0. Table 2-3: Meter Bar Settings 2-14

29 Installing CXMon Because the reference bandwidth for the VR entry is 0, CXMon will not be able to correctly display the Meter Bar until the user sets the reference values. For this reason, CXMon will alert you shortly after launching CXMon that a VR entry has no reference value with the following message: The Bandwidth Reference of VRSR:1 is zero. Configure Speed Value in Meter Bar Settings dialog and then press OK HINT: When this warning message is displayed, do not click OK immediately because CXMon will display the same message in a few seconds. Instead, leave the message on the screen and go to the Meter Bar settings dialog box to set the reference values for the specified VRSR entry. When this is done, you should then click OK Configuring the Data/Log Storage Options The log settings are used to set the parameters for data storage. To access the Log Setting options, select Settings > Log Settings: Graph Log: Indicates that Graph information (of all graphics) will be stored. The default is unchecked. Trap Log: Indicates that SNMP Trap information will be stored. The default is unchecked. Other Settings: displays the Log Settings dialog box which offers the following options: Parameter Single file per day Limit file size to 1 MB Description Graph data are saved in a different file each day. The file name contains the date in numerical format. Graph data files are never overwritten. Note that traps are always saved in a single file per day format Graph data are saved in a file until it reaches 1 Mbytes. The file name contains an index from 1 to the value of Max history files per Graph. Graph data files are overwritten after reaching the Max history files per Graph index value. Table 2-4: Log Settings dialog box parameters 2-15

30 CXMon User Guide Parameter Max history files per Graph Min free disk space Set log path Description The maximum number of files that will be created for each graph. Each file is limited to 1 MB. The time it takes to reach the 1 MB limit depends on the Refresh rate configured. When the Refresh Rate is set to 5 seconds, each 1 MB file has around 2 days of data. All logging will automatically stop when the minimum free disk space value is reached. Used to define the location of log files. NOTE: The path is changed immediately for the current CXMon session. Delete logs Used to delete log files. NOTE: Only the logs for the current CXMon session will be deleted. Table 2-4: Log Settings dialog box parameters 2-16

31 Installing CXMon Configuring the Graph Display Options For each graph (with the exception of the Discards graph), it is possible to customize some fields. To clear the graph of its data, right-click the graph and select Clear Graph. This command clears the contents of the current graph. The next value will be plotted at the far left of the graph and the time (X-Axis) will be updated so that the current time is placed at the far left. To access the settings dialog box, right-click the graph and select Graph Settings. Figure 2-9: Graph Settings dialog box Parameter Grid Display Refresh Rate Display period Description Enable or disable the display of the grid for the selected graph. Defines the graph refresh rate in seconds for the selected graph, overriding the Global Refresh Rate. Choices are: 5 secs (default value), 10 secs, 30 secs and 60 secs. This parameter sets the visible period, when plotting the selected graph. When the Display period is greater than the default value for the current Refresh rate, CXMon will average as many graph points needed to show the desired display period. Choices are: Refresh Rate of 5 secs: 15 mins, 1 hour, 4 hours, 12 hours and 24 hours. Refresh Rate of 10 secs: 30 mins, 1 hour, 4 hours, 12 hours and 24 hours. Refresh Rate of 30 secs: 90 mins, 3 hours, 6 hours, 12 hours and 24 hours. Refresh Rate of 60 secs: 3 hours, 6 hours, 9 hours, 12 hours and 24 hours. Table 2-5: Graph Settings parameters 2-17

32 CXMon User Guide 2.7 CXMon Authorization Key Management The CXMon application is supplied as a trial program that can be tested for a fixed duration. During this trial period, the software is fully functional and can monitor the maximum allowed CX devices (remember that in the CX2000, each CPU is considered a device of its own). After installing CXMon, you must switch the trial version of CXMon to the valid licensed version. The figure below presents an overview of these steps: Customer opens CXMon on a trial basis. CXMon can be use for the duration of the trial (30 days) (1) Trial ends or Customer buys CXMon.Customer obtains site code from Licensing Configuration Window. (2) Customer sends site code to Memotec, requesting license authorization to use CXMon. Memotec generates site key. (3) 4) Customer enters site key into CXMon License Configuration Window and receives license authorization message. Memotec sends site key to customer. Figure 2-10: Overview of CXMon Licensing Process The following procedure assumes that the trial period has expired and you have purchased a full version of CXMon: 1. When you launch the CXMon application, the splash screen appears. Figure 2-11: CXMon Application Splash Screen 2-18

33 Installing CXMon 2. Press Enter while the splash screen is visible to access the License Configuration dialog box. The License Configuration dialog box also appears when the trial license has expired. Figure 2-12: License Configuration dialog box The License Configuration dialog box provides the user with a site code, which is based on a special internal hardware signature that is unique to the computer on which CXMon is installed. Memotec generates a site key from the site code. This site key is only valid for the PC where the site code was generated and the key is then sent to the customer. NOTE: If you do not have a Site Key, send an with your Site Code to licenses@memotec.com. 3. Enter the authorization key for your product in the Site Key field and click Validate. WARNING: CXMon automatically tracks restrictions in terms of days and/or number of CX devices to be monitored. The license is uniquely specific to the computer on which the application runs. If you try to copy the program and its license files to another computer, the license becomes invalid on that machine and does not allow access. A mechanism is provided to allow the transfer of a license from one PC to 2-19

34 CXMon User Guide another. For more information, see Transferring the CXMon License Key on page The registered keys remain on the system and are maintained through CXMon un-installation, as long as you do not modify the files remaining in the installation directory in any way Transferring the CXMon License Key You can transfer CXMon licenses using either of the following methods: Direct License Transfer: move a license from a local or networked directory to another area. For more information, see Direct License Transfers on page Removable memory media: move a license from one PC to another using a floppy disk, USB memory device, or Flash card reader. For more information, see Removable Memory Media License Transfers on page Direct License Transfers Direct license transfers move any type of license from one location on your PC to another. The Transfer To Directory command requests a directory path to an existing, unlicensed copy of the same product on your client s hard drive before transferring the license from the source directory to the target. This target directory must either be local to the source directory or connected through a network drive. For example, you may want to move a program with a valid fixed license from C:\Program Files\Memotec\CXMon to D:\Memotec\Application. To directly transfer a licence between workstations, follow these steps: 1. Install the CXMon application to D:\Memotec\Application and launch it. 2-20

35 Installing CXMon 2. When the CXMon splash screen appears, press Enter to display the License Configuration dialog box. Figure 2-13: License Configuration dialog box 3. From the License Configuration dialog box, select the License > Transfer to directory command. A wizard launches to help you to transfer the CXMon license to another location. 4. Click Next to continue. A file browser dialog box appears. 5. Navigate to the D:\Memotec\Application folder, select the new CXMon.EXE program filename, and press Enter. The CXMon application in D:\Memotec\Application now has the license that was previously assigned to the original program in C:\Program Files\Memotec\CXMon. Removable Memory Media License Transfers This type of operation transfers a license from an existing authorized copy of an application on one computer to an unauthorized copy of the product on a second computer. The transfer process does not jeopardize your license in any way and is completely secure because the removable memory media is registered to a specific PC in a specific location. This ensures the license can only be transferred to the target PC you specify. For example, you want to transfer the license for Memotec CXMon program from PC-1 to PC-2. In this example, a floppy disk is used. To transfer a license using removable media, follow these steps: 2-21

36 CXMon User Guide NOTE: In this procedure, the source workstation is called PC-1 and the destination workstation is called PC Ensure that you have an authorized copy of the application on PC-1, an unauthorized copy of the application on PC-2, and a removable storage device connected to PC Start the CXMon appplication on PC-2 and press Enter when the CXMon splash screen appears. The License Configuration dialog box appears: Figure 2-14: Unauthorized Program running on PC-2 3. Select the License > Transfer in from another computer command. The Transfer License In wizard dialog appears prompting you for a path (the first step of three). 4. Type the path to your removable storage device, or use the Browse button to select it, and click Next. The program imprints its registration on the removable storage device and the system displays the following window: 2-22

37 Installing CXMon S Figure 2-15: Step 2 of the Transfer License wizard If you can leave the program running, go to Step 5. to continue. If you need to close the PC-2 program while you work with the PC-1 program, click the Continue Transfer Later button. The system displays a popup message. Click OK to acknowledge the above popup and the wizard terminates. 5. Remove the removable storage device from PC-2 and connect it to PC Start the CXMon appplication on PC-2 and press Enter when the CXMon splash screen appears. 7. Select the License > Transfer out to another computer command. The Transfer License Out wizard dialog appears prompting you for a path (the first step of two). 8. Type the path to your removable storage device, or use the Browse button to select it, and click Next. The program reads the registration imprint file and then writes a matching file to the removable storage device, decrementing the license count at the source or discontinuing it (if it is a single user license). 9. Remove the removable storage device from PC-1, reconnect it to PC-2, and relaunch the CXMon appplication on PC-2. If you did not exit from the program in Step 4., the wizard process is complete and you can click Finish. 2-23

38 CXMon User Guide If you exited the program in Step 4., the following window appears when you relaunch the CXMon appplication: 10. To continue this operation, click Continue existing transfer. 11. Type the path to your removable storage device, or use Browse to select it, and click Next. 12. Click Finish to complete the process. Figure 2-16: Transfer in Progress Wizard The License Configuration window on PC-2 appears, showing that you are authorized to use it. 2-24

39 3 Monitoring a CX Device This chapter explains how to launch and configure CXMon. It also explains how to add CX devices to CXMon and how to monitor these devices. 3-1

40 CXMon User Guide 3.1 Configuring CX Devices The CX devices that are monitored by CXMon require some basic configuration. You can use Memotec s CXTool application to perform this configuration. The table below summarizes the minimum CXTool version required for each type of application. Application Minimum CXTool required for CXMon support Abis/Ater on CX CXTool 4.3.5B DCME on CX CXTool Abis/Ater with EDGEPlus on CX CXTool 5.0.0u Abis/Ater with EDGEPlus and DCME on CX-U CXTool EDGEPlus/DCME on C flavor (CX/CX-U) ATM/TDM/IMA (CX-U) Abis/Ater with AbisXpress (CX-U) CXTool 5.2.0k CXTool k CXTool k Table 3-1: CXTool version supporting CXMon NOTE: CXMon is not supported on all the devices supported by CXTool. See the System Limitations on page 1-5 for the list of device types supported by CXMon. For more information about using CXTool, refer to the CXTool User Guide and CXTool Online Help. You must have at least one new or existing configuration file to configure your CX device. To configure your CX devices with CXTool, follow these steps: 1. Launch CXTool and open the profile for your CX device. 2. Using the panel on the left, open System folder, double-click one of the icons, and select Modify from the pop-up menu. The System Information dialog box appears. 3-2

41 Monitoring a CX Device 3. Select the SNMP tab and check that the CXMon Enabled is checked. Collect SNMP traps with Trap Host Define the source IP address for all SNMP packets. Figure 3-1: SNMP configuration in CXTool 4. In order to collect SNMP Traps, you must create a Trap Host entry with the IP address of the PC that has CXMon installed. This parameter defines the destination IP address for all SNMP trap packets from this CX. You can configure multiple destinations if you are using multiple SNMP Monitoring systems. 5. Configure the SNMP Source Address with the required IP address. This parameter defines the source IP address for all SNMP packets originating from this CX device. Normally the IP address with the shortest path to the monitoring PC is configured. To set the source IP address, select the right IP interface (usually the one on the same network as the monitoring PC) from the list. NOTE: The next step only applies to the CX2000 device, so if you do not have this device, skip to the next step. 3-3

42 CXMon User Guide 6. The CX2000 requires that a unique IP address be assigned to each CPU. If you cannot have an Ethernet card in each CPU, you can configure virtual IP addresses. This is accomplished by configuring a Vista Address for each CPU. Figure 3-2: Vista Addresses in CXTool The Vista Address will define the source address for all SNMP packets originating from this CX. This serves the same function as the Agent Interface Alias. All SNMP requests should match one of the configured Vista Address entries. 7. CXTool will automatically define the WAN Index for all DIM ports when configuration is made using either the FR WAN Trunk, IP WAN Trunk, or MLPPP WAN Trunk panels. But if the WAN is configured without using one of these panels then the WAN Index must be added manually (in the panel on the left, double-click the Advanced folder and double-click the Add-On Scripts message on the right panel) using the following command for each DIM interface: vpstats:15 wanidx=11, vrsridx=1 In this example the DIM interface is located in slot 8, port 1 (15) and the WAN interface is located in slot 1, port 1 (11). The VRSR used by the DIM traffic is VRSR:1. The vpstats and wanidx values identify the slot and port of the corresponding WAN interface used by the DIM port for transport to the remote location. 3-4

43 Monitoring a CX Device NOTE: The WAN interface must be on the same CPU as the DIM Port. For more information about CXTool configuration, refer to the following Memotec documents: CXTool User Guide CXTool Online Help Vpstats index values The vpstats values identify the slot and port of the corresponding WAN interface used by the DIM port for transport to the remote location. Vpstats index DIM Card on CX T1/E1 ports on CX-U 1 & 2 Slot 1, Port 1 & 2 Port 1 & 2 3 & 4 Slot 2, Port 1& 2 Port 3 & 4 5 & 6 Slot 3, Port 1& 2 Port 5 & 6 (CX-U1220/1240/1280) 7 & 8 Slot 4, Port 1& 2 Port 7 & 8 (CX-U1220/1240/1280) 9 & 10 Slot 5, Port 1& 2 Port 9 & 10 (CX-U1220/1240/1280) 11 & 12 Slot 6, Port 1& 2 Port 11 & 12 (CX-U1220/1240/1280) 13 & 14 Slot 7, Port 1& 2 N/A 15 & 16 Slot 8, Port 1& 2 N/A Table 3-2: vpstats index values 3-5