SMSLink Clients Installation Procedure

• Client Installation Procedure on Unix Platform.
• Client Installation Procedure on Win32 + Cygwin1 Platform.

Command-Line Client Installation Procedure on Unix Platform

1./ Customize the Makefile to suit your needs.

Typically, you'll want to select the target platform. Just edit the Makefile and make sure to uncomment the required line(s) at the beginning of the file (and only those). Please check here for a list of supported platforms.

Note for HP-UX users: By default, HP-UX ships with a minimal C compiler, not suitable for ANSI C. The ANSI C compiler has to be purchased as a separate product. Newer versions of this compiler also support C++, but gave us compatibility problems when compiling other, larger packages (such as Generic-NQS). I didn't test this project with the latter (I'm interested in any report regarding it, be it a success or a failure). The former is ok - that's the one I'm using. Of course, if you would need to purchase the compiler for this project only, I remind you that GCC is available for HP-UX as well (in the HP native package format even, called "software depot"), and is working just as well in the context of this project.

2./ Compile the program.

Type make.

3./ Install the program.

As root, type make install.

The default installation locus is /usr/local/bin. It can be changed, of course. You'll have to enable the right install instructions for your platform at the present time (I'll amend that in a future release).

4./ Test the new software.

Provided that the server module is already installed, configured and running properly, try sending a message with the following command:

sendsms -d 075123456 -m "Test" server

Where server is the hostname or IP address of your SMS server. This client doesn't need any special priority to be run, nor does it need to be setuid or setgid.

A pre-condition to its proper working, though, is to have your networking setup correctly, namely IP connectivity and name resolution (if you're using it). Networking through the loopback device is enough if client and server are located on the same host.

Command-Line Client Installation Procedure on Win32 + Cygwin1 Platform

1./ Get and install the Cygwin environement.

2./ Patch it with the latest nightly snapshot.

Just bunzip it (from within the Cygwin environment -- it provides a port of bunzip2(1) all right) and untar it from the enviroment root dir. You will have problems overwriting the cygwin1.dll as it will be in use. Just untar this one separately, exit the environement and use the Windows shell to copy it in place.

3./ Get SMSLink.

4./ Customize the Makefile to suit your needs.

Typically, you'll want to select the target platform, in this case identified as WIN32. Just edit the Makefile and make sure to uncomment the required line(s) at the beginning of the file (and only those). Please check here for a list of supported platforms.

5./ Compile the program.

Type make.

6./ Install the program.

Don't use the usual make install routine, as the one I provide was not written to take the WinNT filesystem organization into account.

Just take the resulting EXE file and copy it wherever you want the client program to live. In order for other users to be able to use it, you'll have to copy the cygwin1.dll to the same directory. Cygwin-ported programs can't run without it.

The provided man page will be of little help to "pure Windows" users, but you can copy it to the /usr/man/man1 directory within your Cygwin environment and view it from there.

7./ Test the new software.

Provided that the server module is already installed, configured and running properly, try sending a message with the following command:

sendsms -d 075123456 -m "Test" server

Where server is the hostname or IP address of your SMS server.

A pre-condition to its proper working, though, is to have your networking setup correctly, namely IP connectivity and name resolution (if you're using it).