Troubleshooting Toolpack

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Added new link to call troubleshooting)
(System configuration backup)
 
(13 intermediate revisions by one user not shown)
Line 2: Line 2:
  
 
<br>  
 
<br>  
 
== Installation  ==
 
 
'''Problem: Toolpack fails during installation'''
 
 
*See '[[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]'
 
 
'''Problem: The Toolpack system does not start'''
 
 
*See '[[Toolpack Installation:Validate Toolpack Installation|How to validate the Toolpack installation]]'
 
 
<br> '''Problem: I want to change the Ip Address of the TMG800/TMG3200 from static to DHCP or from DHCP to static.'''
 
 
*See '[[TBLinux:How to change the ip address|How to change the IP address of a TMG800/TMG3200]]
 
 
<br> '''Problem: I want to change the hostname of the server running Toolpack'''
 
 
*See '[[Toolpack Installation:Change hostname|How to change the host name]]'
 
 
<br>
 
 
'''Problem: E1 trunks are not up'''<br>
 
 
*See '[[How to Debug Trunk Interfaces|How to debug trunk interfaces]]'<br>
 
 
<br>
 
 
'''Problem: Can't download a new software package '''<br>
 
 
You see this error while trying to download a software package with wget:<br>
 
 
''Resolving download.telcobridges.com... failed: Temporary failure in name resolution.<br>wget: unable to resolve host address `download.telcobridges.com'''
 
 
*See "nameserver" in&nbsp; [[TBLinux:How to change the ip address|How_to_change_the_ip_address]]
 
  
 
== Web portal  ==
 
== Web portal  ==
  
'''Problem: The Toolpack web portal does not start or is not accessible.'''  
+
Problem: '''The web portal does not start or is not accessible.'''  
 
+
*See '[[Toolpack Troubleshooting:Web Portal|How to troubleshoot the web portal]]'
*See '[[Toolpack Troubleshooting:Web Portal|How to troubleshoot the web portal]]'  
+
<br>
*See 'How to get status of the system'
+
Problem: '''I cannot perform addition or modification of configuration in the web portal. '''
*See 'How to change the configuration of the system'
+
Usually this occurs in a new Toolpack Platform, for example, when new Toolpack software has been just installed on a host or a new TMG3200 is started up.  
 
+
*See '[[Toolpack Troubleshooting:Cannot Add or Edit Configuration|How to edit the active configuration]]'
<br>'''Problem: I cannot perform addition or modification of configuration in the web portal. Usually this occurs in a new Toolpack Platform, for example, when new Toolpack software has been just installed on a host or a new TMG3200 is started up.'''
+
<br>
 
+
*See 'How to [[Toolpack Troubleshooting:Cannot Add or Edit Configuration|Edit the active configuration]]'
+
 
+
<br>'''Problem: Do not have permission to add features.'''
+
 
+
*See 'How to modify system configuration'
+
 
+
<br>'''Problem: The system does not work properly with a copied configuration.'''
+
  
 +
Problem: '''The system does not work properly with a copied configuration.'''
 
*See [[Web Portal:Configuration Copy|How to copy a configuration]]
 
*See [[Web Portal:Configuration Copy|How to copy a configuration]]
 +
<br>
  
<br>'''Problem: There are no web browser on the linux host server'''  
+
Problem: '''There are no web browser on the linux host server'''  
 
+
 
ssh tunnel can be use to re-direct the connection on a remote host port to a local port:  
 
ssh tunnel can be use to re-direct the connection on a remote host port to a local port:  
 
 
*See [[How to setup ssh tunnel with PuTTY]]
 
*See [[How to setup ssh tunnel with PuTTY]]
 +
<br>
  
== System configuration backup<br> ==
+
== System configuration backup<br> ==
  
'''Problem: How do I&nbsp;make sure I keep my system configuration?'''<br>
+
Problem: '''How do I&nbsp;make sure I keep my system configuration?'''<br>  
 
+
All the configuration is stored in a MySQL database. See [[Toolpack_v2.5:Database_Backup|Database Backup]].<br>
+
 
+
For releases before 2.4 or older or if you do not have access to the web portal, see [[Manual Database Backup]].<br>
+
  
 +
All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:
 +
*[[Toolpack:Database_Backup_C|Backup procedure for v2.8 or 2.9]]
 +
*[[Toolpack:Database_Backup_B|Backup procedure for v2.7]]
 +
*[[Toolpack:Database_Backup_A|Backup procedure for v2.5 or v2.6]] <br>
 +
For releases before 2.4 or older or if you do not have access to the web portal, see [[Manual Database Backup]].<br>
 +
<br>
 +
For scheduled backups, see [[Scheduled Database Backup]]
  
 +
<br>
  
 
== Calls  ==
 
== Calls  ==
 
 
Problem: '''The Tmedia device does not accept or generate calls'''  
 
Problem: '''The Tmedia device does not accept or generate calls'''  
 +
*See here: [[How to troubleshoot call routing|How to troubleshoot call routing]]
 +
<br>
  
*To debug calls, different methods can be used:
+
== Fax Calls  ==
 
+
Problem: '''Fax call is not working'''  
:*'''Using the Call Detail Records'''
+
*Please follow the instructions here: [[How to troubleshoot Fax Calls|How to troubleshoot Fax Calls]]  
 
+
<br>
This can be done in the configuration database, using [[RADIUS]] or in text files. See [[Text Call Detail Records (CDR)]]  
+
  
 +
== SS7 CIC group is locally blocked<br>  ==
 +
Problem: '''A SS7 Circuit Identification Code is blocked.''' <br>
 +
*You can control this: See [[SS7 Circuit group control]]
 
<br>  
 
<br>  
  
*'''Using the web portal status'''
+
== Network Interfaces <br>  ==
<pre>Status -&gt; NAP -&gt; Edit
+
Problem: '''E1 trunks are not up'''<br>  
</pre>  
+
*See '[[How to Debug Trunk Interfaces|How to debug trunk interfaces]]'<br>
You can see how many instantaneous calls incoming, outgoing, in the last hour, in the last 24 hours, etc.
+
 
+
 
<br>  
 
<br>  
  
*'''Using the log files'''
+
Problem: '''Cannot ping VoIP interface''' <br>
 +
The IP address of the VoIP port is configured and you cannot ping it.<br>
 +
*See '[[How to debug VoIP|How to debug a VoIP interface]]'<br>
 +
<br>
  
:*'''Log files from web portal'''
+
== How to gather all logs<br>  ==
 +
Problem: '''Which application logs should I gather?'''  
 +
*See '[[TBReport|How to gather all logs with TBReport]]' (Version 2.9 and up)
 +
<br>
  
  Logs -&gt; Select filename -&gt; 2000 lines -&gt; select Read
+
== Access to unit ==
 
+
Problem: '''I lost access to the unit. How to recover the IP address of the unit?'''  
<br>Brief details on the application:
+
*Please follow the procedure in the installation guide: '[[Product_Installation|Installation Guides]]'
 
+
<br>  
::'''gateway''' application is for high-level call routing, like calling number and NAPs.
+
 
+
::'''toolpack_engine''' handles the protocols and media
+
 
+
::'''toolpack_sys_manager''' handles the configuration of the system
+
 
+
::'''tboamapp''' controls the startup of the applications
+
 
+
::'''tbstreamserver''' is used for playing and recording files; by default this application is not started. See [[How to Start Stream Server]]
+
 
+
::'''tblogtrace''' are log coming from the platform (TMP6400 or other)
+
 
+
<br>You can change the trace level of the application here:
+
 
+
  Applications-&gt; Configurations -&gt; edit -&gt; Log Params -&gt; Default Trace Level
+
 
+
And then activate the new configuration.
+
  
 +
Problem: '''I lost the SSH password'''
 +
*It is possible to reset the SSH password. Please contact support@telcobridges.com to get the procedure.
 
<br>  
 
<br>  
  
*'''Log files from server'''
+
Problem: '''I want to do a factory reset'''  
 
+
*Normally a Factory Reset is not required. System can be re-configured to original settings in a few steps. Please contact support@telcobridges.com to get the procedure.
You can get the files directly from the server running Toolpack. Connect SSH to the management port of the unit and get the files at this location:  
+
*Factory reset is available on recent versions of the TelcoBridges units. The procedure is described here: '[[Factory_Reset|Factory Reset]]'.
 
+
<br>
  /lib/tb/toolpack/setup/12358/2.3/apps/
+
 
+
or
+
 
+
  C:\TelcoBridges\toolpack\setup\12358\2.3\apps\
+
  
 +
== Installation (for developers)  ==
 +
Problem: '''Toolpack fails during installation'''
 +
*See '[[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]'
 
<br>  
 
<br>  
  
*'''Using the signaling traces'''
+
Problem: '''Can't download a new software package '''<br>
 
+
*You see this error while trying to download a software package with wget:<br>
You can get the signaling traces (SS7, ISDN and SIP) using the tbsigtrace program: [[Toolpack Debug Application:Tbsigtrace|using tbsigtrace]]  
+
Resolving download.telcobridges.com... failed: Temporary failure in name resolution.
 +
wget: unable to resolve host address `download.telcobridges.com
 +
