SMS Server Tools

Step by Step instruction for Windows

This document describes how to install the SMS Server Tools on a Windows Computer.

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

Before you start you should learn a little bit about cygwin. Cygwin is a set of libraries and programs that allow software developers to compile and run linux program on Windows. Cygwin adds a lot of commands to windows that are available on any linux system but not on Windows. It also adds some libraries that allow programmers to access ports and files like in Linux. Windows and Linux drivers have a completely different way to be used but cygwin adds all important Linux functions to Windows wich makes software development much easier.

Cygwin in not an emulator. All cygwin program are real executable windows programs (.exe).

It is very useful to know the basic Linux commands but you can also continue if you have no Linux knowledge. Please the following things always in mind if you work with cygwin or my SMS Server Tools:

This instruction does not show you how to install the mm Shared Memory Library. You need this library only if you want statistic files. Most users don't need this feature and therefore I decided to keep this instruction as easy as possible. Now you are ready to follow the Step by Step instruction for Windows.
Go to www.cygwin.com and klick on Install Now.

Klick on Next until you can select a download server. Select one that is near to you and klick 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 klicking one time on them. Then klick on Next until you can see the progress bar. The default settings are Ok.

The download takes about 60 minutes on an ISDN 64k connection, so watch TV or do something useful now.

Download the sms server tools into the directory c:\cygwin\usr\src.

Start a Cygwin bash shell from the Windows start menu. This shell is similar to the MS-DOS command prompt but it accepts linux commands.

Enter the following commands:
mkdir /var/spool
cd /usr/src
tar xzf smstools.tar.gz

Now you have extracted the package of source codes and need to modifiy it a little bit. Open the file c:\cygwin\usr\src\smstools\src\Makefile with Wordpad (not Notepad!).

Remove the # from the lines
CFLAGS = -D WINDOWS
CFLAGS += -D NOSTATS.

Close Wordpad and enter the following commands in the Cygwin bash shell:
cd /usr/src/smstools
make -s clean
make -s
make -s 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 and not com1: ! Use always / in directory names in the config file.

Do not forget to create all the spool directories if you added some to the config file.

Run smsd by entering the command smsd in a Cygwin bash shell window.

Send short messages by creating SMS Files in the directory c:\cygwin\var\spool\sms\outgoing.

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.