Course13:IT Connect - 05 Using Trunks

From innovaphone-wiki

Jump to: navigation, search

This book explains how to set up an external trunk by using the PBX Manager Plugin Trunks

Contents

The PBX Manager Plugins

So far, all relevant system configuration has been done for us by the Install. Of course, you also want to do modifications to the system configuration later on. This is what the PBX Manager is for.

You can video2.png find it in the list of all Apps and add it to your home screen (best in the Admin Tools group).

When you open the screenshot.png PBX Manager App, you will find a number of icons. Each icon is known as a PBX Manager Plugin which are used to configure a component of your PBX or your App Platform. The exact type and number of such plugins depends on the PBX firmware (all the "black & white" plugins are provided by the PBX) and the Apps you have installed (all the "coloured" plugins with an AP prefix are provided by the installed Apps). This book will only focus on the trunks plugin, while other plugins will be explained later on.

The Trunks Plugin


The Trunks PBX Manager plugin has one simple task. It should allow you to set up a trunk to connect your PBX to the PSTN. This can be achieved by configuring a FXO, BRI, PRI or SIP interface on one of your devices.

Since we have no time to waste let's get straight to work and open our screenshot.png PbxManager App.


Creating a SIP Trunk Line

By clicking on thescreenshot.png trunks icon you will gain the possbility to add a trunk to your current system. You have to give our video2.png trunk a name and a number. The external line number is usually 0 but this can vary depending on your country or your needs.

Additionally this section let's you set up any call forwardings for calls that pass through our trunk but weren't connected or the destination is the number of the trunk itself (loopack). Those call forwardings are usually used to reroute calls to a central switchboard. We will discuss how to configure a switchboard later on in the course.

For now let's screenshot.png reroute calls to Mario Rossi - 13. Afterwards you need to press OK.

As a next step we will screenshot.png select the newly created trunk and link the trunk directly to an Interface. Simply press the screenshot.png Add button and a list of devices will appear. At the moment we don't have much of a choice - so let's choose hq.dvl-ckl2.net.

In the next step we have to decide if we want to configure a Interface or SBC.
  • Interface
  • In this context interface means that we talk about a physical interface to create an external connection with. This might be a FXO, BRI or PRI. Since innovaphone gateways differ, not all physical interfaces are present on each device. You have to choose the correct product according to your needs.
  • SBC
  • SBC is an abbreviation for session border controller which is used to set up a SIP connection to your SIP Provider. You can either use the SBC functionality on the same device as your PBX or you can outsource it to a different device and place it in your DMZ.
The upcoming chapters will focus on the configuration of a SIP Trunk, therefore select SBC.

Afterwards you have to select the country of your SIP Provider. If you choose your desired country you will see a list of implemented SIP Profiles. The purpose of those SIP Profiles is to help you set up a SIP trunk with all necessary SIP tweaks to communicate with your provider. Unfortunately this is necessary because there is no SIP trunk standardization yet and not all providers tend to behave the same. Each SIP Profile will tailor a a specific configuration for a single SIP provider. You just have to fill out the account data and the rest is done for you.

If your SIP trunk product is not part of our firmware you have the option to select Default SIP Trunk which creates a generic SIP Trunk configuration which will work for most SIP providers.

We will talk about this feature in the upcoming chapters so please select the video2.png Default SIP Trunk.

Default SIP Trunk

The Default SIP Trunk launches an interactive menu which will guide you through the configuration of a SIP trunk if no matching SIP profile exists. The Default SIP Trunk allows you to configure the following connection types depending on the SIP trunk product you use:
  • a trunk with Multiple Subscriber Numbers (MSN) and one registration towards the provider for each MSN
  • a trunk with Multiple Subscriber Numbers (MSN) and a single registration towards the provider for all of the MSNs
  • a direct dial-in trunk (DDI), which allows you to have a range of extension numbers

Country code


The first question of the Default SIP Trunk is which country your SIP Trunk is located in. Therefore you need to enter the country code prepended by a + sign. Every country has a wikipedia.ico different country code and it is used to call a number in a different country. In other words, if you call a German number from Italy you have to dial the international prefix (00) followed by 49, the German country code, to reach the desired number.

Please use the following country code: +49

Connection type

Afterwards you have to decide if you want to create a MSN or DDI trunk. If you got a DDI trunk from your provider, you should have received a subscriber number and a range of extensions. Internal extensions are reachable by adding the extension number to the end of the dialed number. If the provider gave you a MSN trunk you should have received a set of numbers which may or may not be consecutive. These numbers have to be mapped to reach internal extensions.

Let's first discuss the MSN trunk so please choose MSN as option.

MSN - single registration

Individual registration


Depending on your provider you might have to register each MSN number individually at the provider. If you got a username and password for each number you need to click Yes. If a single username and password is sufficient you need to press No.

Let's discuss a single registration scenario at first and so please click No. We will talk about a multiple registrations MSN trunk in the next chapter.

MSN - single registration

Number mappings

The next step is to create number mappings which allow you to map the external MSN number to an internal extension number. As soon as you are satisfied with the configuration of your map you need to press the checkmark icon to lock your configuration. Before pressing the OK button all maps have to be locked because all maps in editing mode will be lost otherwise. If you click the trash can icon all maps in editing mode, which weren't saved before, will be deleted. Pressing the plus icon allows you to add further maps.

Please create number maps for those MSNs like shown in video2.png this video.

MSN number
Internal extension
+4962134282351 10
+4962134282358 11
+4962134282359 12
+4962134282376 13

Credentials

