Actions

Troubleshooting Toolpack: Difference between revisions

(moved content)
 
(Link to support portal instead of support email)
 
(61 intermediate revisions by 7 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: '''The system does not work properly with a copied configuration.'''
*See [[Web Portal:Configuration Copy|How to copy a configuration]]
<br>


== Web portal ==
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:
*See [[How to setup ssh tunnel with PuTTY]]
<br>


Problem:
== System configuration backup<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: '''How do I&nbsp;make sure I keep my system configuration?'''<br>


Problem:
All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:
: Do not have permission to add features.
*[[Toolpack:Database_Backup_C|Database backup procedure]]
*How to modify system configuration
<div class="mw-collapsible mw-collapsed" data-collapsetext="other versions" data-expandtext="Click here for older versions" style="width: 400px;">
<br/>
*[[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/>
</div>
<br>
This could also be useful: [[Scheduled Database Backup]]


<br>


Problem:
== Calls  ==
: The system does not work properly with a copied configuration.
Problem: '''The Tmedia device does not accept or generate calls'''
*How to [[Web_Portal:Configuration_Copy|copy a configuration]]
*See here: [[How to troubleshoot call routing|How to troubleshoot call routing]]  
<br>


== Fax Calls  ==
Problem: '''Fax call is not working'''
*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)
*How to get the protocol messages by [[Toolpack_Debug_Application:Tbsigtrace|using tbsigtrace]]
<br>
 
== 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>
 
Problem: '''I lost the SSH password'''
*It is possible to reset the SSH password. please open a case on [https://telcobridges.odoo.com/ TelcoBridges support portal]
<br>
 
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 open a case on [https://telcobridges.odoo.com/ TelcoBridges support portal] 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>
 
== Installation (for developers)  ==
Problem: '''Toolpack fails during installation'''
*See [[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]
<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.
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>
 
Problem: '''I want to change the hostname of the server running Toolpack'''
*See [[Toolpack Installation:Change hostname|How to change the host name]]
<br>
 
== How to submit a problem  ==
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]]'
 
[[Category:Tdev_OAM&P|Troubleshoot]]

Latest revision as of 15:15, 12 November 2025

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


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.


This could also be useful: 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


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 open a case on TelcoBridges support portal 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