# Troubleshooting Toolpack

This page contains pointers to help troubleshoot [Toolpack](https://docs.telcobridges.com/wiki/Toolpack)-based systems.

### Web portal

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

* See '[How to troubleshoot the web portal](https://docs.telcobridges.com/wiki/Toolpack_Troubleshooting: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.

* See '[How to edit the active configuration](https://docs.telcobridges.com/wiki/Toolpack_Troubleshooting:Cannot_Add_or_Edit_Configuration)'

<br>

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

* See [How to copy a configuration](https://docs.telcobridges.com/wiki/Web_Portal:Configuration_Copy)

<br>

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](/troubleshooting-and-support/troubleshooting-tips-and-actions/tbsigtrace-signaling-trace-capture-tool/accessing-device/how-to-setup-ssh-tunnel-with-putty.md)

<br>

### System configuration backup<br>

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

All the configuration are stored in a MySQL database. To perform a backup, refer to the following links:

* [Database backup procedure](/configuration-details/configuration-by-web-portal-category/system-settings/database-backup.md)

Click here for older versions

\
This could also be useful: [Scheduled Database Backup](https://docs.telcobridges.com/wiki/Scheduled_Database_Backup)

<br>

### Calls

Problem: The Tmedia device does not accept or generate calls

* See here: [How to troubleshoot call routing](https://docs.telcobridges.com/wiki/How_to_troubleshoot_call_routing)

<br>

### Fax Calls

Problem: Fax call is not working

* Please follow the instructions here: [How to troubleshoot Fax Calls](https://docs.telcobridges.com/wiki/How_to_troubleshoot_Fax_Calls)

<br>

### 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](https://docs.telcobridges.com/wiki/SS7_Circuit_group_control)

<br>

### Network Interfaces<br>

Problem: E1 trunks are not up<br>

* See [How to debug trunk interfaces](https://docs.telcobridges.com/wiki/How_to_Debug_Trunk_Interfaces)<br>

<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 a VoIP interface](https://docs.telcobridges.com/wiki/How_to_debug_VoIP)<br>

<br>

### How to gather all logs<br>

Problem: Which application logs should I gather?

* See [How to gather all logs with TBReport](/troubleshooting-and-support/troubleshooting-tips-and-actions/tbreport.md) (Version 2.9 and up)

<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: [Installation Guides](https://docs.telcobridges.com/wiki/Product_Installation)

<br>

Problem: I lost the SSH password

* It is possible to reset the SSH password. Please contact <helpdesk@telcobridges.com> to get the procedure.

<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](https://docs.telcobridges.com/wiki/Factory_Reset).

<br>

### Installation (for developers)

Problem: Toolpack fails during installation

* See [Toolpack installer troubleshooting](https://docs.telcobridges.com/wiki/Toolpack_Installation: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  [Configure Management IP address](/troubleshooting-and-support/troubleshooting-tips-and-actions/tbsigtrace-signaling-trace-capture-tool/accessing-device/tmg-change-management-ip-address.md)

<br>

Problem: The Toolpack system does not start

* See [How to validate the Toolpack installation](https://docs.telcobridges.com/wiki/Toolpack_Installation:Validate_Toolpack_Installation)

<br>

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

* See [How to change the host name](https://docs.telcobridges.com/wiki/Toolpack_Installation:Change_hostname)

<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 '[How To Submit A Problem](https://docs.telcobridges.com/wiki/Support:How_To_Submit_A_Problem)'


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prosbcdocs.telcobridges.com/maintenance-and-troubleshooting/maintenance-guide/troubleshooting-toolpack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