After configuring the maps you need to enter username and password to authenticate your SIP trunk at the provider.

Please use this credential to authenticate your trunk at our provider simulation.

User
MSN49.621.342823
Password
pw123

Setup

As last step of the configuration we need to add IP specific Data to your configuration.
  • Disable: As long as the disable flag is active the interface won't send a Register to the provider nor will listen to an incoming SIP message.
  • Protocol: You can decide which transport protocol to use for the transmission of SIP packets. You can either use SIP over UDP, SIP over TCP or encrypted TLS transport.
  • Domain: The domain name is used to identify a network by its name. You will usually configure a subdomain of your provider.
  • Proxy: This configuration is optional because a DNS lookup of the domain will retrieve the proxy address. The Proxy is used as IP endpoint of the SIP signaling messages.
  • Media relay: By activating the media relay flag you will reroute RTP traffic through the SBC. Without the media relay flag RTP Traffic will be sent directly from endpoint(phone) to the provider and the other way round.
We prepared a provider simulation for you test. Please use this parameter to finish your configuration.

Disable
off
Protocol
TCP
Domain
siptrunk.class.local
Proxy
leave empty
Media Relay
on

Testing

To see if your registration was successful you need to reopen your trunk and check the top of the default SIP trunk menu. You will see screenshot.png a checkmark next to the IP address it registered to.

You have three possibilities to see if your trunk is actually working:
  • You can either call a test hotline which is reachable at this numbers:
00 900 12345678
  • You can simply call yourself at one of these numbers:
00 621 34282351
00 621 34282358
00 621 34282359
00 621 34282376
  • You can ask a fellow student for his number. He will be reachable through the provider simulation.

MSN - multiple registrations

If you are satisfied with your configuration let's go through the MSN - multiple registration scenario now. I'd recommend to delete your trunk and start again from scratch. I'm pretty sure you know which steps to take to get to the decision if you want an individual registration or not.

Let's now talk about the multiple registrations scenario and please click Yes.

MSN - multiple registrations

Number mappings & credentials


In the multiple registrations variant you are faced with a screenshot.png more complex menu. Next to every map you have to configure a username and password matching to this MSN. The configured credential is used to authenticate this particular number at the provider. Please be aware that you need to lock all maps by clicking the checkmark icon before you press OK. A line in editing mode will be lost otherwise.

Please use these configuration parameters to set up your multiple registrations MSN trunk.

MSN number
internal extension
SIP username
SIP password
+4962134282323
10
MSN49.621.34282323
pw123
+4962134282327
11
MSN49.621.34282327
pw123
+4962134282335
12
MSN49.621.34282335
pw123
+4962134282336
13
MSN49.621.34282336
pw123

Setup

This dialogue might look familiar because we discussed it in the previous chapter.

Again we need to configure the Domain.

Disable
off
Protocol
TCP
Domain
siptrunk.class.local
Proxy
leave empty
Media Relay
on

Testing

In this scenario we need to check if each number successfully registered at the provider. Therefore please reopen your trunk. You will see a checkmark screenshot.png next to each SIP credential. Each checkmark indicates a successful registration for this number.

Again you have three possibilities to test your trunk configuration:
  • You can call a test hotline at this number:
00 900 12345678
  • You can call yourself at one of these numbers:
00 621 34282323
00 621 34282327
00 621 34282335
00 621 34282336
  • You can ask a fellow student for his number.

DDI

International number


If you choose the DDI trunk option you are asked to insert your trunk number in international format.

Please use this number as your DDI trunk: +496213428231

Lowest extension

Usually the lowest extension number will be 0 because most provider will give you a range of numbers from 0 to 9/99/999/9999. But sometimes it could be the goal to have a subset of a range like 30 to 60. In this case you need to configure 30 as lowest number to create a routable dialplan.

You are in luck because in our sample configuration you can configure 0 as lowest number.

Number mappings

As you see an initial map has been created already. This initial map should be your last map of this table. The purpose of this map is to remove all configured digits and forward only the extension number to the PBX. In other words the left part of the map removes digits from the dialed number and the right part adds it again. Perhaps this already sparks your imagination because this would allow you some fancy configuration. You could create a map like this:

+49621342823199 -> 23

This map exchanges the extension number 99 to 23.
But you can also map a whole number block. Each extension number starting with 5 can be mapped to a number starting with 8.

+4962134282315 -> 8

Don't forget to lock the map by pressing the checkmark icon before you press OK because maps in editing mode won't be saved.

There is no need to create a special map for our provider simulation, just press OK make sure the initial map is saved.

Credentials

Again we need to authenticate the trunk at the provider. Therefore we need to enter a username and password.

Please use this credentials to authenticate your SIP trunk at our provider simulation.

User
DDI49.621.3428231
Password
pw123

Setup


The last step of the configuration is identical to the MSN trunk.

You have to add IP specific Data to your configuration.

Disable
off
Protocol
TCP
Domain
siptrunk.class.local
Proxy
leave empty
Media Relay
on

Testing

In case you are curious if your configuration worked or not, I would recommend to check if your trunk is registered at the provider. The successful registration is indicated by screenshot.png a checkmark in the top of the SIP default trunk menu.

Again you have three possibilities to see if your trunk is actually working.
  • You can either call a test hotline:
00 900 12345678
  • You can call yourself. Simply dial the following number from Jean Dupont:
00 621 3428231 -10
  • You can ask a fellow student for his number. He will be reachable through our provider simulation. Don't forget to add the extension number of the desired destination to the dialed number.
Personal tools