

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


General                 SMSLink Clients Installation Procedure
Introduction
Documentation           Table of contents
Platforms
Supported_Hardware      * Client_Installation_Procedure_on_Unix_Platform.
Package_Content         * Client_Installation_Procedure_on_Win32_+_Cygwin1
                          Platform.

Installation
Download                Command-Line Client Installation Procedure on Unix
Server_Install          Platform
Client_Install
Gateway_Install
Upgrade                 1./ Customize the Makefile to suit your needs.

                        Typically, you'll want to select the target platform.
Tech Info               Just edit the Makefile and make sure to uncomment the
Changelog               required line(s) at the beginning of the file (and only
FAQ                     those). Please check here for a list of supported
Drivers                 platforms.
PDU_format              Note for HP-UX users: By default, HP-UX ships with a
Bugs_/_Todo             minimal C compiler, not suitable for ANSI C. The ANSI C
Related_Links           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,
_Jump_to_Vim_Home_Page_ 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.

                        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: September 29th, 2006.
     _philipa_STRUDEL_scarlet           _SourceForge_Logo_
     PUNKT_be_

