Distributed Polling System Installation Manual
Contents
1. But as we are using two mobiles one for sending SMS and other for receiving program does not have enough intelligence to decide which mobile to use for which purpose The SMSC address is required only from the handset which is used for sending SMS Receiving is just like reading the storage device reading unread messages from Inbox of mobile and then delete the message and has nothing to do with SMSC Type the AT CSCA command which we will use for sending SMS The response from the mobile device will be the SMSC address as shown below Hardcode this received address value in the program Distributed Polling System Installation Manual 9 SMSConnection Hyper Terminal File Edit View Call Transfer Help Cw 2 A DS AT CSCA CSCA 46707990001 145 OK AT CSCA CSCA 46707990001 145 OK AT CSCA CSCA 46707990801 145 OK AT CSCA CSCA 46707998081 145 OK Auto detect 2400 8 N 1 Figure 3 7 Collecting the SMSC Address 3 2 Installing the email communication sub layer 3 2 1 Email Server Installation and Configuration Download the trial version of winmail v4 6 as winmail exe from http www vista files org programs amax information technologies inc winmail mail server html Install the exe and during installation it will ask for password for administrator user admin and password for user postmaster which will be used later to log in to administrator console for domain config2. LISTENER DURING DELETING THE EVENT FROM EVENT TABLE gt message column lt COLUMN THAT WILL CONTAIN BUSINESS MESSAGE gt lt sql provider name SQLprovider url jdbc mysql 127 0 0 1 3306 jbpmdb driver com mysql jdbc Driver username middleware password middleware gt lt sql bus busid helloSQLChannel gt lt sql message filter tablename eai_event_table status column status message id column row_id message column EMAIL_msg I gt lt sql bus gt lt sql provider gt For EMAIL adapter Listener we need to configure the jboss esb xml with the following section lt property name userName value response gt Specify the exact username of the email account that you want to poll Here it is response lt property name password value response gt Specify the password of the email account that you want to poll Here it is response lt property name pollingInterval value 100 gt Specify the interval period before the listener thread goes for next poll Here it is 100 lt property name mailFolder value inbox gt Distributed Polling System Installation Manual 11 ar ay a F 3 Specify the emailfolder that needs to be polled Here it is inbox lt property name mailServer value 127 0 0 1 gt Email server IP address Here it is 127 0 0 1 lt activation config gt lt property name mailServer value 127 0 0 1 gt lt property name storeProtoco
3. FE Distributed Polling System Installation Manual Version 1 0 Distributed Polling System Installation Manual 1 FE Table of Contents 1 Introduction 1 1 Purpose of this document 1 2 Intended Audience 1 3 Scope 1 4 Definitions and acronyms 1 4 1 Acronyms and abbreviations WU YU LU LU WwW UW Dv System Requirements 2 1 Hardware Requirements 2 2 Software Requirements 2 3 Operating Systems WWW UU 3 DPS Installation 3 1 Installing the mobile communication sub layer 3 1 1 Installing Java Communication API 3 1 2 Installing Device Drivers 3 1 3 Terminal Program 3 1 3 1 Configuring Connection with HyperTerminal HT 3 1 3 2 Test Connection Using HyperTerminal 3 1 3 3 Checking AT Commands Support Using HyperTerminal 3 1 3 4 Finding the SMSC Address 3 2 Installing the email communication sub layer 10 3 2 1 Email Server Installation and Configuration 10 3 2 2 Email Client Software Installation 10 3 3 Installing the middleware 11 3 3 1 Installing Jboss ESB server for windows 11 3 3 2 Compiling and Deployment to ESB server 12 3 4 Installing the web layer 12 3 4 1 Installing Apache Tomcat 12 3 4 2 Installing MySQL 12 3 4 3 Run web portion of DPS 13 nb A Oo ONU Distributed Polling System Installation Manual 2 ar ay wee FE 1 Introduction 1 1 Purpose of this document The purpose of this document is to provide details for e Installing the third party software application requ
4. alled on the system MySQL can be downloaded from mysql site in http dev mysgl com downloads Then it should be installed In MyQL s installation its default setting can be used Also MySQL Connector J for connecting to MySQL from Java is a jar file which is used in DPS After installing MySQL database of the DPS should be created In order to create database and filling it with initial values a script file DPS_db_scripts sql is available in DPS package which is used for this part The steps which should be doing in this part are as follows 1 Testing connecting to MySQL e In Command prompt change directory to the MySQL path gt cd MySQL_PATHMySQL MySQL Server 5 0 bin e Test connecting to database by running the following command gt mysql uroot p Enter password Welcome to the MySQL monitor Commands end with or g Your MySQL connection id is 25 to server version 5 0 24a community nt Type help or h for help Type c to clear the buffer mysql gt Distributed Polling System Installation Manual 12 2 amp ar i FES After running mysql uroot p command password of the root user of mysql should be entered If mysql is installed correctly and the password of its root user is entered correct It will be connected and the following messages will be shown To exit from mysql just exit commang should be runned If it connects to mysql correctly next steps can be continued Other
5. ed through keyboard are not visible For making the characters visible Go to File gt Properties gt Setting Tab gt ASCII Setup button gt ACSII Sending Section gt Check the Check box Echo typed characters locally and click OK Distributed Polling System Installation Manual 6 SMSConnection HyperTerminal File Edit View Call Transfer Help SMSConnection Properties Connect To Settings Function arrow and ctrl keys act as ASCII Setup Terminal keys O Windows keys ASCII Sending Backspace key sends C Send line ends with line feeds Cti H Del Cti H Space Ctrl H Echo typed characters locally Emulation Line delay fo milliseconds Auto detect v Terminal Setup Character delay fo milliseconds Telnet terminal ID ANSI ASCII Receiving Backscroll buffer lines 500 C Append line feeds to incoming line ends C Force incoming data to 7 bit ASCII Wrap lines that exceed terminal width C Play sound when connecting or disconnecting ASCII Setup on ce CAPS NUM Capture Print echo Figure 3 4 Making Screen Characters Visible 3 1 3 2 Test Connection Using HyperTerminal For testing the connection created in the above steps simply type AT command This is similar to ping command in networking and which checks if the link between computer and mobile is establish and the device is responding by sending an OK signal Distributed Polling System Insta
6. ired to run DPS e Deploying DPS components and layers e Testing certain functionality to verify the deployment of DPS Diagnostics 1 2Intended Audience Product Users and Evaluators Anybody who wants to use the DPS product or evaluate needs to install DPS including SCORE supervisors and evaluators team members steering group and Customers 1 3Scope The scope of the document is limited to providing guidance for installation deployment and diagnostics of DPS 1 4 Definitions and acronyms 1 4 1 Acronyms and abbreviations Acronym or Abbreviation Definitions DPS Distributed Polling System 2 System Requirements 2 1 Hardware Requirements Two mobiles devices need to be connected to the computer which host mobile communication sub layer 1 Nokia N95 sending SMS 2 SonyEricsson z550i receiving SMS 2 2Software Requirements The below mentioned software or their higher versions 1 JDK 1 5 2 Jbossesb server 4 4 GA 3 apache ant 1 7 1 4 WINMAIL v4 6 5 Eudora mail client v7 1 6 Tomcat v5 5 7 MySQL v5 0 8 Java Communication API javax comm 9 Device Driver for Mobile Nokia N96 and Sony Ericsson z550i 10 Terminal Program Optional 2 3 Operating Systems The only limitation that underlying operating system has is that all the above mentioned 9 mandatory software s should be available for the selected operating system We tested our application on Windows XP and Vista For UNIX Linux Su
7. l value imap gt lt property name mailFolder value inbox gt lt property name userName value response gt lt property name password value response gt lt property name pollingInterval value 100 gt lt activation config gt 3 3 2 Compiling and Deployment to ESB server Go to command prompt and to the directory of shipped package of DPS At command prompt at the shipped package directory use the following command C xyz gt ant deploy This will build all the source files Next use C xyz gt ant runtest This will deploy at ESB server 3 4 Installing the web layer 3 4 1 Installing Apache Tomcat In order to use web part of the application apache tomcat should be installed on the system The apache version which we used is v5 5 Before you using tomcat at least JRE should be installed but JDK is recommended to be used For installing this software JDK should be installed on the system This software can be downloaded free from address http tomcat apache org In installing it all default setting can be used setting a password for it is recommended and its default port is 8080 which can be changed while installing or later if this port is used for another applications More detail information about this software is available in this address http tomcat apache org tomcat 5 5 doc introduction html 3 4 2 Installing MySQL MySQL v5 0 is used for DPS database and should be inst
8. llation Manual 7 SMSConnection Hyper Terminal File Edit view Call Transfer Help Dae s DS Connected 0 00 35 Auto detect 24008 N 1 SCROLL APS NUM Capture Figure 3 5 Testing Connection with Mobile device using AT Command 3 1 3 3 Checking AT Commands Support Using HyperTerminal The mobile communication layer of DPS requires certain AT commands to send and receive SMS Not all mobile handset support all AT commands The AT commands set the device supports vary with the Model of the mobile device and the Manufacturer In order to test whether a command is supported or not use the following general syntax of Command If the result from the mobile is OK then the command Command is supported If the result is an Error or some error code then command is not supported Following figure illustrate checking support of few AT commands when a Sony Ericsson mobile is connected These commands are used in program to send the SMS Distributed Polling System Installation Manual 8 S M LARDALEN UNIVERSITY Fee SMSConnection HyperTerminal File Edit View Call Transfer Help Dae 53 28 OK AT CSCA OK AT CMGS OK Connected 0 12 54 Auto detect 2400 8 N 1 Figure 3 6 Checking commands support for connected mobile 3 1 3 4 Finding the SMSC Address The program responsible to send SMS needs to know the SMSC address It is possible to get the SMSC address dynamically and set it in the program variable
9. n Solaris and Mac OS flavors all above the software s might not be available Distributed Polling System Installation Manual 3 o D nad FER 3 DPS Installation Due to vast scope of the DPS application we divided the installation manual into four parts All four parts can be installed in separate computers which provide a true nature of Distributed software developed in a distributed environment The four parts are e Installing the mobile communication sub layer e Installing the email communication sub layer e Installing the middleware e Installing the web layer 3 1 Installing the mobile communication sub layer 3 1 1 Installing Java Communication API In order to use SMS in a computer application an interface between the computer and the GSM network is needed This interface is typically a mobile device connected to a serial port on the computer In this project the serial connection to a mobile is the interface The Comm API is specified in the package javax comm is a part of the java extended specification javax Sun has only implemented javax comm for Microsoft Windows and Sun s Solaris SPARC platform But it no longer supports Implementations for Windows and few other platforms Implementations for other platforms are supported by the RxTx project which provides the javax comm package for Linux MacOS X etc 1 Download the comm API for the appropriate OS from http www rxtx org or Ahttp blog jservlet com
10. oned Connection is to be created Select the appropriate port to which the mobile is connected Their can be multiple ports in a Computer that are active and will be presented the Combo box figure below In order to find which port the mobile device is connected e In Windows 98 Go to Control Panel gt Modems gt Diagnostic Tab e In Windows 2000 and XP Go to Control Panel gt Phone and Modem Option gt Model Tab These will display the list of connected devices and corresponding ports Specify the same port of your mobile device to HT and click OK Distributed Polling System Installation Manual 5 D M LARDALEN UNIVERSITY F 2 Connect To DB SMSConnection Enter details for the phone number that you want to dial Country region Sweden 46 Nj Area code 46 Phone number Connect using Conexant HDA D330 MDC V 92M Conexant HDA D330 MDC Y 92 Moder COM13 TCPAIP Winsock Figure 3 2 Specifying Serial Port for Mobile Connetion HT then asks for other configuration parameters such as Bit rate data bit parity etc Click OK HT is configured and is ready to accept the AT commands COM13 Properties Port Settings Bits per second j2a00 v Data bits 8 Parity None Stop bits 1 Flow control Hardware Restore Defaults Figure 3 3 Specifying Configuration Parameters for the Connection Usually the characters typ
11. ord for initial configuration and set up e Jt will then connect to email server and your thick client configuration is perfect 3 3 Installing the middleware 3 3 1 Installing Jboss ESB server for windows We used JBOSS ESB server for quick learning development deployment and testing instead of using JBOSS application server This open source JBOSS ESB package downloads are available at http www jboss org download We have used jbossesb server 4 4 GA and download is available as zip file The zip file needs to be unzipped in any directory example C JBoss jbossesb server 4 4 GA e We have used JDK5 e VerifyJAVA HOME points to required JDK folder appropriately To build files and deploy we need apache ant software and the same can be downloaded from Ahttp www apache com website We have used apache ant 1 7 1 and the same is available as zip file in the apache website e Unzip the apache ant package and specify the environment variable ANT_HOME with the ant directory path For each JDBC adapter Listener we need to configure the jboss esb xml with the following section url jdbc mysql IP port database username lt USERNAME TO CONNECT TO DATABSE gt password lt PASSWORD CONNECT TO DATABSE gt tablename lt TABLE NAME THAT LISTENER WILL POLL gt status column lt COLUMN THAT WILL CONTAIN HARDCODED VALUE P MEANS READY TO BE POLLED BY LISTENER gt message id column lt UNIQUE KEY VALUE COLUMN WILL BE USED BY
12. public serialcomm javaSerial zip The downloaded API contains the following three files for the Windows Kit a comm jar b win32comm dll c jaxax comm properties For java to recognize and work with serial ports it is required to place these files in appropriate folders JAVA_HOME is the location of JDK directory WIN_HOME is Windows OS installation directory a Copy comm jar in e JAVA_HOME gt Lib and e JAVA_HOME gt jre gt lib gt ext directory b Copy win32comm dll in e JAVA_HOME gt bin and e JAVA_HOME gt jre gt bin and e WIN_HOME gt System32 directory c Copy jaxax comm properties in e JAVA_HOME gt Lib and e JAVA_HOME gt jre gt lib directory 3 1 2 Installing Device Drivers For DPS application to send and receive SMS it is requires that the Operating System recognize the connected mobile device and hence the Java Comm API Caution gt By default many operating systems provide default drivers including for serial connection devices Thus mobiles with default drivers will work like storage devices for data transfer In order to work properly with DPS exact driver preferably from the manufacturer need to be installed If we install the PC suite available for the mobile it includes the device driver Download and Install the PC suite from a Nokia N95 sending SMS http nds1 nokia com files support global phones software Nokia PC_Suite 7_1 18 0 eng _web exe http www daimi au dk jones sms repor
13. t report html Distributed Polling System Installation Manual 4 y MALARDALEN UNIVERSITY sate FER b Sony Ericsson z550i receiving SMS http www sonyericsson com cws download 1 357 877 1234788930 Sony Ericsson PC_Suite 4 010 00_Web_EN exe 3 1 3 Terminal Program Microsoft HyperTerminal is a software utility that comes free with Windows XP and previous versions of Windows operating system Microsoft Vista does not provide HyperTerminal by default either has to be purchased or some other terminal program can be used in place of HyperTerminal 3 1 3 1 Configuring Connection with HyperTerminal HT Connect the mobiles with a valid SIM card either using USB Bluetooth to the computer To start HyperTerminal HT utility e In WinXP go to Start gt Program gt Accessories gt Communication gt HyperTerminal e InWin9ifthis utility is not found we may not have installed it To install go to Control Panel gt Add Remove Programs gt Windows Setup Tab gt Communication List Box Item gt Details button to install HyperTerminal After the utility starts it asks for a Connection Name as in following figure Key in a relevant name for ex SMSConnection and press OK button Connection Description ay New Connection Enter 4 name and choose an icon for the connection Name Icon Figure 3 1 Specifying the Connection name HT asks for selecting the Serial port to which the above menti
14. uration port activation and for all other administrative activities When the installation finishes it asks to Launch services and once you select that option it asks for mailbox address Put response dps mdh se where response is the username and dps mdh se is the domain Then specify password and confirm password parameters with your password information and click setup It will verify and activate all required ports like SMTP 25 POP3 110 IMAP 143 and so on Once the above steps are executed successfully there will be an active icon at right side at task bar Now double click on that and administrative console will open Use the same password that you used during installation and the console will open In left pane select User and group gt user click on add button and go on creating the board member s email account as required Once created all the email accounts will be activated and can be used for sending receiving emails 3 2 2 Email Client Software Installation We used Eudora v7 1 as email thick client for downloading emails from server e Download Eudora _7 1 0 9 exe from http www eudora com download e Run the exe and install as normal installation e Once the installation is over it will ask for a short cut at desktop Perform the same Distributed Polling System Installation Manual 10 ar ay a F 3 e While starting for first time it will ask for the email server IP username domain and passw
15. wise the error should be checked and solved before going to the next parts 2 Creating database related triggers procedures and setting initial values e Running commands to create database sql commands in DPS_db_scripts sql file by running the following command gt mysql uroot p lt PATH_OF_SCRIPT_FILE DPS_db_scripts sql Enter password gt After finishing correctly of running this command the database and its all necessary parts will be created 3 4 3 Run web portion of DPS In order to run web part of DPS the war file of web part dps war is available in DPS package In running web part of DPS it is just needed that dps war file is copied in the webapps folder of apache tomcat installed path e g C Program Files Apache Software Foundation Tomcat 5 5 webapps Then the apache server should be started restarted In order to do it if tomcat s service is added to the current system it is just needed to be executed form Control Panel gt Administrator Panel gt Services Otherwise it should be started from bin folder of tomcat Now DPS web part is ready to be used by browsing this URL in a desired browser http IPADDRESS_OF_SYSTEM TOMCATPORT dps e g http localhost 8080 dps Distributed Polling System Installation Manual 13
Download Pdf Manuals
Related Search