Troubleshooting Toolpack

Revision as of 09:03, 11 May 2011

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

Installation

Problem: Toolpack fails during installation

• See 'Toolpack installer troubleshooting'

Problem: The Toolpack system does not start

• See 'How to validate the Toolpack installation'

Problem: I want to change the Ip Address of the TMG800/TMG3200 from static to DHCP or from DHCP to static.

• See 'How to change the IP address of a TMG800/TMG3200'

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

• See 'How to change the host name'

Problem: E1 trunks are not up

• See 'How to debug trunk interfaces'
  

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'

• See "nameserver" in  How_to_change_the_ip_address

Problem: Cannot ping VoIP interface

The IP address of the VoIP port is configured and you cannot ping it.

• See 'How to debug a VoIP interface'
  

Web portal

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

• See 'How to troubleshoot the web portal'
• See 'How to get status of the system'
• See 'How to change the configuration of the system'

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 'How to Edit the active configuration'

Problem: Do not have permission to add features.

• See 'How to modify system configuration'

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

• See How to copy a 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:

• See How to setup ssh tunnel with PuTTY

System configuration backup

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

All the configuration is stored in a MySQL database. See Database Backup.

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

A new page is created here: How to troubleshoot call routing

How to gather all logs

Problem: Which application logs should I gathered?

• See 'How to gather logs with tbdebug'

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.
In order to debug a crash, TelcoBridges needs other debugging information (the "call stack" of the crashed application thread).
Procedure to get that information can be found here:
For release 2.5 and up, see 'Support:How To Get Toolpack Crash Dump'
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

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'