Askozia

More documentation is on its way. For the time being, here is a quick start guide referencing some of the m0n0wall documentation. AskoziaPBX is derived from m0n0wall and their documentation is quite verbose.

Writing the Image to Disk

AskoziaPBX is distributed as a compressed, digitally signed disk image. The first step in getting a system up and running is to flash its storage device (hard disk or compact flash) with this image. Unix-like systems can accomplish this task with the dd command. Windows users must download physdiskwrite

The decompressed image currently requires less than 20MB of storage. Any extra space will be ignored by AskoziaPBX. After attaching the target drive to your system, execute one of the following commands to decompress the image onto it.

Be absolutely sure of your target device! If these commands are executed referencing the incorrect device, all data on it will be lost.

• FreeBSD - gzcat pbx-platform-xxx.img | dd of=/dev/rad[n] bs=16k
• Mac - gzcat pbx-platform-xxx.img | dd of=/dev/disk[n] bs=16k
• Linux - gunzip -c pbx-platform-xxx.img | dd of=/dev/hd[x] bs=16k
• Windows - physdiskwrite [-u] pbx-platform-xxx.img

The warning about “trailing garbage” can be safely ignored. This is due to the digital signature. The hard part of setup is now finished, all subsequent system upgrades will be done through the webGUI. (m0n0wall docs section)

Initial Configuration

After successfully getting the system to boot from this media, a network interface must be assigned for the webGUI. Select option ‘1′ from the console menu to assign a network interface. A restart is needed to apply this configuration. (m0n0wall docs section)

The webGUI is at https://192.168.1.2 (/24 subnet) with a username of ‘admin’ and password of ‘askozia’. Either configure a computer to run on this network and access it or set a new LAN IP in the console.

• In the webGUI, the first stop is the “Interfaces -> Network” page. Configure your desired IP, subnet, gateway, DNS and network topology.
• The next stop should be the “System -> General Setup” page. Set a new password, select an appropriate time zone and do any other customization you may wish.
• Now go to “Accounts -> Phones” and click the ‘+’ to add a new phone. Drag the codecs your phone supports into the “enabled” column.
• Once you have configured your phone to use this account, some test extensions are available to you:
  • 0000ECHO - Echo Test
  • 0000MILLI - Milliwatt Line Quality Test
  • CONF - Default Conference Room
• If you have enabled voicemail on this extension by providing an e-mail address, you will need to setup an SMTP server in the “Services -> Voicemail” page.
• If you have a provider you would like to use, go to “Accounts -> Providers” and add one. Select your recently added phone as the “Incoming Extension” so that incoming calls from this provider are directed to it.
• Before you can call out with this provider you will have to re-edit your phone and give it permission in the “Providers” section.

Diagnosing Problems

There are a couple of hidden pages in addition to those in the webGUI to aid in troubleshooting problems.

• /exec.php - execute shell commands, download / upload files
• /status.php - show system status (df, ps, etc.), xml config, raw logs, sip/iax registrations/peers, generated .conf files
• /diag_editor.php - file editor
• /debug_isdn.php - captures ISDN debug output

To toggle extended debugging info in the “Diagnostics -> Logs -> PBX” page, enter the following commands in the “Diagnostics -> Manager Interface” page:

• SIP
  • enable: sip set debug
  • disable: sip set debug off
• IAX
  • enable: iax2 set debug
  • disable: iax2 set debug off
• ISDN
  • enable: capi debug
  • disable: capi no debug