04 Troubleshooting

Troubleshooting Common Issues and Solutions

1. Connection Issues

   • FTP/SFTP Connection Failures :
     • Check FTP/SFTP server credentials in .env file
     • Verify firewall settings
     • Ensure correct SERVER_TYPE is set

2. Database Connection Issues

   • Verify PostgreSQL credentials and connection details
   • Check if PostgreSQL service is running

3. File Processing Problems

   • Missing CDR Files
     • Check 3CX_FILES_INTERVAL setting
     • Verify correct file extension (3CX_FILEEXT)
     • Ensure proper permissions on FTP/SFTP server

4. File Archiving/Deletion Issues

   • Check 3CX_FILES_ARCHIVE_OR_DELETE setting
   • Verify write permissions on archive location

5. Data Discrepancies

   • Incorrect Timezone
     • Verify TZ setting in .env file
     • Ensure system time is synchronized
   • Localization Issues
     • Check LOCALE_LANGUAGE setting

6. Docker-related Issues

   • Network Problems
     • Verify DOCKER_SUBNET and DOCKER_GATEWAY settings
     • Check Docker network configuration

7. Container Startup Failures

   • Review Docker logs
   • Ensure all required environment variables are set

8. Grafana Visualization Issues

   • Login Problems
     • Verify GF_SECURITY_ADMIN_PASSWORD
     • Check Grafana container logs
   • Missing or Incorrect Data
     • Verify database connection in Grafana
     • Check query permissions for Grafana database user

9. Logging and Debugging

   • Logs are avaialble trought docker logs
     bash docker logs --follow + container name or in the projectFolder/logs

10. Access to web pages

    • If you can not access to web pages,
      • Check if you have a firewall or proxy blocking the access.
      • Check if ${WEB_SERVER_NAME} is correctly set in .env file
      • Check if ${WEB_SERVER_NAME} can be resolved by your DNS or set up you host file

11. Support Resources

• You can create issues here