Configuration Wizards - Visual First Call Setup

Introduction

The Visual First Call Setup configuration wizard is an EMA-based tool that guides you in configuring the SBC to process calls in a laboratory (non-production) environment under light to moderate levels of traffic.

Preparation Notes

Take note of the following while using a configuration wizard:

• This wizard is not intended for configuring the SBC for production deployments. The configuration wizard tool is a guided procedure - it maintains a predefined order of actions from start to finish. You cannot skip an action or go back to a previous action.
  
  Note

  Avoid navigating to other EMA objects or windows while using this tool to avoid a disrupted workflow resulting in an out-of-sync configuration. Before navigating to the other EMA objects, complete and save the configuration element on which you are presently working. Once you save the Visual First Call Setup configuration, you can then navigate to and configure other EMA or CLI objects, but avoid creating objects that are related to the configuration in your saved configuration.

• The "Getting Started with the SBC" panel is automatically hidden once the "First Call Setup" completes. Go to "Dashboard Settings" to re-enable the panel. Refer to Home - Dashboard.

Limitation

The Visual First Call Setup wizard does not include real-time updates of the configuration status of objects. If you configure an object using this tool, and then delete the configuration through EMA or CLI, the tool still reflects the configuration status as "configured" and displays the “Configuration Complete” green icon adjacent to the object rather than the expected red icon which indicates no configuration.

To View Visual Call Setup

On the SBC main screen, navigate to Configuration > Configuration Wizards > Visual First Call Setup.

Banner

The banner Provision the SBC for Basic SIP Peering (at the top of the Visual First Call Setup window) displays information on the preliminaries of the configuration procedure.

View

There are two options to view the entire consolidated configuration:

• View as Diagram (default)
• View as Table



By default, the Visual First Call Setup window is displayed as a diagram as illustrated in the figure Visual First Call Setup - View as Diagram.

To view the consolidated configuration in tabular form, select View as Table.

Special Case - Fresh Installation/Upgrade

If the SBC is not configured using the Visual First Call Setup tool, as in case of a freshly installed/upgraded SBC:

• When viewed as diagram, instead of a green circle, a red circle is displayed beside each configuration element. For more information, see Provision the SBC for Basic SIP Peering

• With the exception of Customer Network > PBX and Carrier Network > Carrier, all other configuration elements remain inactive; this is to ensure that the sequence of the configuration is maintained.

• When viewed as table, the table is displayed only with fields but no values.

Configuration Elements

During a Fresh Installation, you cannot update certain configurations before configuring their prerequisite. Follow the Configuration Elements Hierarchy to configure the elements displayed in the Visual First Call Setup window.

• Customer Network
  • PBX
    
    
• Carrier Network
  • Carrier
    
    
• <CE Name>
  
  • Internal/Core/Trusted Side
    • IP Interface Group
      • IP Interface
    • Static Route
    • Zone
      • SIP Trunk Group
      • SIP Signaling Port
      • IP Peer
  • External/Carrier/Untrusted Side
    • IP Interface Group
      • IP Interface
    • Static Route
    • Zone
      • SIP Trunk Group
      • SIP Signaling Port
      • IP Peer
  • Routing


Error Messages

While configuring various elements of the Visual First Call Setup tool, you may encounter error messages of two types:

• Error messages that results from unacceptable values entered against the fields. These error messages are generated on the front-end of the EMA web application, and the Javascript code running on your browser displays such messages promptly.
  
  
• Error messages you receive from the back-end of the EMA web application. A small web server runs on the SBC, which serves the EMA application over http/https protocol. Sometimes, the code running on the web server finds values that you enter against the fields as unacceptable due to constraints placed by the back-end logic, even if the values are within the bounds imposed by Ribbon. For example, if you set the field Port Name as pkt0 (displayed on the Edit Media IP Interface window) for both Internal (PBX) as well as External (Carrier) side of the setup, an error message is generated from the back-end and displayed on your browser.