Skip to content

intistelecom/Intis-Telecom-SMSAdmin

Repository files navigation

SYNOPSIS
============
Date: 2017/01/20
Time: 13:00
Version: 3.0.0
License: MIT

SmsAdmin is a command line utility for Win32 and *Unix like systems. The main utility purpose
is to send extra notifications via sms service.
This utility use only intistele.com service (http://intistele.com/)

BASIC USAGE
============
Usage template:
smsadmin <action> [options] [params]

Examples:
Produce help information about actions, options and params
./smsadmin --help

Send sms from command line
./smsadmin send -o Info -x "Send some message" --login=MyLogin -t 587d68b3aa1d80065a5b923f348b33fe688d8437 -l ./sms.log 79046650055 79056687711

Send sms from command line with json api
NOTE: System clock should be synchronized with some NTP server for correct signature generation
./smsadmin send -o Info -x "Send some message" -t 587d68b3aa1d80065a5b923f348b33fe688d8437 \
-l ./sms.log --login=MyLogin 79046650055 79056687711

Send sms using config file. In config file options are set by long names without first dashes
./smsadmin send -c ./sms.cfn 79046650055

Send sms using section in config file. Config file sintax is simple. See example of config in doc dir
./smsadmin send -c ./sms.cfn --tpl=some_cfn_section

Get sms delivery state. Last two params are an operator sms ids, recived from send sms stage
./smsadmin state -t 587d68b3aa1d80065a5b923f348b33fe688d8437 4075204902457125200002 4075204902457130390009

KNOWN BUGS
============

1. On Windows systems use only latin-1 (ASCII) symbols

REQUIREMENTS
============

Build tools:
- cmake 2.8+     (tested 2.8.11, 2.8.12)
- gcc-c++ 4.4.7+ (tested 4.4.7, 4.7.1, 4.8.5)
- make 3.81+     (tested GNU 3.81, 3.82)

Shared libraries with headers:
- boost-program-options 1.53+ (tested 1.53, 1.55)
- boost-regex 1.53+           (tested 1.55)
- boost-property_tree 1.55+   (tested 1.55)
- boost-foreach 1.55+         (tested 1.55)
- curl 7.19+                  (tested 7.25.0, 7.19.7, 7.37.0)

INSTALL
============

Instalation guide for CentOS 6.5
Firt install requirements (libraries installs automatic):
    yum install -y gcc-c++ cmake curl-devel tinyxml-devel

NOTE: Then you should install manually boost-1.53 or higher from http://www.boost.org/
And specify the optional boost path via cmake parameter 'cmake -DBOOST_ROOT='

NOTE: If your repository cmake version is lower then 2.8, you should compile 2.8 from source
(http://www.cmake.org/cmake/resources/software.html)

Untar package
    tar -zxf ./smsadmin-1.0.1.tar.gz
Check build directory
    cd ./smsadmin-1.0.1/build/
Configure and make
    cmake ../ -DCMAKE_INSTALL_PREFIX=/usr/local/ -DBOOST_ROOT=/usr/local
    make
    make install
For detailed instalation see ./build/install_manifest.txt

CMAKE BUILD PARAMETERS
======================

| Build option name                | Description | Default value | Example |
| SMSADMIN_DEFAULT_CONF_FILE       | Configuration file name by default on empty usage option -c | /etc/smsadmin.cfn | ./smsa.cfn |
| SMSADMIN_DEFAULT_LOG_FILE        | Log file name by default | /var/log/smsadmin.log | ./smsadmin.log |
| SMSADMIN_MAKE_SHARED             | Static library linking: boost | ON | cmake -DSMSADMIN_MAKE_SHARED=OFF |
| SMSADMIN_SECURITY_PURIFY_DISABLE | Purify security information: token | OFF | cmake -DSMSADMIN_SECURITY_PURIFY_DISABLE=ON |

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published