Troubleshooting Toolpack
(add tbdebug link) |
(→System configuration backup) |
||
(51 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | This page contains pointers to help | + | This page contains pointers to help troubleshoot [[Toolpack]]-based systems. |
+ | <br> | ||
− | == | + | == Web portal == |
− | Problem: | + | Problem: '''The web portal does not start or is not accessible.''' |
− | + | *See '[[Toolpack Troubleshooting:Web Portal|How to troubleshoot the web portal]]' | |
− | *How to [[ | + | <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> | ||
− | + | 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> | ||
− | + | == 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: | |
− | : | + | *[[Toolpack:Database_Backup_C|Backup procedure for v2.8 or 2.9]] |
− | + | *[[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> | ||
+ | <br> | ||
+ | For scheduled backups, see [[Scheduled Database Backup]] | ||
+ | <br> | ||
− | Problem: | + | == Calls == |
− | + | Problem: '''The Tmedia device does not accept or generate calls''' | |
− | * | + | *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> | ||
− | == | + | == 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> | ||
− | == | + | == How to gather all logs<br> == |
− | Problem: | + | Problem: '''Which application logs should I gather?''' |
− | + | *See '[[TBReport|How to gather all logs with TBReport]]' (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: '[[Product_Installation|Installation Guides]]' | ||
+ | <br> | ||
− | + | Problem: '''I lost the SSH password''' | |
− | Problem: | + | *It is possible to reset the SSH password. Please contact support@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|Factory Reset]]'. | ||
+ | <br> | ||
− | == How to submit a problem == | + | == Installation (for developers) == |
− | Problem: | + | Problem: '''Toolpack fails during installation''' |
− | + | *See '[[Toolpack Installation:Toolpack installer troubleshooting|Toolpack installer troubleshooting]]' | |
− | *Help our support team help you by giving as much information as possible [[Support: | + | <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 [[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 06:20, 6 April 2017
This page contains pointers to help troubleshoot Toolpack-based systems.
Contents |
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.
For scheduled backups, see Scheduled Database Backup
Calls
Problem: The Tmedia device does not accept or generate calls
- See here: How to troubleshoot call routing
Fax Calls
Problem: Fax call is not working
- Please follow the instructions here: How to troubleshoot Fax Calls
SS7 CIC group is locally blocked
Problem: A SS7 Circuit Identification Code is blocked.
- You can control this: See SS7 Circuit group control
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?
- See 'How to gather all logs with TBReport' (Version 2.9 and up)
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'
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'.
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
- See "nameserver" in Configure Management IP address
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
- Help our support team help you by giving as much information as possible; see 'How To Submit A Problem'