*See "nameserver" in&nbsp; [[TMG:Change_Management_IP_Address|Configure Management IP address]]
 +
<br>
  
 +
Problem: '''The Toolpack system does not start'''
 +
*See '[[Toolpack Installation:Validate Toolpack Installation|How to validate the Toolpack installation]]'
 
<br>  
 
<br>  
  
*'''Using the&nbsp;Toolpack programs backdoor tool'''
+
Problem: '''I want to change the hostname of the server running Toolpack'''  
 
+
*See '[[Toolpack Installation:Change hostname|How to change the host name]]'
You can access to the toolpack applications directly by using the ''tbx_cli_tools_remote ''application. This application allows full control over any Toolpack application. This allows for example to view real time calls going through the Toolpack Engine.
+
 
+
Select this to&nbsp;learn&nbsp;[[How to use tbx cli tools remote program]].
+
 
+
 
+
 
+
A new page is created here: [[How to troubleshoot call routing|How to troubleshoot call routing]]
+
 
+
== How to gather all logs  ==
+
 
+
Problem: Which application logs should I gathered?
+
 
+
*See '[[Toolpack Debug Application:Tbdebug|How to gather logs with tbdebug]]'
+
 
+
 
<br>  
 
<br>  
  
== How to get a dump for a crashed Toolpack application  ==
 
 
When one of the Toolpack application crashes, log files are most likely useless, since most of the time the crash is unrelated to the few traces found in the log files. <br> In order to debug a crash, TelcoBridges needs other debugging information (the "call stack" of the crashed application thread). <br> Procedure to get that information can be found here: <br> For release 2.5 and up, see '[[Support:How To Get Toolpack Crash Dump]]' <br> For release 2.4 and up, see '[[Support:How To Run Toolpack Application In gdb]]'
 
 
*Help our support team help you by giving as much information as possible; see '[[Support:How To Submit A Problem]]'
 
  
 
