SCOPSERV ADMINISTRATOR S GUIDE VOLUME 3 CONFIGURING DUNDI. Copyright 2006 ScopServ

Transcription

1 SCOPSERV ADMINISTRATOR S GUIDE VOLUME 3 CONFIGURING DUNDI Copyright 2006 ScopServ

2 TABLE OF CONTENTS SETTING-UP DUNDI...3 The Big Picture 5 Activating DUNDi. 7 Node Identification Settings 8 CREATING DUNDI PEERS...10 Adding a Peer 10 Generating RSA encryption keys to exchange with DUNDi Peers 12 Setting Peer Options 12 DUNDi Peer-Options 13 DUNDi Permissions Tab 15 DEFINING DUNDI MAPPINGS...18 (DUNDI CLASS OF SERVICE)...18 The System Default (e164) 18 Creating Class of Services for a Mapping 20 Mappings Tab 20 INCLUDING TELEPHONY OBJECTS IN DUNDI...22 Phone Extension 22 Outgoing Lines 23 Incoming lines 24 Testing you Mappings / 25 Rev : 1.2.3

3 Chapter 1 SETTING-UP DUNDI I have decided to dedicate a Volume on DUNDi because I believe it is necessary for companies who decide to buy more than on copy of ScopServ and want to operate. in a distributed WAN and to be able to share routes, trunks and extensions. DUNDi is protocol agnostic and can use SIP, IAX2 and H323 channels Here are the components of a DUNDi network. Peer This is a ScopServ or Asterisk system. It is Identified by its Ethernet interface MAC Address Can be Symmetric Allows Upstream and Downstream routes Inbound Outbound Needs Mappings to route calls, acts similar to DNS in the sense that it can provide routes to client phones. Mapping A mapping is similar to a Class of Service it includes the permitted routes to other peers who want to borrow lines form its counterpart. For example if you would have to offices one in New York City and another one in Los Angeles then a New York office clerk would like to call a customer in Los Angeles then he could dial if a mapping point to that location then we could configure our telephony network to allow such a dialing from New York City to Los Angeles and it would cost a lot less that using the conventional PSTN because the / 25 Rev : 1.2.3

4 call would be routed by a VoIP trunk for example and we all know that it costs a lot less in LD charges this way. Therefore, DUNDi becomes a money saver tool / 25 Rev : 1.2.3

5 The Big Picture / 25 Rev : 1.2.3

6 / 25 Rev : 1.2.3

7 Activating DUNDi. Go to Telephony-Configuration-Modules and make sure Distributed Universal Number Discovery (DUNDi) is set to Yes,.If not check it and Commit Figure / 25 Rev : 1.2.3

8 Node Identification Settings Each DUNDi Node need to provide basic info to other peers especially if the member node is part of a GPA. My advice is to always fill this info even if your are in a private network. GPA.General Peering Agreement: An agreement between DUNDi Peers Figure / 25 Rev : 1.2.3

9 / 25 Rev : 1.2.3

10 Chapter 2 CREATING DUNDI PEERS Adding a Peer Peers needs to be added to the PBX in order to query them and route calls. This job needs to be done on each ScopServ or Asterisk peer; ScopServ provides a user-friendly interface for that. Figure The Entity ID here is a device MAC address and the host can be a IP or and FQDN / 25 Rev : 1.2.3

11 / 25 Rev : 1.2.3

12 Generating RSA encryption keys to exchange with DUNDi Peers Refer to the ScopServ Admin Guide Volume 2 (Tools Chapter,RSA Keys Tab Section) Setting Peer Options Figure / 25 Rev : 1.2.3

13 DUNDi Peer-Options Model Inbound Receive requests only Outbound Transmit requests only Symmetric Receive and Transmit requests Order Primary Secondary Tertiary Quaternary What search order to use. May be 'primary', 'secondary', 'tertiary' or 'quartiary'. In large systems, it is beneficial to only query one up-stream host in order to maximize caching value. Adding one with primary and one with secondary gives you redundancy without sacraficing performance. Utilize/Permit precaching with this peer (to pre- cache means to provide an answer when no request was made and is used so that machines with few routes can push those routes up a to a higher level). Precache None No precaching Inbound Permits this peer to send us precache routes Outbound Send precache routes to this peer Symmetric Will do Inbound-Outbound precaching You cannot mix symmetric/outbound model with symmetric/inbound precache, nor can you mix symmetric/inbound model with symmetric/outbound Precache / 25 Rev : 1.2.3

14 IAX2 should be used if possible but SIP or H323 should function as well if properly configured / 25 Rev : 1.2.3

