Actions

Troubleshooting Toolpack: Difference between revisions

m (Updated tbchangeip link)
(Updated order of items, text, formatting, some links.)
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; [[TMG:Change_Management_IP_Address|Configure Management 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.
All the configuration is stored in a MySQL database.
Line 89: Line 36:


== 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 contact support@telcobridges.com to get the procedure.
<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 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 (todo)]]'.
<br>  


Problem: Which application logs should I gathered?
== Installation (for developers)  ==
Problem: '''Toolpack fails during installation'''
*See '[[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]'
<br>


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


<br>
Problem: '''The Toolpack system does not start'''
*See '[[Toolpack Installation:Validate Toolpack Installation|How to validate the Toolpack installation]]'
<br>  


== How to submit a problem  ==
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: 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  ==
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]]
[[Category:Tdev_OAM&P|Troubleshoot]]

Revision as of 16:11, 9 August 2016

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 is stored in a MySQL database.

For releases before 2.4 or older or if you do not have access to the web portal, see Manual 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 (todo)'.


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