== How to submit a problem  ==
 
== How to submit a problem  ==
 
+
Problem: '''I don't know what else to do'''
Problem: I don't know what else to do  
+
*Help our support team help you by giving as much information as possible; see '[[Support:How To Submit A Problem|How To Submit A Problem]]'
 
+
*Help our support team help you by giving as much information as possible; see '[[Support:How To Submit A Problem]]'
+
  
 
[[Category:Tdev_OAM&P|Troubleshoot]]
 
[[Category:Tdev_OAM&P|Troubleshoot]]

Latest revision as of 06:20, 6 April 2017

This page contains pointers to help troubleshoot Toolpack-based systems.


Contents

Web portal

Problem: The web portal does not start or is not accessible.


Problem: I cannot perform addition or modification of configuration in the web portal. Usually this occurs in a new Toolpack Platform, for example, when new Toolpack software has been just installed on a host or a new TMG3200 is started up.


Problem: The system does not work properly with a copied configuration.


Problem: There are no web browser on the linux host server ssh tunnel can be use to re-direct the connection on a remote host port to a local port:


System configuration backup

Problem: How do I make sure I keep my system configuration?

All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:

For releases before 2.4 or older or if you do not have access to the web portal, see Manual Database Backup.

For scheduled backups, see Scheduled Database Backup


Calls

Problem: The Tmedia device does not accept or generate calls


Fax Calls

Problem: Fax call is not working


SS7 CIC group is locally blocked

Problem: A SS7 Circuit Identification Code is blocked.


Network Interfaces

Problem: E1 trunks are not up


Problem: Cannot ping VoIP interface
The IP address of the VoIP port is configured and you cannot ping it.


How to gather all logs

Problem: Which application logs should I gather?


Access to unit

Problem: I lost access to the unit. How to recover the IP address of the unit?


Problem: I lost the SSH password

  • It is possible to reset the SSH password. Please contact support@telcobridges.com to get the procedure.


Problem: I want to do a factory reset

  • Normally a Factory Reset is not required. System can be re-configured to original settings in a few steps. Please contact support@telcobridges.com to get the procedure.
  • Factory reset is available on recent versions of the TelcoBridges units. The procedure is described here: 'Factory Reset'.


Installation (for developers)

Problem: Toolpack fails during installation


Problem: Can't download a new software package

  • You see this error while trying to download a software package with wget:
Resolving download.telcobridges.com... failed: Temporary failure in name resolution.
wget: unable to resolve host address `download.telcobridges.com


Problem: The Toolpack system does not start


Problem: I want to change the hostname of the server running Toolpack



How to submit a problem

Problem: I don't know what else to do

Personal tools