Avaya Solution & Interoperability Test Lab Application Notes for Resource Software International Cloud Call Accounting 2.1 with Avaya Aura Communication Manager 6.2 Issue 1.0 Abstract These Application Notes describe the configuration steps required for Resource Software International (RSI) Cloud Call Accounting 2.1 to interoperate with Avaya Aura Communication Manager 6.2. Resource Software International Cloud Call Accounting is a remote cloud based telephone reporting solution that uses the call detail recording records from Avaya Aura Communication Manager to track phone calls and produce detailed reports. Information in these Application Notes has been obtained through DevConnect compliance testing and additional technical discussions. Testing was conducted via the DevConnect Program at the Avaya Solution and Interoperability Test Lab. 1 of 17
1. Introduction These Application Notes describe the configuration steps required for Resource Software International Cloud Call Accounting 2.1 to interoperate with Avaya Aura Communication Manager 6.2. Resource Software International (RSI) Cloud Call Accounting is a remote cloud based telephone reporting solution that uses the call detail recording (CDR) records from Avaya Aura Communication Manager to track phone calls and produce detailed reports. CDR records are first sent from Avaya Aura Communication Manager to a RSI Data Storage Buffer via a TCP/IP link. The RSI Data Storage Buffer then periodically sends the buffered CDR data to RSI Cloud Call Accounting. These Application Notes will focus on the configuration of Avaya Aura Communication Manager and the RSI Data Storage Buffer to enable RSI Cloud Call Accounting to interoperate successfully with Avaya Aura Communication Manager. It is assumed that Avaya Aura Communication Manager, Avaya Aura System Manager and Avaya Aura Session Manager have already been installed and are functioning. Detailed administration of other aspects of Avaya Aura Communication Manager and the RSI Data Storage Buffer will not be described. For more information on these other administration actions, see the appropriate documentation listed in Section 9. For security purposes public IP addresses and phone numbers have been masked out or altered in this document. 2. General Test Approach and Test Results The feature test cases were performed manually. Different types of calls were made, along with different actions initiated from the user telephones, to verify proper parsing and displaying of received CDR data from Communication Manager by RSI Cloud Call Accounting. The serviceability test cases were performed manually by disrupting network connections, disabling and re-enabling the CDR Link and power cycling the RSI Data Buffer and Communication Manager. DevConnect Compliance Testing is conducted jointly by Avaya and DevConnect members. The jointly-defined test plan focuses on exercising APIs and/or standards-based interfaces pertinent to the interoperability of the tested products and their functionalities. DevConnect Compliance Testing is not intended to substitute full product performance or feature testing performed by DevConnect members, nor is it to be construed as an endorsement by Avaya of the suitability or completeness of a DevConnect member s solution. 2 of 17
2.1. Interoperability Compliance Testing The interoperability compliance test included feature and serviceability testing. The feature testing focused on verifying the proper parsing and displaying of unformatted CDR data received from Communication Manager by RSI Cloud Call Accounting through the RSI Data Storage Buffer. The following is a list of Interoperability tests that were performed: Internal calls Inbound Inter-Switch calls Outbound Inter-Switch calls Inbound PSTN calls Outbound PSTN calls Tandem calls to PSTN Hold Blind and Consultative Transfer Blind and Consultative Conference Hunt Groups Bridged Appearance Account codes Authorization codes Split CDR Records Serviceability Load Test The serviceability testing focused on verifying the ability of RSI Cloud Call Accounting to recover from adverse conditions, such as disruption of network, disabling and re-enabling the CDR Link and power cycling the RSI Data Buffer and Communication Manager. The verification also included a sanity check on the RSI Cloud Call Accounting reports that can be viewed on the secure website. 3 of 17
2.2. Test Results All applicable test cases were executed and passed with the following observations: There are some differences in Communication Manager in the call records generated by SIP endpoints compared to Analog, Digital, and H.323 endpoints. As a result in certain scenarios involving SIP endpoints (e.g., two-party call, transfer, or conference), a CDR application may see more or less records, or records with condition codes/calling party other than expected. Avaya is investigating the differences and code changes may be made available in a future release pending the outcome of that investigation. Some serviceability tests failed with RSI Data Storage Buffer Build 2012-05-23 10:05:11. These issues were fixed in Build 2013-04-09 12:12:54. 2.3. Support Technical support on RSI Cloud Call Accounting can be obtained through the following: Phone: 905-576-4575 Email: support@telecost.com Web: www.hostedcallaccounting.com 4 of 17
3. Reference Configuration The configuration used for the compliance testing is shown below. Figure 1: Sample Configuration of RSI Cloud Call Accounting and Avaya Aura Communication Manager 5 of 17
4. Equipment and Software Validated The following equipment and software were used for the sample configuration provided: Equipment/Software Release/Version Avaya Aura Session Manager running on Session Manager 6.2 S8800 Server Release: 6.2.2.0.622005 Avaya Aura System Manager running on System Manager 6.2.0 S8800 Server Build Number 6.2.0.0.15669 Avaya Aura Communication Manager running on a Avaya Aura Communication S8300D server Manager 6.2 (R016x.02.0.823.0) with G450 Media Gateway Patch: 02.0.823.0-20356 Avaya Aura Communication Manager running on a Avaya Aura Communication S8800 server Manager 6.2. (R016x.02.0.823.0) with G650 Media Gateway Patch: 02.0.823.0-20396 Avaya 9641G IP Telephone (H.323) S6.2209 Avaya 9621G IP Telephones (H.323) S6.2313 Avaya 9621G IP Telephones (SIP) 6.2.1.26 Avaya 9624G IP Telephone (SIP) 6.2.1.26 RSI Cloud Call Accounting 2.1 RSI Data Storage Buffer for all testing excluding Serviceability Build 2012-05-23 10:05:11 RSI Data Storage Buffer for Serviceability tests Build 2013-04-09 12:12:54 6 of 17
5. Configure Avaya Aura Avaya Communication Manager This section describes the procedure for configuring call detail recording (CDR) in Communication Manager. These steps are performed through the System Access Terminal (SAT). Communication Manager will be configured to generate CDR records and send them to the IP address of the RSI Data Storage Buffer using TCP/IP. 5.1. Configure CDR Use the change node-names ip command to create a new node name for the RSI Data Storage Buffer, for example, RSIBuffer. This node name is associated with the IP Address of the RSI Data Storage Buffer. Also, take note of the node name procr. It will be used in the next step. The procr entry on this form was previously administered. change node-names ip Page 1 of 2 IP NODE NAMES Name IP Address AvayaRDTT 192.168.98.69 RSIBuffer 192.168.97.45 default 0.0.0.0 devsm 192.168.97.198 interopsm 10.33.1.11 procr 10.33.1.22 procr6 :: Use the change ip-services command to define the CDR link. To define a primary CDR link, provide the following information: Service Type: CDR1 [If needed, a secondary link can be defined by setting Service Type to CDR2.] Local Node: procr [For the Avaya S8720 Servers, set the Local Node to the node name of the CLAN board.] Local Port: 0 [The Local Port is fixed to 0 because Communication Manager initiates the CDR link.] Remote Node: RSIBuffer [The Remote Node is set to the node name previously defined.] Remote Port: 9000 [The Remote Port may be set to a value between 5000 and 64500 inclusive, and must match the port configured in the RSI Data Storage Buffer.] change ip-services Page 1 of 3 IP SERVICES Service Enabled Local Local Remote Remote Type Node Port Node Port CDR1 procr 0 RSIBuffer 9000 CDR2 procr 0 AvayaRDTT 9001 7 of 17
For this solution the Reliable Session Protocol (RSP) is not used. On Page 3 of the ip-services form, set the Reliable Protocol field to n. change ip-services Page 3 of 3 SESSION LAYER TIMERS Service Reliable Packet Resp Session Connect SPDU Connectivity Type Protocol Timer Message Cntr Cntr Timer CDR1 n 30 3 3 60 CDR2 y 30 3 3 60 Enter the change system-parameters cdr command to set the parameters for the type of calls to track and the format of the CDR data. The example below shows the settings used during the compliance test. Provide the following information: CDR Date Format: month/day Primary Output Format: unformatted Primary Output Endpoint: CDR1 The remaining parameters define the type of calls that will be recorded and what data will be included in the record. See Reference 2 in Section 9 for a full explanation of each field. The test configuration used some of the more common fields described below. Use Legacy CDR Formats?: n [Allows CDR formats to use 4.x CDR formats. If the field is set to y, then CDR formats utilize the 3.x CDR formats.] Intra-switch CDR: y [Allows call records for internal calls involving specific stations. Those stations must be specified in the INTRA-SWITCH CDR form.] Record Outgoing Calls Only?: n [Allows incoming trunk calls to appear in the CDR records along with the outgoing trunk calls.] Outg Trk Call Splitting?: y [Allows a separate call record for any portion of an outgoing call that is transferred or conferenced.] Inc Trk Call Splitting?: y [Allows a separate call record for any portion of an incoming call that is transferred or conferenced.] CDR Account Code Length: 6 [The length may be set to a value between 1 and 15. However, during the compliance test, 6 was used.] 8 of 17
change system-parameters cdr Page 1 of 1 CDR SYSTEM PARAMETERS Node Number (Local PBX ID): CDR Date Format: month/day Primary Output Format: unformatted Primary Output Endpoint: CDR1 Secondary Output Format: unformatted Secondary Output Endpoint: CDR2 Use ISDN Layouts? n Enable CDR Storage on Disk? y Use Enhanced Formats? n Condition Code 'T' For Redirected Calls? n Use Legacy CDR Formats? n Remove # From Called Number? n Modified Circuit ID Display? n Intra-switch CDR? y Record Outgoing Calls Only? n Outg Trk Call Splitting? y Suppress CDR for Ineffective Call Attempts? y Outg Attd Call Record? n Disconnect Information in Place of FRL? n Interworking Feat-flag? n Force Entry of Acct Code for Calls Marked on Toll Analysis Form? n Calls to Hunt Group - Record: member-ext Record Called Vector Directory Number Instead of Group or Member? n Record Agent ID on Incoming? y Record Agent ID on Outgoing? y Inc Trk Call Splitting? y Inc Attd Call Record? n Record Non-Call-Assoc TSC? n Call Record Handling Option: warning Record Call-Assoc TSC? n Digits to Record for Outgoing Calls: dialed Privacy - Digits to Hide: 0 CDR Account Code Length: 6 9 of 17
If the Intra-switch CDR field is set to y on Page 1 of the system-parameters cdr form, then use the change intra-switch-cdr command to define the extensions that will be subject to call detail records. In the Assigned Members field, enter the specific extensions whose usage will be tracked. Note: To simplify the process of adding multiple extensions in the Assigned Members field, the Intra-switch CDR by COS (SA8202) feature may be utilized in the SPECIAL APPLICATIONS form under the system-parameters section. To utilize this feature, contact an authorized Avaya account representative to obtain the license. change intra-switch-cdr Page 1 of 3 INTRA-SWITCH CDR Assigned Members: 8 of 1000 administered Extension Extension Extension Extension 40010 40020 40030 40040 40041 40045 40060 40061 5.2. Configure IP Network Region This section describes the steps for administering an IP network region in Communication Manager for communication between Communication Manager and Session Manager. Enter the change ip-network-region <n> command, where n is a number between 1 and 250 inclusive, and configure the following: Authoritative Domain Enter the appropriate name for the Authoritative Domain. In this sample configuration bvwdev.com was used. Codec Set Set the codec set number as provisioned in the IP Codec Set form. In this example 1 was used. change ip-network-region 1 Page 1 of 20 IP NETWORK REGION Region: 1 Location: 1 Authoritative Domain: bvwdev.com Name: Main Network Region MEDIA PARAMETERS Intra-region IP-IP Direct Audio: yes Codec Set: 1 Inter-region IP-IP Direct Audio: yes UDP Port Min: 2048 IP Audio Hairpinning? n UDP Port Max: 3329 DIFFSERV/TOS PARAMETERS Call Control PHB Value: 46 Audio PHB Value: 46 Video PHB Value: 26 10 of 17
5.3. Configure Off-PBX-Telephone Configuration-Set SIP endpoints and off-pbx-telephone stations will be automatically created in Communication manager when users (SIP endpoints) are created in Session Manager. However, the off-pbx-telephone configuration-set form needs to be modified. Enter change off-pbx-telephone configuration-set and disable the CDR for Calls to EC500 Destination? field by setting it to n. change off-pbx-telephone configuration-set 1 Page 1 of 1 CONFIGURATION SET: 1 Configuration Set Description: SIP Calling Number Style: network CDR for Origination: phone-number CDR for Calls to EC500 Destination? n Fast Connect on Origination? n Post Connect Dialing Options: dtmf Cellular Voice Mail Detection: none Barge-in Tone? n Calling Number Verification? y Call Appearance Selection for Origination: first-available Confirmed Answer? n Use Shared Voice Connections for Second Call Answered? n Use Shared Voice Connections for Second Call Initiated? n 11 of 17
6. Configure RSI Data Storage Buffer This section provides the procedures for configuring the RSI Data Storage Buffer to interoperate with Communication Manager and RSI Cloud Call Accounting. It is assumed that the RSI Data Storage Buffer has already been connected to the Ethernet network and has a valid IPv4 address. With a web browser, connect to the IP address of the RSI Data Storage Buffer and log in with the appropriate credentials (not shown). Under Data Collection Settings, configure the following: Input type: IP Socket (Listen Mode ) Port: CDR Remote port 9000 as configured in Section 5.1 Click on the Save button to store the configuration settings. Under Data Delivery Options, configure the following: Data Delivery: sftp Push Server Address: Address supplied by RSI User Name: User Name supplied by RSI Password: Password supplied by RSI Click on the Save button to store the configuration settings. 12 of 17
After completing Section 5 and 6 the required configuration is complete for Interoperability between Communication Manager and RSI Cloud Call Accounting. Reports can now be generated and viewed remotely via a web browser by connecting to RSI s hosted Cloud Call Accounting portal. 13 of 17
7. Verification Steps This section provides tests that can be performed to verify proper configuration of Communication Manager and RSI Cloud Call Accounting. 7.1. Verify Avaya Aura Communication Manager The CDR status of Communication Manager can be checked by running the status cdr-link command. The Link State should be up as shown below. status cdr-link Primary CDR LINK STATUS Secondary Link State: up up Number of Retries: Date & Time: 2013/04/16 08:34:35 2013/04/16 15:12:45 Forward Seq. No: 0 0 Backward Seq. No: 0 0 CDR Buffer % Full: 0.00 0.00 Reason Code: OK OK The primary CDR link can be disabled with the command busyout cdr-link primary and enabled with the command release cdr-link primary as shown below. busyout cdr-link primary COMMAND RESULTS Port Maintenance Name Alt. Name Result Error Code PRI-CDR PASS release cdr-link primary COMMAND RESULTS Port Maintenance Name Alt. Name Result Error Code PRI-CDR PASS 14 of 17
7.2. Verify RSI Cloud Call Accounting Navigate to the RSI Data Storage Buffer web interface as described in Section 6. Make a test call. When the call is completed CDR data from Communication Manager should be captured and displayed in the Last Records Received section of the screen as shown below. 15 of 17
8. Conclusion These Application Notes describe the configuration steps required for RSI Cloud Call Accounting to successfully interoperate with Avaya Aura Communication Manager. All feature and serviceability test cases were completed successfully with the observations noted in Section 2.2. 9. Additional References This section references the product documentation relevant to these Application Notes. Documentation for Avaya products may be found at http://support.avaya.com. Avaya Aura Communication Manager 1) Administering Avaya Aura Communication Manager, Document 03-300509, Issue 7.0, Release 6.2, July 2012 2) Avaya Aura Communication Manager Feature Description and Implementation, Document 555-245-205, Issue 9.0, Release 6.2, July 2012 Resource Software International Ltd. 3) RSI Data Storage Buffer Installation & User Guide 16 of 17
Avaya and the Avaya Logo are trademarks of Avaya Inc. All trademarks identified by and are registered trademarks or trademarks, respectively, of Avaya Inc. All other trademarks are the property of their respective owners. The information provided in these Application Notes is subject to change without notice. The configurations, technical data, and recommendations provided in these Application Notes are believed to be accurate and dependable, but are presented without express or implied warranty. Users are responsible for their application of any products specified in these Application Notes. Please e-mail any questions or comments pertaining to these Application Notes along with the full title name and filename, located in the lower right corner, directly to the Avaya DevConnect Program at devconnect@avaya.com. 17 of 17