Configuring VQM Reporter For AOS and N-Command MSP: Accessing The CLI
Configuring VQM Reporter For AOS and N-Command MSP: Accessing The CLI
Configuring VQM Reporter For AOS and N-Command MSP: Accessing The CLI
Voice quality monitoring (VQM) allows real time passive Voice over IP (VoIP) quality measurements to be taken on all Realtime Transport Protocol (RTP) voice streams transmitted through an ADTRAN Operating System (AOS) device. The VQM Reporter is a feature supported by AOS devices that allows the gathered VQM statistics to be aggregated by third-party collectors, such as the n-Command Managed Service Provider (MSP) server (NetVanta Server 450). Allowing aggregation by the n-Command MSP server provides more flexibility in monitoring voice networks. Configuring the VQM Reporter is done through the command line interface (CLI) and consists of creating the reporter, configuring the parameters of the reporter, and viewing the reporter statistics. VQM should be enabled and configured on the AOS device before configuring the VQM Reporter. For more information about configuring VQM, refer to the Voice Quality Monitoring Configuration Guide available on the CD shipped with your AOS product or online at kb.adtran.com. You must also have the AOS device connected to the n-Command MSP server for the VQM Reporter feature to be effective. Refer to the help included in the n-Command MSP software for assistance in connecting your unit to the server.
6. Enter the units Global Configuration mode as follows: #config terminal (config)#
61700840G1-42.2A
To specify a secondary server, and include the protocol and port number, the command is entered as follows: (config-rtp-reporter-Reporter1)#collector secondary 172.5.67.95 udp 517 (config-rtp-reporter-Reporter1)# Using the no form of this command removes the server from the reporters configuration. 2. You can enter a description of this reporter using the description <text> command. Adding a description to the reporter helps in managing multiple reporters. Enter the command as follows: (config-rtp-reporter-Reporter1)#description NV7100VQM (config-rtp-reporter-Reporter1)# Using the no form of this command removes the description from the reporters configuration. 3. Using the max-queue-depth <value> command, you can also specify the number of reports held in the queue that are waiting to send requests or receive responses. The number of reports that can be held ranges from 0 to 2000. By default, the reporter is configured to hold 512 reports in the queue. To change this value, enter the command as follows: (config-rtp-reporter-Reporter1)#max-queue-depth 700 (config-rtp-reporter-Reporter1)# Using the no form of this command returns the queue volume to the default value. 4. You can specify the number of times the reporter will attempt to contact the server using the max-retries <value> command. By default, the reporter is configured to attempt 3 times before stopping, but you can specify that the reporter try from 0 to 5 times. To change the default value, enter the command as follows: (config-rtp-reporter-Reporter1)#max-retries 4 (config-rtp-reporter-Reporter1)# Using the no form of this command returns the number of retries to the default value. 5. You can specify whether the reporter is enabled or disabled by using the shutdown command. By default, the reporter is configured to be active. Using the shutdown command deactivates the reporter. Using the no form of this command returns the reporter to the active state. To shutdown the reporter, enter the command as follows: (config-rtp-reporter-Reporter1)#shutdown (config-rtp-reporter-Reporter1)#
61700840G1-42.2A
6. You can also specify the user that is sending the report and the user to whom the report is going. By default, the user that sends the report is the serial number of the AOS device, and the user to whom the report is going is the specified server. These users are Session Initiation Protocol (SIP) users, and specifying different users is done using the sip grammar [from-user <user name> | to-user <user name>] command. Using the no form of this command returns the user values to the default. To change the users, enter the command as follows: (config-rtp-reporter-Reporter1)#sip grammar from-user user300 (config-rtp-reporter-Reporter1)#sip grammar to-user user500 (config-rtp-reporter-Reporter1)# Changing the from-user or to-user from the default values will cause communication with n-Command MSP to fail. These fields should only be changed if you are communicating with another type of VQM report collector. ADTRAN recommends leaving these values at the default setting. The VQM Reporter is now configured and you should save the configuration.
61700840G1-42.2A
To clear VQM Reporter statistics, enter the clear ip rtp quality-monitoring reporter [<name>] command from the Enable Configuration mode prompt. If you do not enter the name of a specific VQM Reporter, statistics from all VQM Reporters are cleared. To clear VQM Reporter statistics, enter the command as follows: #clear ip rtp quality-monitoring reporter Reporter1 # To enable and view debug messages related to VQM Reporters, enter the debug ip rtp qualitymonitoring reporter [<name>] command from the Enable mode prompt. If you do not enter the name of a specific VQM Reporter, debug messaging is enabled for all VQM Reporters. Turning on a large amount of debug information can adversely affect the performance of your unit. Sample output from this command appears below: #debug ip rtp quality-monitoring reporter Reporter1 08:46:13 VQM.REPORTER Reporter1 1 Enqueuing VQM Report - [email protected] to [email protected], RTP=10.10.20.2:2234->10.17.138.1:3000 08:46:13 VQM.REPORTER Reporter1 1 Generating VQM Report 08:46:13 VQM.REPORTER Reporter1 1 Sending VQM Report 08:46:13 VQM.REPORTER Reporter1 1 Transaction 0x022ad5f0: state changed -> Client General Request Sent
61700840G1-42.2A