-
Notifications
You must be signed in to change notification settings - Fork 7
Installation
Installation of SMStoXMPP is quite simple and there are packages available for some distributions. Generally installing using one of the provided packages offers the easiest experience.
SMStoXMPP requires PHP 5.1.x+, ideally PHP 5.3.x or later, with the php-cli, php-xml and php-process packages installed.
SMStoXMPP is packaged for RHEL/CentOS 5 & 6, you can download packages from my Yum repositories or directly as RPM files.
Information for accessing this repo can be found here.
You will need to enable the following repository:
- jethrocarr-custom (or amberdms-custom)
Note that this repository contain a number of RPMS for many other programs - take care when enabling to make sure they do not clash with any other packages you have developed/installed - although this is very unlikely.
Alternatively, you can download the RPMs directly at:
Once the RPM is installed, please continue on to "Configuration and Usage".
Release Tarballs should be stable, open issues around any bugs found in them.
- Download an appropriate release from http://repos.jethrocarr.com/pub/jethrocarr/source/smstoxmpp/
- Unpack source to the desired location. (Suggest /usr/local/lib/smstoxmpp).
- Create a symlink to the daemon (app/dispatcher.php) to smstoxmppd in desired bin directory (eg /usr/local/bin)
- Install the bootscript (resources/smstoxmppd.rcsysinit) and adjust as required with application paths.
- Install the configuration file (config/sample_config.ini) to desired location and create symlink at config/config.ini.
- Install the apache configuration file (resources/smstoxmpp-httpdconfig.conf) and apply appropriate changes for your environment.
Git isn't normally broken, but there's no promises if checking out from trunk - Git installation is intended for developers only.
Once checked out, refer to the "Install from Source Tarball" instructions above. Note that the application can be run directly from the checked out source whilst developing, just don't accidentally submit your configuration file when you send in patches. ;-)
The sample configuration file includes general information on the basic parameters.
- For more specific SMS Gateway configuration information, refer to Gateway-Guide
- For more information on using CardDAV address books (including Google Apps) see CardDAV.
Quick Steps:
- Edit configuration file (Default: /etc/smstoxmpp/config.ini)
- Start the daemon (Usually: /etc/init.d/smstoxmppd start)
- Once the application starts, a welcome XMPP IM message will be sent to the xmpp_reciver user. Once you get this, reply with "_help" to get a list of commands and their options.
If you have any technical issues, please refer to the Troubleshooting page.