• Idefisk
  • Tools
  • Tutorials
  • Reviews
  • VoIP Providers
  • Archives
ZOIPER softphone
Back to Tutorials

6.1.2.18. DBdeltree (dialplan application)

1. DBdeltree - this application allows you to remove a whole key tree from the Asterisk’s database.

NOTE: This application is valid for Asterisk version 1.0.9 and above.

 


Syntax:

DBdeltree(family[/keytree]) ;keytree is an optional argument

 


Purpose and usage

The purpose of this application is to allow you to delete a whole key tree from the Asterisk’s database. This application has absolutely the same effect as the CLI command - database deltree <family> [<keytree>].

However, it gives you more flexibility, because you can manage the Asterisk’s database in your extensions.conf file.

 


Prerequisites

To use this application you need a working Asterisk PBX with registered users in iax.conf, sip.conf or mgcp.conf(It depends on which protocol you would like to use) and made extensions.

To see how the application works we recommend to use our IAX softphone Idefisk. You can download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.

 


Asterisk PBX configurations

NOTE: This is only an example of what for you can use this application. Of course you can use it and for other things.

We need one registered users in iax.conf file. This is because we are going to use the IAX2 protocol. If you want to use other protocol such as SIP or MGCP, you have to do the configurations below respectively in sip.conf or mgcp.conf.

iaxoneuser.jpg

So, we have registered the user user1.

Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.

extDBdeltree.jpg

On the picture above you can see our extensions.conf file.

In our example, when somebody dials 1010, the call will be answered by the Answer application. The next executed extension will be the one which contains the DBput application. In the Asterisk’s it will create the family test with key new/data/user and value 122. Then we have one extension with the Wait application. This application will allow us to wait 15 seconds before the next extension to be executed. This will give us enough time to check whether the key new/data/user is stored on the database. We will achieve this by entering the CLI command database show. The result of this command could be seen below.

databaseDBdelt.jpg

As you can see on the screenshot, the family test with key new/data/user is presented in the database. It is on the last line.

The extension with the next priority contains the application DBdeltree. In its brackets, as argument we have written the following test. This will cause the deleting of the family test with the whole key treenew/data/user from the Asterisk’s database. As you can see the only argument, which we have to use, is the name of the family. In our case test.
Again, you can check whether the operation is successful by typing the command database show on the CLI of your system. The result show be the following:

databaseDBdelt1.jpg

Comparing the picture above with the previous one, you can notice, that the family test with key new/data/user is removed from the database.

In order to be sure, that the Asterisk PBX will hang up the line after the conversation is over, it is always a good idea to make an extension for hanging up.

NOTE: The difference between the applications DBdel and DBdeltree is that the first one could delete only one key and the second one could delete a whole key tree. Also, the first one takes as argument the name of the family and the key, while the second one could take only the name of the family.

 


2. Screenshots of what you can see on your Idefisk and on the CLI of the Asterisk PBX

cliDBdelt.jpg

 


3. Additional information

For more information about extensions.conf you can check here.
For more information about iax.conf you can check here.

This application is tested with our IAX softphone Idefisk. You can download it from here. For more information about this softphone please read our tutorial.

If you would like to test this application with the SIP channel you can read our tutorials about the SIP Softphones to learn how to configure them to work with Asterisk PBX

 


4. Similar dialplan applications

DBget()
DBput()
DBdel()

 

 
Add Comment
Name:
Email:
Comment:
In order to prevent automatic posting on our website, we kindly request you to type in the number you see in the picture below.
Image Verification:
 

Latest Headlines:

  • T.38 faxing with Zoiper 2.15 is now easier than ever
    section: voip software
  • Asterisk 1.4.21 Released
    section: Asterisk
  • Asterisk 1.4.20 Released
    section: Asterisk
  • Asterisk 1.4.20-rc2 Released
    section: Asterisk
  • Asterisk 1.4.20-rc1 Now Available
    section: Asterisk
  • News Archives (older news)

Latest Tutorials:

  • Sending Fax from Zoiper to Zoiper using T.38
    added 08/Dec/2008 18:16
  • VMAuthenticate (dialplan application)
    added 01/Mar/2008 15:57
  • Siptronic ST-530
    added 06/Nov/2007 17:57
  • Siemens C455 IP hardphone
    added 05/Nov/2007 10:24
  • Zoiper
    added 22/Oct/2007 17:53

Latest Comments:

  • https://donde-ver-ant-man-y-la-avispa-qu...
    tutorial: Digium Wildcard TE405 / Wildcard TE410P
  • https://donde-ver-scream-6-tyt.statuspag...
    tutorial: Digium Wildcard TE405 / Wildcard TE410P
  • https://donde-ver-guardianes-de-la-noche...
    tutorial: Digium Wildcard TE405 / Wildcard TE410P
  • https://donde-ver-demon-slayer-villa-de-...
    tutorial: Digium Wildcard TE405 / Wildcard TE410P
  • https://www.reddit.com/r/BenavidezvPlant...
    tutorial: Digium Wildcard TE405 / Wildcard TE410P
 
contact us at: support@asteriskguru.com - asterisKGuru.com © all rights reserved   |   *asterisk is registered trademark of © Digium™