SOVoIP Prototype System User Manual
Contents
1. Home Node _w 7 Admin WS Interface H WS Implemetation JDBC Deployment diagram showing all the components in this system As illustrated in the deployment diagram the system has two kinds of servers Global Public Nodes and normal Public Nodes Global Public Nodes are referred as Global Nodes in the future Since the normal Public Nodes are all used as Home Node which maintains information of users assigned to it we refer to this kind of servers as Home Node It is necessary that the nearest nodes in the prototype are all avatars of home nodes even if they can be just a passing through server The deployment are different for these two kinds of servers for each of them a dedicated war file containing an administration panel will need to be deployed separately on the machine on which that type of Node is deployed The procedure of deploying the system involves preparation distribution and configuration 2 1 Deployment Preparation Now we have one machine working as both Global Node and Home node with IP 192 168 1 101 The softwares we install on both machines are Page 9 MySQL Server 5 0 as DB server PHPMyAdmin 2 11 7 as DB setting tool Sun GlassFish Server v2 1 as application server Mozilla Firefox 3 0 14 as Explorer for running admin pan2. empty string User Manual 6 The Process of Deleting a Friend call wsDelFriend String Initiator String userlD return String Resp e NearestNode if success success if fail fail amp message for you to print out 7 The Process of Updateing Personal Information call wsUpdatelnfo UserInfo return String Resp Client NearestNode if success success if fail fail amp message for vou Lo print out 8 The Process of Changing Status status ___call wsChangeStat SEN String userlD String stat bus f return String Resp Client NearestNode if fail fail amp message_for_you_to_print out User Manual 1 2 Online support and resources There are several ways for obtaining the source codes and detailed documents The papers about the SOVoIP can be found at http p2p cs mu oz au software SOVoIP The project is hosted on Sun s Kenai website http kenai com projects sovoi which includes the Issue tracking wiki and mail list All the source codes and database scripts involved in this manual can be found in the SVN Subversion URI is https svn kenai com svn sovoip sovoiprototype User Manual 2 Deployment Guide Single machine Global Node cw r gt Admin W WS Interface Li WS Implemetation men Chord Boot
3. 3 Chord returns ClientB s HomeNode 4 A s NearestNode asks B s NearestNode for B s info Web Service to Web Service 5 B s NearestNode returns B s IP and port to A s NearestNode 6 A s NearestNode return B s IP and port toA 7 A Starts to contact B There are 8 types of interactions between a client and the server side 1 The Process of Sign Up call _ wsSignup SignupBean return String HomeNode Resp GlobalNode if success success amp 127 0 0 1 808C if fail fail amp message for_you_tc_print_out User Manual 2 The Process of Sign In call wsSignin UserInfo return NS C 7 String NearestNode Resp Client HomeNode if success success amp 127 0 0 1 8080 if fail fail amp message for you to print out 3 The Process of Retrieving Friend List o call D wsGetList String userlD return List lt UserInfo gt Client NearestNode 3 if success List getElement 0 getUserIL if fail List getElement 0 getUserID 4 The Process of Adding a Friend call wsAddFriend String Initiator String userlD String Relation return String Resp Client NearestNode if success success if fail fail amp message for you to print out 5 The Process of User Search 8 call e wsUserlnfo String userlD return Userlnfo Client if success UserInfc getUsername NearestNode if fail UserInfc getUsername
4. Please note that Chek to quit cho cd quit you need to consider the IP and port for Web Service in your case such as city name User Manual 3 Deployment Guide Multiple machines Global Node cw r gt Admin W WS Interface Li WS Implemetation men AVA Chord Boot 1 P Home Node Osis Chord Joint SG ne l we WI SS Admin WS Interface SCH WS Implemetation JDBC gt Deployment diagram showing all the components in this system As illustrated in the deployment diagram the system has two kinds of servers Global Public Nodes and normal Public Nodes Global Public Nodes are referred as Global Nodes in the future Since the normal Public Nodes are all used as Home Node which maintains information of users assigned to it we refer to this kind of servers as Home Node It is necessary that the nearest nodes in the prototype are all avatars of home nodes even if they can be just a passing through server The deployment are different for these two kinds of servers for each of them a dedicated war file containing an administration panel will need to be deployed separately on the machin
5. DPLSS06 Servlet Web Service Endpoint S0VolPHomeNodelImpl listening at address http l 2 25 192 193 9080 HomeNode S0VolPHomeNodelmploervice deployed with moduleid HomeNode lt CE Output Q Search Results After deployment of the servers using one machine which is not the case of multiple machines User Manual 3 3 Deployment Configuration Now the servers are deployed they need to be configured for initialization and connection The outlooks of the admin panels are tatty you may need to bear with them GlobalNode Administrator Panel Setup Glokal ode Please input IP 192 168 1 101 OK Click to quit chord quit On machine 1 after knowing the IP address exposed to the outside world in this case it is 192 168 1 101 go to http localhost 8080 GlobalNodeAdmin index jsp GlobalNode Administrator Panel Type in 192 168 1 101 then press OK Then the Global Node is started The port number should be remembered for the next step GlobalNode Administrator Panel Result Successfully created the chord IF and Portifer chord locallP 192 168 1 101 Port 9820 Action performed Go back to admin panel HomeNode Administrator Panel Setup HomelNode step 1 register this node to global node GlobalNode s IP GlobalNode s port mee em et this HomeNode s IF this HomeMode s port for web service se this HomeMode s city name Setup HomelNode step 2 connect to boot
6. SOVoIP Prototype System User Manual Author Jin Li Contact auswer hotmail com User Manual Table of Contents 1 BUA UN TNO sc casa ee ee ee 3 EN OV SUSI e 3 1 1 1 ADE SERV e ii UIA CA ON ee re ea 4 1 1 2 Client Server Communication ccccccccccccccnsseeesssssssseeeeeccccecececeesenauseesessssesesseeeeeeeeaauaaggagnsssss 5 12 OMNIS SUDO and He 8 1 2 1 EIERE Eege 8 1 2 2 wee Me 8 1 2 3 NN WE 8 Deployment Guide Single machine EE 9 2 1 Deployment Eege EE 9 2 1 1 Sie Ee Se nn nee ee 10 2 1 2 IVLANIDU Ai TIN oases os escent ne e esne eased oaneose Aeanesenscennaaecaeaeions 11 22 Deployment Ed gl den DE 12 2 2 1 Deploy Im GAS SI SN risesccen nate ee een rer ee 12 2 2 2 BIENO ee ne see EE ee otc 12 2 3 Deployment Confieuration 13 2 3 1 C ntigure The Global Node ge tegede dE gedd dE 13 2 3 2 Cone e The Home NOOC EE 13 Deployment Guide Multiple machines 14 3 1 Deployment PU ala ge EE 14 3 1 1 sateko E118 e ee ee EE E AS 15 3 1 2 MeL A EE 16 SSC EE Re e VS D gd ele Le ee ee ee 17 3 2 1 DEBIOY IN GAS SIS Ai ee ee ee een nee 17 3 22 Breet 17 3 3 Deployment Conftguration 18 3 3 1 Configure The Global Node essessssssssresesrrrssreresrrrsssreresrrrsssrrereserrrssreressreresrerrerereseeressreeeseeresee 18 3 3 2 Conners The Home e e CC 18 User Manual 1 Introduction The SOVoIP Service Oriented Voice over IP project is the demonstration for the working scheme of a prototype system de
7. ate a database called sovoipdb On machine 1 run the script db global_node_structure sql under the database sovoipdb on machine 2 run the script db public node structure sol under the database sovoipdb After that all the table structures are created phpMyAdmin i Import has been successfully finished 5 queries executed AHATE Database SQL qey sovoipdb 2 w phpMyAdmin SQL Dump version 2 11 7 sovoipdb 2 http war phpmyadmin net E assignment Host localhost E server_info Generation Time Oct 19 2009 at 11 11 AM After creating tables in machine 1 User Manual Database l i sovoipdb 2 v A Import has been successfully finished 5 queries executed sovoipdh 2 SQL query phpMyAdmin SQL Dump version 2 11 7 http ya phpmyadmin net Ei user Trend B user mio After creating tables in machine 2 The last thing to do is to check the port for MySQL server By default it is 3306 3 1 2 Manipulate war file If you follow the previous step and the default MySQL port is not changed the war files provided in the deployment folder do not need to be changed you can jump over this step to distribution If not you need to modify the properties files in the war file before you head to the next step Use WinRAR to open the GlobalNode war which is under the deployment folder Extract the file GlobalNode war WEB INF classes utility config prope
8. ating tables of the first step User Manual Database l i sovoipdb 2 v A Import has been successfully finished 5 queries executed sovoipdh 2 SQL query phpMyAdmin SQL Dump version 2 11 7 http Awww phpmyadmin net Ei user Trend B user mio After creating tables of the second step The last thing to do is to check the port for MySQL server By default it is 3306 2 1 2 Manipulate war file If you follow the previous step and the default MySQL port is not changed the war files provided in the deployment folder do not need to be changed you can jump over this step to distribution If not you need to modify the properties files in the war file before you head to the next step Use WinRAR to open the GlobalNode war which is under the deployment folder Extract the file GlobalNode war WEB INF classes utility config properties and edit it There some fields you might need to change Fields Explanations Key Default Value Conditions username sovoip If you have another username password biscuit If you have another password url jdbe mysal localhost 3306 sovoipdb if the JDBC URI is changed INITIAL_PORT 9820 if the system can t use it as chord port After modification you can replace the properties file in the war file The same to HomeNode war which is under the deployment folder Extract the file HomeNode war WEB INF classes utility config propertie and edit it There some fields yo
9. chord in global node Chick to quit chord quit On machine 2 after knowing the IP address exposed to the outside world in this case it is 192 168 1 102 go to http localhost 83080 HomeNodeAdmin index js p Home Node Administrator Panel Type in 192 168 1 101 as Global Node s IP and 8080 as Global Node s port for web service so that this Home Node knows where to find the Global Node then type in 192 168 1 102 as this Home Node s IP and 8080 as port the Global Node knows where to find this Home Node The type in the chord port 9820 for Global Node that we obtained from last step then press OK Please note that you need to consider the IP and port for Web Service in your case such as city name
10. e on which that type of Node is deployed The procedure of deploying the system involves preparation distribution and configuration 3 1 Deployment Preparation Now we have two machines connected in LAN We will use the machine 1 with IP 192 168 1 101 as the Global Node and machine 2 192 168 1 102 as a Home Node Please make sure all the firewalls are closed The softwares we install on both machines are Page 14 MySQL Server 5 0 as DB server PHPMyAdmin 2 11 7 as DB setting tool Sun GlassFish Server v2 1 as application server 7 EE Mozilla Firefox 3 0 14 as Explorer for running admin panel 10 WinRAR to manip 3 1 1 Setup database On both machines in the MySQL console create a user for the database MySQL Command Line Client Dat Server version 5 86 51b community nt MySQL Community Edition GPL gt Type helps or 5h for help Type We to clear the buffer mysql gt CREATE USER sovoip 2 localhost IDENTIFIED BY hiscuit Query OK B rows affected 0 00 sec mysql gt GRANT all privileges ON sovoipdb TO sovoip localhost gt IDENTIFIED BY hiscuit Query OK H rows affected CR DH sec mysql gt CREATE USER sovoip localhost IDENTIFIED BY biscuit mysql gt GRANT all privileges ON sovoipdb TO sovoip localhost gt IDENTIFIED BY biscuit In the PHPMyAdmin panel or you can use MySQL console itself of both machines cre
11. el WinRAR to manip a ee En 2 1 1 Setup database On both machines in the MySQL console create a user for the database MySQL Command Line Client Dat Server version 5 86 51b community nt MySQL Community Edition GPL gt Type helps or 5h for help Type We to clear the buffer mysql gt CREATE USER sovoip 2 localhost IDENTIFIED BY hiscuit Query OK B rows affected 0 00 sec mysql gt GRANT all privileges ON sovoipdb TO sovoip localhost gt IDENTIFIED BY hiscuit Query OK H rows affected CR DH sec mysql gt CREATE USER sovoip localhost IDENTIFIED BY biscuit mysql gt GRANT all privileges ON sovoipdb TO sovoip localhost gt IDENTIFIED BY biscuit In the PHPMyAdmin panel or you can use MySQL console itself of both machines create a database called sovoipdb Firstly for Global Node functions run the script db global_node_structure sql under the database sovoipdb secondly for Home Node functions run the script db public_node_structure sql under the database sovoipdb After that all the table structures are created phpMyAdmin i Import has been successfully finished 5 queries executed AE eee sovoipdb 2 K phpMyAdmin SQL Dump version 2 11 7 sovoipdb 2 http war phpmyadmin net BE assignment Host localhost EI server into Generation Time Oct 19 2009 at 11 11 AM After cre
12. fter the deployment of the servers In GlassFish server s console h st 4848 go to Applications gt Web Applications press deploy button then choose the war file to deploy The server s console will give helpful information to diagnose the deployment Output mmm b Java DE Database Process x GlassFish VZ Retriever Output HomeNode run deploy 5 ap EJBClassloader H urlSet doneCalled false E Parent jawa net UBLllassLosaderidecad aa SharedSecrets get Javaletaccess javra net URLClassLoader 7 9rfh7s wegen successful DPLS306 Servlet Web Service Endpoint S0VolPGlobalNodeImpl listening at address http l 2 23 192 193 3080 ClobalNode S0VolTPGlobalNodeluploervice deployed with moduleid GlobalNode wegen successful DPLSS06 Servlet Web Service Endpoint S0VolPHomeNodelImpl listening at address http l 2 25 192 193 9080 HomeNode S0VolPHomeNodelmploervice deployed with moduleid HomeNode lt CE Output Q Search Results After the deployment of the servers User Manual 2 3 Deployment Configuration Now the servers are deployed they need to be configured for initialization and connection The outlooks of the admin panels are tatty you may need to bear with them 2 3 1 Configure The Global Node To configure the Global Node after GlobalNode Administrator Panel knowing the IP address exposed to the outside world in this case it is Setup Glokal ode F
13. if they can be just a passing through server The deployment are different for these two kinds of servers for each of them a dedicated war file containing an Page 3 User Manual administration panel will need to be deployed separately on the machine on which that type of Node is deployed We also define the Home Node which is nearest to a client as this client s Nearest Node The behaviors of inter servers and server client communication are helpful for understanding the working scheme of the entire system For further information please refer to next section 1 2 Online support and resources Take two typical workflows in the system as examples A Workflow of Authentication and Registration Client A s NearestNode Ciient HoweNous Client B s NearestNode Client B s HomeNode 1 ClinetA logs into A s HomeNode same to B 2 A s HomeNode assign a Node to A as its NearestNode same to B 3 Finally ClientA s NearestNode takes care of A same to B NOTE in this scenario Home Nodes maintain the registration information of corresponding Clients in their databases not the NearestNodes Page 4 User Manual B Workflow of UserSearch s HomeNode I Client B s NearesNode Flat ec Tomanade Client B 1 ClinetA uses UserSearch to ask for ClientB s IP and port via ClientA s NearestNode 2 ClientA s NearestNode uses Chord to retrieve ClientB s HomeNode
14. ion Server A Web application module consists or a collection of Web resources such a3 JavaServer Pages ISPs servlets and HTML pages that are packaged in a WAR Veb Application Archive file or CT Applications EH Enterprise SE directory TS Se i e HomeNadeAdmir Enable Disable GI Globelhocde iS HomeNode EI Homehode true Homehlode Launch Redeploy E GlobaiNodesami _ Globalnlode rue EES EE ZE EJB Modules F GlobalModeAdmin true _AGlobalMode Admin Launch Redeploy Connector Modules LI HomeNodesdmin true HomeNodeadmin Launch Redeploy After deployment of the servers using one machine which is not the case of multiple machines In GlassFish server s console lo st 4848 go to Applications gt Web Applications press deploy button then choose the war file to deploy The server s console will give helpful information to diagnose the deployment Output b Java DB Database Process x GlassFish V Retriever Output HomeNode run deploy ap EJBClassloader H url et doneCalled false E Parent jawa net UBLllassLosaderidecad S SharedSecrets ger Javaletaccess javra net URLClassLoader 7 9rfh7s wegen successful DPLS306 Servlet Web Service Endpoint S0VolPGlobalNodeImpl listening at address http l 2 23 192 193 3080 ClobalNode S0VolPGlobalNodeluploervice deployed with moduleid GlobalNode wegen successful
15. lease input IF 192 168 1 101 go to OK http localhost 8080 GlobalNodeAdmin index jsp GlobalNode Administrator Click to quit chord aquit Panel Type in 192 168 1 101 then press OK Then the Global Node is started The port number should be remembered for the next step GlobalNode Administrator Panel Result Successfully created the chord IF and Portifer cherd localIP 192 168 1 101 Port 9820 Action performed Go back to admin panel 2 3 2 Configure The Home Node HomeNode Administrator Panel On machine 2 after knowing the IP address exposed to the outside world in this case it is setup HomelMode step 1 register this node to global node GloballTade s IF 192 168 1 101 192 168 1 101 80 to GlobalNode s port for web service 8030 http localhost 8080 HomeNodeAdmin index j this HomeMode s IP 192 168 1 101 his Homeode s port for web service 8080 sp Home Node Administrator Panel Type in thas HomeNode s city name Melbourne i 192 168 1 101 as Global Node s IP and 8080 as l H Setup Homelbfode step 2 connect to boot chord in global node Global Node port for web Service SO that this GiobalNode s port for boot chord 9820 Home Node knows where to find the Global OK Node then type in 192 168 1 101 as this Home Node s IP and 8080 as port the Global Node knows where to find this Home Node The type in the chord port 9820 for Global Node that we obtained from last step then press OK
16. rties and edit it There some fields you might need to change Fields Explanations Key Default Value Conditions username sovoip If you have another username password biscuit If you have another password url jdbe mysal localhost 3306 sovoipdb if the JDBC URI is changed INITIAL_PORT 9820 if the system can t use it as chord port After modification you can replace the properties file in the war file The same to HomeNode war which is under the deployment folder when you are the administrator of machine 2 Extract the file HomeNode war WEB INF classes utility config propertie and edit it There some fields you might need to change Fields Explanations Key Default Value Conditions username sovoip If you have another username password biscuit If you have another password url jdbe mysal localhost 3306 sovoipdb if the JDBC URI is changed INITIAL_PORT 9900 If can t use it as chord port After modification you can replace the properties file in the war file 3 2 Deployment Distribution Manually deploying the war files on GlassFish server The GlobalNode war and GlobalNodeAdmin war should be in machine 1 The HomeNode war and HomeNodeAdmin war should be in machine 2 Home M Version Logout Mi Help i User admin Domain domain Server localhost Sun GlassFish Enterprise Server v2 1 gt Common Tasks Applications Web Applications Registration Web Applications Applicat
17. signed by Dr Arif Jubaer aiming to provide a light weight robust solution to VoIP This project is a part of the Sun Academic Initiative program sponsored by University of Melbourne and Sun Microsystem To design and implement this P2P based servers for a service oriented VoIP software Java MySQL server and Glassfish server are used to realize the features in the original proposal The development environment is based on NetBeans IDE 1 1 System Overview Global Node cw r Es Admin We WS Interface li WS Implemetation JDBC Chord Boot Home Node C gt cw Admin We WS Interface ial WS Implemetation JDBC gt Deployment diagram showing all the components in this system As illustrated in the deployment diagram the system has two kinds of servers Global Public Nodes and normal Public Nodes Global Public Nodes are referred as Global Nodes in the future Since the normal Public Nodes are all used as Home Node which maintains information of users assigned to it we refer to this kind of servers as Home Node It is necessary that the nearest nodes in the prototype are all avatars of home nodes even
18. u might need to change Fields Explanations Key Default Value Conditions username sovoip If you have another username password biscuit If you have another password url jdbe mysal localhost 3306 sovoipdb if the JDBC URI is changed INITIAL_PORT 9900 If can t use it as chord port After modification you can replace the properties file in the war file 2 2 Deployment Distribution Manually deploying the war files on GlassFish server The GlobalNode war and GlobalNodeAdmin war The HomeNode war and HomeNodeAdmin war Home Version Logout M Help User admin Domain domaint Server localhost Sun GlassFish Enterprise Server v2 1 Me A a oe Common Tasks Applications Web Applications Registration Web Applications Application Server A Web application module consists of a collection of Web resources such a3 JavaServer Pages JSPs servlets and HTML pages that are packaged in a WAR Web Application Archive file or 4 Roslivatiins JSPs pag packag ek App directory gt Ea Enterprise SE zi Deployed Web Applications 4 zz e EEN es SJ Undeploy Undeploy Enable Enable Disable egen e rm eps Action iS HomeNode Homeklocde true Homehlode Launch Redeploy BB Sana Node cin E i fe GE GEES ZE EJB Modules F GlobalModeAdmin true _AGlobalMode Admin Launch Redeploy Connector Modules I HomeNodeadmin true HomeNodeAcimin Launch Redeploy A
Download Pdf Manuals
Related Search