debugging_via_de_cli

Debugging via command line interface (CLI)

When things do not work as you think then us the command line access to obtain more information. There is information about the system. This will provide information such as:

  • phone provisioning
  • system condition
  • information from applications

You can also find specific information about the SIP messaging. If you need to understand the SIP signalling it may be needed to hire a consultant to do this work.

Recommended: http://blog.gahooa.com/2011/06/07/optimal-putty-settings-for-ssh-connections-to-linux/

Showing system messages

Use any SSH client such as OpenSSH or putty to connect to the PBX. Log in as user “admin”. Once the correct password has been given you can enter the command “help”, this will show you all available commands. All commands are entered without quotes.

  • show application information: “tail -f syslog”
  • show system status: “dmesg”
  • show phone application messages: “tail -f error.log”

The command “tail -f” will scroll when new information arrives. Use the command “more” to browse through it. Or copy&paste it in some editor to read it. You can also make your scroll history to unlimited and simply scroll back.

Debugging PBX functions

Use any SSH client such as OpenSSH or putty to connect to the PBX. Login as user admin with the right password.

  1. command: aox_console
  2. “core set verbose 3” (or 99 to see more)
  3. “core set debug 1”
  4. when done do not forget to “core set verbose 3” (or 0 to shut it off)
  5. when done do not forget to “core set debug 0”

If you leave make sure you disable it all, as it will put unnecessary load to your machine.

Debugging SIP signalling

Sometimes with network trouble or during installation you want to know what the SIP provider, phones or PBX are really talking about if talking at all to each other. Then you can use SIP debug. This will produce a lot of information on your screen. Do not forget to switch debugging off once done! It uses unnecessary CPU cycles and IO.

  1. command: aox_console
  2. “core set verbose 99”
  3. “core set debug 9”
  4. sip set debug on (sip set debug ip <IP_address>)
  5. when done: “sip set debug off”
  6. when done do not forget to “core set verbose 3” (or 0 to shut it off)
  7. when done do not forget to “core set debug 0”

Log off

Other useful commands are:

  • sip show peers
  • sip show peer <name of peer>
  • sip show channels
  • sip show registry
  • sip show subscriptions (BLF)
debugging_via_de_cli.txt · Last modified: 2015/03/11 14:08 (external edit)