Howto long-term debug with beroNet's tool "PowerDebug"

From berofix - professional SIP gateway
Revision as of 17:36, 29 February 2016 by WikiSysop (Talk | contribs)

Jump to: navigation, search

What is it ?

In many cases problems are not reproducable immediately because they are happening not every time. Or, sometimes audio would be needed inside the trace, and therefore the capacity doesn't reach, or, or, or. Like everyone knows, maybe, beroNet gateways have not much capacity to store traces, that's why often traces are not complete or overwritten with other data, and the sitiuation which was want to be investigated is not included. For all these cases we made "PowerDebug". This tool consists of a server and a client application. The server is written in Java and can run anywhere where a Java VM (JRE) is installed. The client is an App which can be installed on a beroNet gateway.


What do you need to run PowerDebug server/client:

  • Java >= 1.7
  • adminstrative user rights to install Windows service
  • free hdd space to store traces


  • App-FS >= 3.0
  • adminstrative user rights to install the App

Install PowerDebug server as Windows Service

You want to run the server under Windows as Windows Service ? No problem, here are the steps you need to do so:

  1. Download PowerDebug-Package from here:
  2. Unpack zip-file to a directory you want to run this tool and receive traces
  3. You'll get a new directory named "powerdebug-<version>", in which <version> stands for the installed PowerDebug version.
  4. Go to this directory and execute "install-service.bat" as administrator
  5. If everything gone well, you should now have a new entry in the windows "Services" manager named "PowerDebug". If you want to remove the service, just execute "uninstall.bat", as administrator too.
  6. Select this new entry and start the service
  7. Now it's time to check if the server is porperly working. For that you should open a browser and enter this url: http://localhost:8888
    You should see a gui like this:
    Server gui.png
    If you not see this gui, something gone wrong. In this case please refere to KNOWN-ISSUES or contact
  8. Last step is to install the client application onto the gateway. For this, you have to login to the gateway first. Go to the menu "Apps->Market", press "upload file" and choos the app-file which is in the directory "apps" which can be found in the installation dirctory of the server application. There must be a file named "powerdebug-<version>-app.tar.gz". choose this file. After upload you will be asked if you really want to install, choose "yes". After installing the app you should find a new menu entry under "Apps"-menu named "powerdebug". Click this new item and you should be redirected to the powerdebug client gui:
    Client gui.png

Now everything seems to be ready to run.

Install PowerDebug as Linux daemon

Starting and stopping a trace

Where to find the traces

Possible problems