
[images/mobile.gif] [images/smslink.gif]

-------------------------------------------------------------------------------


General                 SMSLink Clients Installation Procedure
Introduction
Platforms               Table of contents
Supported_Hardware
Package_Content         * Client_Installation_Procedure_on_Unix_Platform.
                        * Client_Installation_Procedure_on_Win32_+_Cygwin1
                          Platform.
Installation
Download
Server_Install          Command-Line Client Installation Procedure on Unix
Client_Install          Platform
Gateway_Install

                        1./ Customize the Makefile to suit your needs.
Tech Info
Changelog               Typically, you'll want to select the target platform.
FAQ                     Just edit the Makefile and make sure to uncomment the
Drivers                 required line(s) at the beginning of the file (and only
Related_Links           those). Please check here for a list of supported
                        platforms.
                        Note for HP-UX users: By default, HP-UX ships with a
[Jump_to_Vim_Home_Page] 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").

                        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.

                        From the Cygwin_Home_Page, click on the "Install_now"
                        link. This will download to your Windows box a small
                        install utility called setup.exe. Just run it, it will
                        offer you three choices ("Download from Internet",
                        "Install from Internet" and "Install from Hard Drive").
                        I would recommend first downloading the entire distro
                        to the hard drive and then installing from there. The
                        setup utility also allows you to individually select
                        and deselect components to be installed.

                        2./ Patch it with the latest nightly snapshot.

                        Then go to the Development_Snapshots section and
                        download the latest nightly snapshot (called something
                        like cygwin-inst-20001128.tar.bz2). Make sure to choose
                        this one as it contains both the DLL, the libs and the
                        headers.
                        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.

                        Get the SMSLink distribution archive within the Cygwin
                        environment and unpack it somewhere (under your home
                        directory, for instance). There's no need to convert
                        any file from the Unix format to the DOS format. You
                        can just ignore this issue.

                        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).

-------------------------------------------------------------------------------

Last Modified: December 30th, 2000. [SourceForge_Logo]
     philipa@tiscalinet.be

