OpenPBX.org How to use the dialplan checking and conversion script

Background

CallWeaver uses hash values to identify variables and application names in the dialplan. This is much faster and more efficient than the character-by-character string comparison method used in Asterisk. However, it leads to case sensitive variables and application names.

Also, AGI has been renamed to OGI to avoid any potential trademark disputes and Macro has been renamed to Proc because it was a misnomer as macros do not execute in their own stack, procedures do.

Therefore, a dialplan checking and conversion script is provided so that users who migrate from Asterisk can automatically check and convert their dialplan. This page describes how to use this script.

Some important notes



Using the script

  • For help type
    • $ ./chkDialplan.pl (Usage: ./chkDialplan.pl [modify|validate])

  • If extensions.conf or applications.txt are not found or are not in the same directory, you will get some errors.
  • ALL the configuration files you want to check or convert need to be in the same directory as the above files
  • The script will automatically build a list of included files in extensions.conf

Checking your dialplan

  • To check your dialplan type:
    • $ ./chkDialplan.pl validate
      • This will generate a log file with some lines like this:
        • extensions.conf:41: 'exten => s-BUSY,2,wait(4)' should be Wait
          • That means in extensions.conf, on line 41 you need to make that change

  • If you get the following message:
    • Unknown command: Voicemail2
      • This means we either dont support that application or our applications.txt is outdated.
      • Please log in to the CLI and type: CLI> show applications and look for it.

Modifying your dialplan

  • To modify your dialplan type:
    • $ ./chkDialplan.pl modify
      • This will rename all your original files to .bak

  • If you get the following message:
    • Unknown command: Voicemail2
      • This means we either dont support that application or our applications.txt is outdated.
      • Please log in to the CLI and type: CLI> show applications and look for it.

Bugs/Suggestions/Complaints



More info

OpenPBX.org wiki on VoIP-Info.org | CallWeaver home page | CallWeaver wiki | OpenPBX SVN repository and bugtracker

Background

CallWeaver uses hash values to identify variables and application names in the dialplan. This is much faster and more efficient than the character-by-character string comparison method used in Asterisk. However, it leads to case sensitive variables and application names.

Also, AGI has been renamed to OGI to avoid any potential trademark disputes and Macro has been renamed to Proc because it was a misnomer as macros do not execute in their own stack, procedures do.

Therefore, a dialplan checking and conversion script is provided so that users who migrate from Asterisk can automatically check and convert their dialplan. This page describes how to use this script.

Some important notes



Using the script

  • For help type
    • $ ./chkDialplan.pl (Usage: ./chkDialplan.pl [modify|validate])

  • If extensions.conf or applications.txt are not found or are not in the same directory, you will get some errors.
  • ALL the configuration files you want to check or convert need to be in the same directory as the above files
  • The script will automatically build a list of included files in extensions.conf

Checking your dialplan

  • To check your dialplan type:
    • $ ./chkDialplan.pl validate
      • This will generate a log file with some lines like this:
        • extensions.conf:41: 'exten => s-BUSY,2,wait(4)' should be Wait
          • That means in extensions.conf, on line 41 you need to make that change

  • If you get the following message:
    • Unknown command: Voicemail2
      • This means we either dont support that application or our applications.txt is outdated.
      • Please log in to the CLI and type: CLI> show applications and look for it.

Modifying your dialplan

  • To modify your dialplan type:
    • $ ./chkDialplan.pl modify
      • This will rename all your original files to .bak

  • If you get the following message:
    • Unknown command: Voicemail2
      • This means we either dont support that application or our applications.txt is outdated.
      • Please log in to the CLI and type: CLI> show applications and look for it.

Bugs/Suggestions/Complaints



More info

OpenPBX.org wiki on VoIP-Info.org | CallWeaver home page | CallWeaver wiki | OpenPBX SVN repository and bugtracker
Created by: xming, Last modification: Wed 29 of Nov, 2006 (22:07 UTC) by sb_mx
Please update this page with new information, just login and click on the "Edit" or "Discussion" tab. Get a free login here: Register Thanks! - Find us on Google+