Userguide
Linux Install
Download SMSMatrix and then follow these steps:# tar -xzvf smsmatrix-X.X.X.tar.gz
# cd smsmatrix
If you have installed Fedora or Redhat run the following script:
# ./Fedora_Redhat_install.sh
If you have Debian or derivative install, run the following script:
# ./Debian_install.sh
Before you can begin running services, you need to download the rxtx.org package from the following website:
http://www.rxtx.org.
Carefully follow the instructions on how to install it from the following link:
http://rxtx.qbang.org/wiki/index.php/Main_Page
This the RXTXComm.jar file is used to read to/from the serial port on virtually all Operating System platforms. It really is a very great package and is a great alternative to Sun's javax.comm package.
You also need to have a JAVA virtual machine installed on your system. Please download a JVM for your platform from the following link:
http://java.sun.com/downloads
To start/stop/restart or check the status of the SMSMatrix service:
# service smsmatrix start
# service smsmatrix stop
# service smsmatrix restart
# service smsmatrix status
Configuration
Begin by setting up the databases. Please run the following scripts:# cd dbconfig
# mysql -u root -p < mysql.sql
# mysql -u root -p < smsmweb.sql
To configure the system on Linux (and FreeBSD in the near future), open the smsmatrixConfig.xml file in the following directory:
# vim /etc/smsmatrixConfig.xml
Under the modem-device tag, list all serial ports, the baud rate of the modem on that port as well as the PIN number of the SIM card within that modem. Under the scriptlet tag tag, list all the custom scripts that you might wish to use at this point. These custom scripts process the incoming and outgoing SMSs. This is because the only purpose of the JAVA application is to purely and simply only send and receive SMSs to and from the modem. You could for example have a custom script to read the bank account balance of a user and send it out as an outgoing SMS, based on an incoming SMS request by a user.
At this point, if you have a modem with SIM card attached to any your serial port, you will now be able to easily receive SMSs (please look at the inbox table in the smsweb database) and send SMSs (please look at the outbox table in the smsweb database).