15 Qualify ScopServ will send a command regularly to check that the device is still online. If the device does not answer within the configured (or default) period (milliseconds) Asterisk considers the device off-line for future calls. Default : true Register You will register to the other party when it does not know your IP Address, it might be DHCP. Authentication Key (Incoming) Key (Outgoing) In Authentication you have to keys that need to be created in Tools, RSA Keys (see Volume 2) The ScopServ PBX does not neglect security that is why RSA keys are necessary. DUNDi Permissions Tab Permission assignment to peers are made here, leave the default all, all values then after you create you mappings they will be available here. e164 is the default DUNDi Class of Service, you can use this context without using other context and DUNDi will work, but to create a specific enterprise Class of Service». There is more work involved since a pending update will support Custom DUNDi Class of Service definition; in this book, I have created a class of service called [private] / 25 Rev : 1.2.3

16 As of today 04/18/2006 only the e164 default context is provided in the ScopServ configurations, but an update should be released soon the enable the creation of Custom Class of Service», but I you are a ScopServ customer and you feel you need these Custom Class of Service you can me at support@scopserv.com or steeves@scopserv.com and I will on request provide instruction on editing the ScopServ configuration files manually is order to help you achieve this / 25 Rev : 1.2.3

17 Figure My advice is to Include all and permit all with e164, but here I have chosen to create a custom class called [private] which I did not include for this peer. At least you will have the proper examples for the upcoming ScopServ update that will support the creation of generic DUNDi Class of Services / 25 Rev : 1.2.3

18 Chapter 3 DEFINING DUNDI MAPPINGS (DUNDI CLASS OF SERVICE) The System Default (e164) All DUNDi peers should have these e164 mappings. ScopSer intrinsically has the e164 mappings and the web interface will be updated to support custom mapping soon (spring 2006). These are the mapping that has to be created for e164, two of them have a weight of zero, and one of 100 and the last but not the least has a 500 weight. These weight can be from but when using e164 it is preferred to follow the established convention / 25 Rev : 1.2.3

19 Here is an excerpt from the DUNDi GPA (General Peering Agreement) This agreement can be downloaded here: Weight Range Requirements 0 99 May only be used under authorization of Owner May only be used by the Owner s service provider, regardless of authorization Reserved do not use for e164 context May only be used by the owner of the code under which the Owner s number is a part of May be used by any entity providing access via direct connectivity to the Public Switched Telephone Network May be used by any entity providing access via indirect connectivity to the Public Switched Telephone Network (e.g. Via another VoIP provider) 600 Reserved do not use for e164 context. Source Digium General Peering Agreement (GPA) / 25 Rev : 1.2.3

20 Creating Class of Services for a Mapping In this example, I will show you how to create four Classes of Services that belong to the e164 mapping. Figure Mappings Tab Figure / 25 Rev : 1.2.3

21 This is the missing mapping of the next figure; you will need to replace the private dundi-private-local with this one dundi-e164-local. You will need to create these 4 mappings (DUNDi Class of Service) dundi-e164-customers dundi-e164-canonical dundi-e164-via-pstn dundi-e164-local Figure / 25 Rev : 1.2.3

22 Chapter 4 INCLUDING TELEPHONY OBJECTS IN DUNDI Phone Extension Extension are the reason for DUNDi to be (a mesh of phone extensions) Figure Including in DUNDi means that the extension is now part of the Class of Service and will be listed for look-ups and callable by allowed peers. Depending on the class of service where it belongs the extension will or will not be exposed to peers depending on if those peers are of these types / 25 Rev : 1.2.3

23 Symmetric Inbound Experimentation will be the key to grasping DUNDi, its took me nearly a week to figure out this poorlydocumented pbx feature, but it was damn worth the try, it is as amazing as DNS is to web browsers. DUNDi acts as an INTER-PBX Routing system that can use IAX,SIP or H323 it is protocol agnostic and that is what that can bring together differently configured ScopServ boxes. Outgoing Lines Figure Line configuration should be done carefully here is a typical DUNDi Outgoing line setup. Figure / 25 Rev : 1.2.3

24 Incoming lines All there is to say about this is that you can include an incoming line to redirect dundi traffic for perr to peer in order to stay out of the PSTN as much as possible / 25 Rev : 1.2.3

25 Testing you Mappings To Test these mapping with the a Linux console (This can only be done by a remote peer) If you machine is for example scopserv3 then you could test the lookups from scopserv1 Figure Type help for all the callable functions / 25 Rev : 1.2.3