Customer Setup for Acme Packet or Oracle SBC Collector

Prev Next

Introduction

This article describes the Oracle-specific configuration required for HP WXP Collaboration to collect data from Oracle Session Border Controllers (SBC) and EOM / OCOM systems. It covers required CLI access, CDR configuration, FTP forwarding, and REST API enablement.

Configuring Oracle SBC

SSH ACLI Access

WXP Collaboration collects Oracle SBC data using the SSH Acme Command Line Interface (ACLI). A single SSH ACLI user account with standard user privileges is required. Superuser access is not required.

The SSH user account must have sufficient privileges to run the following commands:

  • show configuration session-agent

  • show configuration system-config

  • show ntp server

  • show sipd agents

  • show sipd sessions all

  • show uptime

  • show version boot

Verify access by running these commands in a terminal session using the assigned user account.

For more information about ACLI, refer to the Oracle ACLI Reference Guide.

Enable the cdr-output-inclusive Setting

The cdr-output-inclusive setting must be enabled before deploying the WXP Collaboration data collector for Oracle SBC. This setting ensures a consistent number of columns for each CDR record type, making interpretation of CDR data possible. CDR files do not include headers.

To enable this setting in the Oracle SBC web interface:

  1. Click Admin in the top-right corner.

  2. Click Settings.

  3. From the left menu, select session-router > account-config.

  4. Click Show advanced.

  5. Locate and enable the Cdr output inclusive option.

  6. Click OK.

  7. Navigate away from the page to save the changes.

Enabling Forwarding of Generated CDR Files over FTP

This configuration requires a standalone FTP server running on the same system as the WXP Collaboration Data Collector. An example SFTP setup using FreeFTPd is available. Follow steps 1 through 3 only.

The Oracle SBC historical collector relies upon the Oracle SBC functionality of pushing CDRs as they are generated to another server (in this case, the on-prem WXP Collaboraton Data Collector server) over FTP.  This can be configured through the Oracle SBC web GUI:

  1. Select Admin (or the logged-in username) in the top-right corner.

  2. Select Settings.

  3. From the left menu, click system > system-config.

  4. Click Show advanced.

  5. Scroll down and expand the Collect sub-section.

  6. Set Sample interval and Push interval to low, positive values (recommended: 5 and 15).

  7. Enable the Boot state check box.

  8. In the Push receiver list, click Add.

  9. Enter the WXP Collaboration Data Collector IP address, FTP username and password, data store directory (recommended: /AcmeSBC), and set Protocol to ftp.

  10. Save the associated settings and observe the changes in the dropdown box.

  11. Navigate away from the page to apply the changes.

Use the FTP credentials configured on the FTP server running on the WXP Collaboration Data Collector system.

FTP forwarding can also be configured using the superuser ACLI interface. For details, refer to the Oracle Accounting Guide.

Configuring Oracle EOM / OCOM (Alpha)

Enable FTP Access

WXP Collaboration historical collectors retrieve CDR and MDR files from EOM / OCOM systems using FTP.

  1. Open the Settings dialog in the EOM / OCOM web interface.

  2. From the left pane, expand External Devices and select FTP Server.

  3. Enable the FTP access option.

  4. Enter the FTP username and password.

  5. Click Save, then Close.

Enable the EOM / OCOM REST API

WXP Collaboration real-time collectors use the EOM / OCOM REST API to collect call and voice quality data.

  1. Open the Settings dialog in the EOM / OCOM web interface.

  2. In the left menu, expand General Settings and select REST API.

  3. In the resulting dialog box, select the check box next to REST API.

  4. Upon enabling the REST API for the first time, the API Key is displayed.

    1. Record the API key to invoke REST API calls.

  5. Click Close to close the EOM Setting dialog box.

Note: WXP Collaboration data collector uses the following REST API functions:

  • getPagedCalls

  • getCallDetails

  • callVoiceQuality

Contact Us

For any assistance, create a support case or email support@wxp.hp.com.