Actions

Troubleshooting Toolpack: Difference between revisions

(Link to support portal instead of support email)
 
(12 intermediate revisions by 3 users 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 switch the management IP Address of the TMG800/TMG3200 from static to DHCP or from DHCP to static.'''
*See '[[TMG:Change_Management_IP_Address|How to change the management IP address of a TMG800/TMG3200]]'
*For older systems, see '[[TBLinux:How to change the ip address|How to manually 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]]
'''<br>'''
'''Problem: Cannot ping VoIP interface'''
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>


== Web portal  ==
== Web portal  ==


'''Problem: The 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>
<br>'''Problem: I cannot perform addition or modification of configuration in the web portal. '''
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.  
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]]'
*See 'How to [[Toolpack Troubleshooting:Cannot Add or Edit Configuration|Edit the active configuration]]'
<br>
<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>  
<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>  
All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:
*[[Toolpack:Database_Backup_C|Database backup procedure]]
<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]]


For releases before 2.4 or older or if you do not have access to the web portal, see [[Manual Database Backup]].<br>
<br>
 
<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]]  
A new page is created here: [[How to troubleshoot call routing|How to troubleshoot call routing]]  
 
<br>
<br>


== Fax Calls  ==
== Fax Calls  ==
Problem: '''Fax call is not working'''
*Please follow the instructions here: [[How to troubleshoot Fax Calls|How to troubleshoot Fax Calls]]
<br>


Problem: '''Fax call is not working'''  
== 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>


Please follow the instructions here: [[How to troubleshoot Fax Calls|How to troubleshoot Fax Calls]]  
== 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>
<br>


== SS7 CIC group is locally blocked<br>  ==
== 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>


*See [[SS7 Circuit group control]]
== 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>  
<br>  


== How to gather all logs<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: Which application logs should I gathered?
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>


*See '[[Toolpack Debug Application:Tbdebug|How to gather logs with tbdebug]]'
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>
<br>


== 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 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