Troubleshooting

Introduction

If you're having problems using SMStoXMPP, please take a look at the following list of notes.

In the event that you are stuck and would like assistance, please file an issue against the bug tracker here so that I can assist and then update the documentation to make it easier for the next person.

Getting Logging Information

Before filing a request for help, please check the log file at: /var/log/smstoxmpp.log

If this doesn't show anything useful, you can increase the logging using the "-d" or "--debug" flag. This can be added to the bootscript to run the application in the background.

Alternatively the application can be run in the foreground with debug by doing smstoxmppd --debug --verbose

or if running from the unpacked source:

./app/dispatcher.php --debug --verbose

Please provide a copy of the log files upon request, if concerned about privacy of the log data please sanitize before uploading.

Common Problems

Daemon unable to start

Check the errors being returned at startup - is the application missing a configuration file, or is PHP giving an error about missing modules/libraries?

Not connecting to XMPP

You must provide the XMPP details for an account which has permissions to open chats to your receiver account (ie the XMPP account that you will send your messages to).

You will also need to authorize/trust the application account the first time that it runs.

Weird XMPP Problems

Check that:

1. You are not using the same XMPP account details for multiple SMS Gateway definitions. They must be unique per gateway.

2. Do not try to use the receiver XMPP account as the sender as well... it won't like sending to itself.

It's written in PHP!

See Developer-WhyPHP.