.. _en-module022: ================================================================================ SCOPTEL IP PBX Software - Vegastream Analog Gateway Configuration ================================================================================ .. only:: pdf .. contents:: .. only:: html `PDF Version `_ FXO interfaces ------------------- * Also known as POTS line (Plain Old Telephone Service). * Also known as 1fl (1 family line). * Each FXO line can support one conversation between two parties (Tx and Rx Transmit and Receive). * Most business use ‘equivalent lines’ placed into an equivalent group ordered from the phone company AKA Telco. * Sometimes these equivalent groups are referred to as: * Rotary group * Hunt group * The first line or ‘pilot’ in the equivalent group is usually referred to as the BTN (Billing Telephone Number). * If additional lines are added to the pilot in a group then they are programmed by the Telco in a forward on busy configuration. Example: * 555-1234 (BTN) forward busy to * 555-2234 forward busy to * 555-3234 forward busy to * 555-4234 Busy (since this is the last number in this 4 FXO equivalency group) * Usually an inbound Caller ID service is ordered separately for each 1fl at an additional cost. * Variants of FXO interfaces include: * Loop Start (SCOPTEL/Vegastream) * Ground Start (Legacy PBX’s) Disconnect Supervision +++++++++++++++++++++++++ **Disconnect supervision** is a term in telephony describing signaling between the telephone exchange and a connected party used to indicate that the connected call is being disconnected. Without this Telco option FXO ports can get hung indefinitely on the PBX. It only applies to Loop Start circuits (not Ground Start). **CPC (Calling Party Control)** Is a signal sent from most modern electronic COs to indicate that the "Calling Party" has hung up. North American Central Office Switches use the OSI (Open Switch Interval) to signal the PBX’s FXO port that the Calling Party has hung up. The OSI is a break in loop voltage (0VDC), typically for 800ms. If the PBX’s FXO port can support the Open Switch Interval it will free up the FXO port. **Supervisory Disconnect Tone** Some Telco’s send a Supervisory Disconnect Tone when the Calling Party hangs up. If the PBX’s FXO port can support the Supervisory Disconnect Tone it will free up the FXO port. **Battery Reversal** Instead of an open loop for 800ms, the DC talk battery gets reversed for 500ms. Battery Reversal is still used in some countries however no FCC registered telephone equipment would recognize a battery reversal, since the FCC requires that telephones operate correctly on either polarity. Therefore Battery Reversal would simply be ignored. **Basic Test** If you have a Butt-set with a polarity light that's on all of the time while you're talking or you can hold the polarity test button while listening, you can watch the polarity LED. Make a call to your cell phone, hang-up the cell phone, and watch the polarity LED on your Butt-set. When there's an open loop, there's no voltage, and there's no electricity to light the LED. You can also listen for the Supervisory Disconnect Tone on your Butt-set when the Calling Party hangs up. SCOPTEL Background and Pre-requisites ------------------------------------------ * SIP Extensions must be created on SCOPTEL server for FXS ports * SIP VoIP Accounts must be created on SCOPTEL server for FXO ports * Incoming Lines must be created on SCOPTEL server to route incoming calls * Outgoing Lines must be created on SCOPTEL server to route outgoing calls * Class of Service must be edited to allow Outgoing Lines to access Vegastream POTS ports Vegastream Background and Pre-requisites --------------------------------------------- Vegastream Interface types (.. = 2 digit wildcard): * IF:01.. = FXS * IF:02.. = FXO * IF:03.. = BRI * IF:04.. = PRI * 06.. = Call Presentation Groups (used to select FXO port sequence for outgoing PSTN calls) * IF:99.. = SIP * Dn (SIP Registration User X) = Contact Header/Username (must match SCOPTEL SIP username) * Hostname (LAN/WAN) = Contact address = (local IP Address) or working FQDN (Fully Qualified Domain Name) * Local Domain (SIP Profile) = Hostname Vegastream supports regex pattern matching Examples: * IF:0101 = FXS port 1 * IF:01.. = FXS any port * IF:0201 = FXO port 1 * IF:0202 = FXO port 2 * IF:02.. = FXO any port * IF:9901 = SIP Profile 1 * IF:9902 = SIP Profile 2 * IF99.. = Any SIP Profile SIP Extensions +++++++++++++++++++ Use the SCOPTEL Extensions Manager to build the desired SIP extensions for the Vegastream FXS ports using secure passwords. These extensions will be used for the Vegastream SIP Profile 1, 9901 interface and To_SIP dial plan. Commit when done. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration1.png VoIP Accounts ------------------ Use the SCOPTEL Interfaces Manager to build the desired SIP VoIP Accounts for the Vegastream FXO ports using secure passwords. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration2.png In this example there are two equivalent phone lines supplied by the Telco in typical ascending ring order #. 9055551234 rings busy to #. 9055552234 end of hunt You need to create one VoIP Account for each phone number. This will make it easier to steer each phone number to the desired destination and create outgoing line pools for multiple business units. Use the SCOPTEL Interfaces Manager to build a SIP VoIP Account for each of the Vegastream FXO ports using secure passwords. Example (Summary): .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration3.png General Tab ++++++++++++++ * Select the required Tenant * Type is SIP * Trunk Type is Friend * Use the Telco’s telephone number as the Username .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration4.png Server Tab ++++++++++++ * Use the Telco’s telephony number as the Username * Enter a secure registration Password * Set Host Mode as Dynamic since the Vegastream will register to SCOPTEL * Check the Enable Proxy Settings?:[x] .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration5.png Network Tab ++++++++++++++ * Insecure : Check Port and Invite * Check Qualify? [x] .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration6.png Options Tab +++++++++++++ * DTMF Mode: RFC 2833 * Choose the desired CODEC’s (G711 recommended, G.729 cannot support fax) .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration7.png * Save each VoIP account when done. * Your VoIP Accounts page should something like this * Commit your changes .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration8.png Incoming Lines ------------------- General Tab +++++++++++++ * Example: 9055551234 * Type = Extension (DNIS) * Extension (DNIS) = 9055551234 * Trunk = 9055551234 .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration9.png Destination Tab +++++++++++++++++ Example: 9055551234 * Destination: Play a Message * Message to Play: demo-congrats .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration10.png Options Tab ++++++++++++ Example: 9055551234 * Schedule: default * Language: Default .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration11.png Advanced Options Tab +++++++++++++++++++++++ Example: 9055551234 * Class of Service: System Default * Save * Commit .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration12.png When you have finished adding each Incoming Line your summary screen should look something like this .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration13.png Outgoing Lines ------------------- Description: SCOPSERV Dial plan to outgoing Vegastream FXO Interfaces Vegastream Dial Planner: To_FXO Vegastream Call Presentation Group ID 2, Interface 0600, IF:0201|IF:0202, linear_up SCOPTEL Dial Plan * Name: 9X. * Trunk = Multiple Trunks 9055551234 and 9055552234 .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration14.png Description: SCOPSERV Dial plan to outgoing Vegastream FXO Interfaces Vegastream Dial Planner: To_FXO Vegastream Call Presentation Group ID 2, Interface 0601, IF:0201|IF:0202, linear_up SCOPTEL Dial Plan ++++++++++++++++++ * Type: Custom Dial String * Dial String: X. * Access Code (Prefix): 9 NOTE: The Access Code is always absorbed This will do a Class of Service lookup and if allowed will pass outgoing calls to the Vegastream FXO ports when dialed digits start with 9 NOTE: Default CoS allows all outgoing lines by default but you should check the CoS applied to each extension * Save when done * Commit your changes .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration15.png Vegastream Configuration ----------------------------- .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration16.png Log into the webui http:///. The default user is admin and password is admin.  Once in the webUI go into Quick Config as shown below. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration17.png Click "Continue" on the screen below .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration18.png Click on the VoIP tab in order to choose FXS Registration mode and enter the IP address or FQDN of the SCOPTEL server .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration19.png Enable each desired FXS port and enter the Registration Details for each extension you created in the SCOPTEL Extensions Manager. Click on the Submit button when done. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration20.png In the Expert Config LAN/WAN section * Change the IP address to static or you must set your DHCP server and DNS server to set a FQDN. * Change the Hostname to match the IP address or FQDN of the Vegastream Gateway since this sets the local SIP user domain when registering with Asterisk. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration21.png In the POTS section ++++++++++++++++++++++ * Enable each desired interface * Enable Caller ID options * Enable Visual Message Waiting Indication for voicemail MWI light * Enable Loop Current Break and set Loop Current Time to 800 to enable Disconnect Supervision * Click Submit .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration22.png The Vegastream Gateway requires two SIP Profiles to simplify the registrations and dial plans #. For the FXS ports IF:9901 #. For the FXO ports IF:9902 Enable Registration: [x] Registration Mode normal This example shows both SIP Profiles already created. * Modify default SIP Profile 1 and proceed .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration23.png SIP Profile 1 Configuration 1 * In the Local Domain field enter the IP address or FQDN of the Vegastream Gateway * Click Submit .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration24.png SIP Profile 1 Proxy Parameters 1 * Modify the IP/DNS Name to equal the IP address or FQDN of the SCOPTEL server .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration25.png SIP Profile 1 Registration Parameters 1 * Modify the IP/DNS Name to equal the IP address or FQDN of the SCOPTEL server .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration26.png The Vegastream Gateway requires two SIP Profiles to simplify the registrations and dial plans * For the FXS ports IF:9901 * For the FXO ports IF:9902 Enable Registration: [x] Registration Mode normal This example shows both SIP Profiles already created. * Modify default SIP Profile 2 and proceed .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration27.png SIP Profile 2 Configuration 2 * In the Local Domain field enter the IP address or FQDN of the Vegastream Gateway * Click Submit .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration28.png SIP Profile 2 Proxy Parameters 2 * Modify the IP/DNS Name to equal the IP address or FQDN of the SCOPTEL server .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration29.png SIP Profile 2 Registration Parameters 2 * Modify the IP/DNS Name to equal the IP address or FQDN of the SCOPTEL server .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration30.png From the main SIP menu click on SIP Registration Users. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration31.png **IMPORTANT:** * The Dn is used as the contact header when communicating with the SCOPTEL server * The Dn must be modified for each User so that it matches the Username or all calls will be rejected by SCOPTEL * The Username is used as the registration username when registering with the SCOPTEL server * All desired accounts must be enabled * The FXS ports must be associated with SIP Profile 1 so they are bound with IF:9901 * The FXO ports must be associated with SIP profile 2 so they are bound with IF:9902 * Modify each User and refer to the instructions on the next page .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration32.png **IMPORTANT:** * The Dn is used as the contact header when communicating with the SCOPTEL server * The Dn must be modified for each User so that it matches the Username or all calls will be rejected by SCOPTEL * The Username is used as the registration username when registering with the SCOPTEL server * All the accounts must be enabled * The FXS ports must be associated with SIP Profile 1 so they are bound with IF:9901 * The FXO ports must be associated with SIP profile 2 so they are bound with IF:9902 * Associate the Authentication User Index number with each matching analog port .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration33.png From the main SIP Menu click on SIP Authentication. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration34.png **IMPORTANT:** * The Vegastream Gateway creates default relationships for each analog port and Subscriber ID * All desired accounts must be enabled * Vegastream FXS usernames and passwords must match configurations defined in SCOPTEL Extensions * Vegastream FXO usernames and passwords must match configurations defined in SCOPTEL VoIP Accounts * The FXS ports (1-8) must be associated with SIP Profile 1 so they are bound with IF:9901 * The FXO ports (9-10) must be associated with SIP Profile 2 so they are bound with IF:9902 .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration35.png In the Dial Plan section, modify the To_FXO Profile. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration36.png Dial Plan sectionTo_FXO. Delete Plan ID 2. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration37.png Dial Plan section To_FXO Description SIP/SCOPTEL to FXO (outgoing calls/analog line pools) * Now that there is only one rule edit the "Source" and "Destination" fields to be as shown below. The source rule allows the source to be any number coming from SIP Profile 2. Then the destination rule sends the call to the Call Presentation Group created later. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration38.png Dial Plan>Call Presentation Group * Add a new Call Presentation Group ID 2 and disable the default Call Presentation Group ID 1 * Enable [x] Call Presentation Group 2 * Set Seq Mode to linear_up to prevent glare with Ascending Telco order * Interface = 0600 * Destinations IF:0201|IF:0202 will include FXO port 1 and 2 in the outgoing group creating a line pool * Submit when done * You can mix and match Interfaces and Destinations to create unique outgoing groups .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration39.png Other examples: Interface 0600, Destinations IF:0201 Interface 0601, Destinations IF:0202 Dial Plan: To_SIP * Modify the default To_SIP Dial Planner .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration40.png Dial Plan Description: Incoming FXS to SIP/SCOPTEL Dial Plan: To_SIP Plan ID 1: Any FXS Interface to SIP Profile 1 * Once in the To_SIP dial plan edit the "Source" and "Destination" fields to be as shown below. The source rule allows the source to be any number coming from FXS. Then the destination rule steers the call to Interface 9901/SIP Profile 1 so the SCOPTEL server can answer the call .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration41.png Dial Plan Description: Incoming FXO to SIP/SCOPTEL Dial Plan: To_SIP Plan ID 2 (DNIS routing: 9055551234_To_SIP) * Once in the To_SIP dial plan edit the "Source" and "Destination" fields to be as shown below. The source rule allows the source to be FXO Interface 1. Then the destination rule sends the call to Interface 9902/SIP Profile 2 so the SCOPTEL server can steer the call based on the DNIS sent using this rule. This allows flexibility for each incoming FXO port. .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration42.png Vegastream Configuration ----------------------------- Dial Plan Description: Incoming FXO to SIP/SCOPTEL Dial Plan: To_SIP Plan ID 3 (DNIS routing: 9055552234_To_SIP) * Once in the To_SIP dial plan edit the "Source" and "Destination" fields to be as shown below. The source rule allows the source to be FXO Interface 2. Then the destination rule sends the call to Interface 9902/SIP Profile 2 so the SCOPTEL server can steer the call based on the DNIS sent using this rule. This allows flexibility for each incoming FXO port. * Submit when done .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration43.png Dial Plan Description: Incoming FXO to SIP/SCOPTEL Dial Plan: To_FXS * This Dial Planner profile can be left at default values .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration44.png * Apply Changes * Save Changes * Reboot System .. image:: ../assets/trainings/Module22ScopTELSangomaGatewayConfiguration45.png