DUNDi
   HOME

TheInfoList



OR:

{{more citations needed, date=April 2018 Distributed Universal Number Discovery (DUNDi) is a
VoIP Voice over Internet Protocol (VoIP), also called IP telephony, is a method and group of technologies for the delivery of voice communications and multimedia sessions over Internet Protocol (IP) networks, such as the Internet. The terms Internet t ...
routing protocol that provides
directory service In computing, a directory service or name service maps the names of network resources to their respective network addresses. It is a shared information infrastructure for locating, managing, administering and organizing everyday items and network ...
s for Asterisk systems. With DUNDi peered nodes share dialplan information with each other. The protocol does not actually carry any calls, but rather provides addressing information. Peers in a DUNDi cluster query other peers for a
telephone number A telephone number is a sequence of digits assigned to a landline telephone subscriber station connected to a telephone line or to a wireless electronic telephony device, such as a radio telephone or a mobile telephone, or to other devices f ...
to which a call is requested by a user. The result of the query is a dial string for the Asterisk application ''Dial''. The protocol was invented by Mark Spencer, the author of Asterisk.


Peers

Asterisk PBX systems that use DUNDi are peered as a cooperating system of DUNDi nodes, each having certain configuration to access a DUNDI instance on at least one other node. In the DUNDi configuration one can limit the number of consecutive lookups between peers by setting the
TTL TTL may refer to: Photography * Through-the-lens metering, a camera feature * Zenit TTL, an SLR film camera named for its TTL metering capability Technology * Time to live, a computer data lifespan-limiting mechanism * Transistor–transistor lo ...
. * A TTL of 1 means you only can ask the peers you know and they cannot ask further. * A TTL of n means that the peer you ask for a lookup can redirect your lookup to the peers it knows, only with a TTL of n-1.


Advertising extensions

Each DUNDi peer can advertise its own extensions and their context. E.g. if you can connect some local E.164 number(s), you can advertise these. DUNDi configuration assigns a priority weight to each advertised extension. Low values represent a high priority and must be chosen first when more than one answer is received from a lookup.


Example

In the Asterisk CLI one can do a lookup by hand to test if a DUNDi configuration works. asterisk1*CLI> dundi lookup 301@priv bypass 1. 0 IAX2/priv:ByWFbOGKgGmZbM43BJHSZw@192.168.1.2/301 (EXISTS) from 00:0c:29:d2:d8:ec, expires in 3600 s DUNDi lookup completed in 113 ms The above DUNDi lookup tells the PBX to ask the known peers if they know how to reach extension 301 in the "priv" network. The answer consists of 6 parts: * The used protocol to communicate is IAX2. * The context-name is "priv". * The secret key of the PBX, which can redirect you to extension 301 is ByW ..SZw (this changes periodically) * The address of this PBX is 192.168.1.2 (or some domainname, should be reachable by the calling party) * The extension to call is 301 (this can be different from what you asked for, e.g. when calls from the outside are not allowed directly to an internal extension) * "EXISTS" tells us the PBX is advertising this number. It is possible the PBX advertises a lot more extensions than really are connected, so it is no guarantee the extension can be reached. In order to prevent the network from overloading and at the same time keep the responses as quick as possible, the involved peers will cache the lookups they see. Because the used keys may become invalid after some period, each lookup has some
expiry date An expiration date or expiry date is a previously determined date after which something should no longer be used, either by operation of law or by exceeding the anticipated shelf life for perishable goods. Expiration dates are applied to selecte ...
. This defaults to one hour. When no context is given with a lookup, DUNDi defaults to the E.164 context. This means you are looking for normal (international) phone-numbers, like 0031201234567 (some bogus number in Amsterdam, the Netherlands) In order to do so, you have to peer with at least one other peer in the ''E164 trust group''. The peers in this group are bound to th
Digium GPA (Digium General Peering Agreement)
( PDF)


External links


DUNDi Home Page

Internet-Draft that expired in 2005


Telephone numbers Network protocols VoIP protocols