Troubleshooting

Common Issues

1. Authentication Failures

BASH

# Check credentials
curl -u "system_id:password" <http://localhost/health>

# Verify base64 encoding
echo -n "system_id:password" | base64

2. No SMPP Sessions

BASH

# Check SMPP status
curl <http://localhost/sms/stats>

# Verify configuration
cat hsb.conf

3. Request Timeouts

BASH

# Use async mode for high volume
curl -X POST <http://localhost/v1/sms/submit> \
  -u "system_id:password" \
  -H "Content-Type: application/json" \
  -d '{"from":"Test","to":"447700123456","text":"Test","async":true}'

Debugging

Check Health: curl <http://localhost/health>
View Stats: curl <http://localhost/sms/stats>
Test Auth: Use known good credentials
Check Logs: Review application logs
Verify Config: Validate SMPP configuration

Log Analysis

Look for these key log entries:

Authentication successful for system_id: xxx
HTTP request queued: req_xxx
SMPP response for request xxx
HTTP response sent for request: xxx