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

From berofix - professional SIP gateway
Jump to: navigation, search
(Install PowerDebug server as Windows Service)
(What is it ?)
 
Line 1: Line 1:
 
=What is it ?=
 
=What is it ?=
<p>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 maybe some of you know, 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. The trace data will be sent from client to server over TCP/IP, and can be stored onto the server which has normally much more storing capacity as the gateway. Long-term debugging is now possible without big efforts.</p><br>
+
<p>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 maybe some of you know, 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 should be examined 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. The trace data will be sent from client to server over TCP/IP, and can be stored onto the server which has normally much more storing capacity as the gateway. Long-term debugging is now possible without big efforts.</p><br>
  
 
=Prerequisites=
 
=Prerequisites=
Line 27: Line 27:
 
#: '''cd \path\to\pwerdebug'''
 
#: '''cd \path\to\pwerdebug'''
 
# Now execute "install-service.bat" in the command line window (which is running as administrator)
 
# Now execute "install-service.bat" in the command line window (which is running as administrator)
#: '''path\powerdebug>.\install-service.bat''' <enter>
+
#:''C:\path\powerdebug>'' '''.\install-service.bat''' <enter>
 
# 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.
 
# 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.
 
# Select this new entry and start the service
 
# Select this new entry and start the service
Line 37: Line 37:
 
#:[[File:client_gui.png|frameless|300px| ]]
 
#:[[File:client_gui.png|frameless|300px| ]]
 
Now everything seems to be ready to run.<br>
 
Now everything seems to be ready to run.<br>
<span style="color:#FF0000">'''IMPORTANT:'''</span> '''If you've enabled the Windows Firewall, you have to take care to allow incoming request on TCP ports 2221 and 8888, or, better, just disable firwall aslong you make a trace. Otherwise client may not able to connect to server,'''
+
<span style="color:#FF0000">'''IMPORTANT:'''</span> '''If you've enabled the Windows Firewall, you have to take care to allow incoming request on TCP ports 2221 and 8888, or, better, just disable firwall as long you make a trace. Otherwise client may not able to connect to server,'''
  
 
=Install PowerDebug as Linux daemon=
 
=Install PowerDebug as Linux daemon=
Line 58: Line 58:
 
=Starting and stopping a trace=
 
=Starting and stopping a trace=
 
To start a trace, follow these steps:
 
To start a trace, follow these steps:
# Log in to the gateway where you've installed the powerdebug app and choos menue item "Apps->powerdebug"
+
# Log in to the gateway where you've installed the powerdebug app and choose menu item "Apps->powerdebug"
 
# Enter the IP address of the machine where you've installed the server application into the field "Server"
 
# Enter the IP address of the machine where you've installed the server application into the field "Server"
 
# Choose technologies which has to be traced with check button group "Protocols to trace", ISDN, Analog, GSM, SIP
 
# Choose technologies which has to be traced with check button group "Protocols to trace", ISDN, Analog, GSM, SIP
Line 69: Line 69:
 
# If you want to stop the trace, just press "Stop" and after a short while, the "ready to start" gui will be appear again with message "STOPPED"
 
# If you want to stop the trace, just press "Stop" and after a short while, the "ready to start" gui will be appear again with message "STOPPED"
 
#:[[File:pd_stopped.png|frameless|300px| ]]
 
#:[[File:pd_stopped.png|frameless|300px| ]]
 
+
<span style="color:#FF0000">'''IMPORTANT:'''</span> '''Please don't start a regular fulltrace while powerdebug is also running a trace. This willl cause more load and incomplete trace on powerdebug-server'''
 
=Where to find the traces=
 
=Where to find the traces=
 
To get a trace file just open the server gui in your prefered browser:
 
To get a trace file just open the server gui in your prefered browser:

Latest revision as of 16:49, 13 April 2016

Personal tools