## SMS Server Tools 3

Home

### Step by Step instruction for Windows

You need about 150 MB free space on drive C or whereever you install it.

Cygwin is not a Unix emulator. It is a set of standard programs from the Unix world, that were translated to windows. Cygwin adds a lot "missing" functions to windows, so most Source codes for Unix can be translated to Windows with minor changes.

It is very useful to know the basic Unix commands but you can also continue with this instruction if you have no Unix knowledge.

Go to www.cygwin.com and click on Install Now.

Click on Next until you can select a download server. Select one that is near to you and click on Next

After the list of cygwin packages is received you can select the parts that you want to install. Do not deselect anything.

Open the Devel list and select gcc and make by clicking one time on them. If you want to use statusmonitor feature, a gcc-g++ package is also needed. After the version 3.2, libiconv is also needed if iconv is used. It's used by default. Then click on Next until you can see the progress bar. The default settings are Ok.

Download the SMS Server Tools 3 into the directory c:\cygwin\usr\src. Some windows versions store the file with a wrong filename (*.tar.tar) instead of *.tar.gz but this does not cause any problem.

Start a Cygwin Bash Shell from the Windows start menu. This shell is similar to the MS-DOS window but it accepts Unix commands.

Enter the following commands:

cd /usr/src
tar -xzf smstools3*
cd smstools3
make
make install

You should not see any error message. Warnings are acceptable.

Open the file c:\cygwin\etc\smsd.conf and modify it as described in configuring.
The name of the first serial port is /dev/com1. Use always / instead of \ when you write directory names. The whole config file is case-sensitive.

NOTE: Do not use a device name, like COM1, as a modem name (like "[COM1]"). While a message is received, a file starting with this name is created and Windows handles it as a device. This will cause a modem process to be freezed.

Run smsd by entering the command smsd -s (with status monitor) in a Cygwin Window, or use sms3 script.

Send short messages by creating SMS Files in the directory c:\cygwin\var\spool\sms\outgoing or by using the command sendsms in another Cygwin Window.

### Running smsd as a Windows service

If you like to install smsd (version >= 3.0.3) as a service, then enter this command in a Cygwin Window:

cygrunsrv --install smsd --path /usr/local/bin/smsd.exe --type auto --shutdown --env "CYGWIN=server" --env "PATH=/usr/local/bin:/usr/bin:/bin" --desc "SMS Server Tools 3" --args "-t"

You can then start and stop this service using the control panel of windows or the windows commands net start smsd and net stop smsd.

NOTE: Version >= 3.0.3 should be run in terminal mode. Last argument --args "-t" enables this mode. If you have previously installed smsd as a service, remove it (cygrunsrv -R smsd) and reinstall with a new command.

NOTE: If you have had a previous version in use, there might be --neverexits option defined in the command. This option should not be used, because it causes an error message while the service is stopped.

> The book describes the installation procedure of the SMS Server Tools much more in detail. It also explains how to install and use other useful programs like Apache webserver, MySQL, PHP script language, cronjobs, shell scripts, sendmail, fetchmail, formail, sed, cut, grep, awk.

> The book is about the version 2.x and written, maintained and owned by Stefan Frings.