Troubleshooting Toolpack

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Calls)
(System configuration backup)
 
(44 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This page contains pointers to help troubleshooting the Toolpack system.
+
This page contains pointers to help troubleshoot [[Toolpack]]-based systems.  
  
 +
<br>
  
== Installation ==
+
== Web portal  ==
  
Problem:
+
Problem: '''The web portal does not start or is not accessible.'''
: The Toolpack system does not start
+
*See '[[Toolpack Troubleshooting:Web Portal|How to troubleshoot the web portal]]'
*How to [[Toolpack_Installation:Validate_Toolpack_Installation|validate the Toolpack installation]]
+
<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.
 +
*See '[[Toolpack Troubleshooting:Cannot Add or Edit Configuration|How to edit the active configuration]]'
 +
<br>
  
Problem:
+
Problem: '''The system does not work properly with a copied configuration.'''
: I want to change the Ip Address of the TMG800/TMG3200 from static to DHCP or from DHCP to static.
+
*See [[Web Portal:Configuration Copy|How to copy a configuration]]
*How to [[TBLinux:How to change_the_ip_address|change the IP address of a TMG800/TMG3200]]
+
<br>
  
Problem:
+
Problem: '''There are no web browser on the linux host server'''
: I want to change the hostname of the server running Toolpack
+
ssh tunnel can be use to re-direct the connection on a remote host port to a local port:
*How to [[Toolpack_Installation:Change hostname]]
+
*See [[How to setup ssh tunnel with PuTTY]]
 +
<br>
  
== Web portal ==
+
== System configuration backup<br>  ==
  
Problem:
+
Problem: '''How do I&nbsp;make sure I keep my system configuration?'''<br>
: The web portal do not start or is not accessible.
+
*How to [[Toolpack_Troubleshooting:Web_Portal|troubleshoot the web portal]].
+
*How to get status of the system.
+
*How to change the configuration of the system.
+
  
Problem:
+
All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:
: 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.
+
*[[Toolpack:Database_Backup_C|Backup procedure for v2.8 or 2.9]]
*How to [[Toolpack Troubleshooting:Cannot Add or Edit Configuration|solve this problem]].
+
*[[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]]
  
Problem:
+
<br>
: Do not have permission to add features.
+
*How to modify system configuration
+
  
 +
== Calls  ==
 +
Problem: '''The Tmedia device does not accept or generate calls'''
 +
*See here: [[How to troubleshoot call routing|How to troubleshoot call routing]]
 +
<br>
  
Problem:
+
== Fax Calls  ==
: The system does not work properly with a copied configuration.
+
Problem: '''Fax call is not working'''
*How to [[Web_Portal:Configuration_Copy|copy a configuration]]
+
*Please follow the instructions here: [[How to troubleshoot Fax Calls|How to troubleshoot Fax Calls]]  
 +
<br>
  
== Toolpack application suite ==
+
== 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>
  
Problem:
+
== Network Interfaces <br>  ==
:
+
Problem: '''E1 trunks are not up'''<br>
 +
*See '[[How to Debug Trunk Interfaces|How to debug trunk interfaces]]'<br>
 +
<br>
  
 +
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>
  
== Calls ==
+
== How to gather all logs<br>  ==
Problem:
+
Problem: '''Which application logs should I gather?'''
: The Tmedia do not accept or generate calls
+
*See '[[TBReport|How to gather all logs with TBReport]]' (Version 2.9 and up)
 +
<br>
  
To debug calls, different methods can be used:
+
== Access to unit ==
 +
Problem: '''I lost access to the unit. How to recover the IP address of the unit?'''
 +
*Please follow the procedure in the installation guide: '[[Product_Installation|Installation Guides]]'
 +
<br>
  
*Use the CDRs, in the configuration database, using Radius or in text files.
+
Problem: '''I lost the SSH password'''
See [[Text Call Detail Records (CDR)]]
+
*It is possible to reset the SSH password. Please contact support@telcobridges.com to get the procedure.
 +
<br>
  
*Log files from web portal
+
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|Factory Reset]]'.
 +
<br>
  
Logs -> Select filename -> 2000 lines -> select Read
+
== Installation (for developers)  ==
Brief details on the application:
+
Problem: '''Toolpack fails during installation'''
 +
*See '[[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]'
 +
<br>
  
a) gateway application is for high-level call routing, like calling number and NAPs.
+
Problem: '''Can't download a new software package '''<br>
b) toolpack_Engine handles the protocols and media
+
*You see this error while trying to download a software package with wget:<br>
c) toolpack_sys_manager handles the configuration of the system
+
Resolving download.telcobridges.com... failed: Temporary failure in name resolution.
d) tboamapp controls the startup of the applications
+
wget: unable to resolve host address `download.telcobridges.com
e) tbstreamserver is used for playing and recording files (by default it is not started)
+
*See "nameserver" in&nbsp; [[TMG:Change_Management_IP_Address|Configure Management IP address]]
f) tblogtrace are log coming from the platform (TMP6400 or other)
+
<br>
  
*You can change the trace level of the application here:
+
Problem: '''The Toolpack system does not start'''
 +
*See '[[Toolpack Installation:Validate Toolpack Installation|How to validate the Toolpack installation]]'
 +
<br>
  
Applications-> Configurations -> edit -> Log Params -> Default Trace Level
+
Problem: '''I want to change the hostname of the server running Toolpack'''
 +
*See '[[Toolpack Installation:Change hostname|How to change the host name]]'
 +
<br>  
  
And then activating the new configuration
 
  
*You can get the files directly from the server at this location:
+
== How to submit a problem  ==
/lib/tb/toolpack/setup/12358/2.3/apps/
+
Problem: '''I don't know what else to do'''
or
+
*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]]'
C:\TelcoBridges\toolpack\setup\12358\2.3\apps\
+
  
*How to get the protocol messages by [[Toolpack_Debug_Application:Tbsigtrace|using tbsigtrace]]
+
[[Category:Tdev_OAM&P|Troubleshoot]]
 
+
== How to gather all logs ==
+
Problem:
+
: Which application logs should I gathered?
+
*How to gathered logs with [[Toolpack_Debug_Application:Tbdebug|tbdebug]]
+
 
+
 
+
== How to submit a problem ==
+
Problem:
+
: Don't know what else to do
+
*Help our support team help you by giving as much information as possible [[Support:How_To_Submit_A_Problem]]
+

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