- Java.net
Contents
1. application can play one of the following roles e Broker Peer that acts as a coordinator There must be one or more of them The functionality of the broker includes to control the user login locate peers the creation of groups and rooms find the best simpleclients to run a task find the best peer to download a file locate the shared files manage the internal database and manage a groupware tool e Client Peer with a user front end A client needs to interact with a broker in order to function Clients may share files send messages and send tasks to be executed remotely Simpleclient Peer without user front end that is used exclusively to execute user tasks 2 System requirements In order to use this application the following software and hardware resources will be needed 2 1 Software requirements Because OVERLAY is a Java based application it can be installed in any platform The required packages are JDK1 5 or above JXTA 2 4 1b MSSQL Server 2005 2 2 Hardware requirements Broker server Database server currently the database is installed ineinfnt2 uoc es Clients run in terminals with a user front end SimpleClients they can run in terminals without a user front end For testing it was used the PlanedLab grid 3 Application installation 3 1 Downloading The application is distributed as three autoexecutable JAR files Brokerjar Client jar and SimpleClhient jar These2. from a group and finished at the root NetPeerGroup The user cab specify the initial group As a result the user is presented with the list of found files Each hit returns the name and group of the peers share this file It also return the hash a value to uniquely identify the file 4 9 3 File transfer and peer selection configuration The user can configure some transfer parameters and when the file is shared by more than one peer the criteria to choose the peer to transfer the file from With respect the file transfer configuration Fig 19 the user can specify for each group the available input and output connection speed ranging from 56Kb up to 20Mbs and the size of the slice in which a file 1s divided for its transmission default 100 kb The user can also specify the directory where to store the received transfers Group s Parameters Group Default Directory UserData transters hange Connection 1 Mbps 384kbps Size transmission Bytes V Figure 19 Configuration for file transfer With respect to the peer selection Fig 20 there are different criteria that the user can choose a specific peer a random peer the peer with a better ping the most economic peer the most secure peer the fastest peer using load balancing Find s Parameters Type of puntuation Load a preferred Model Activate criterium Value of the criterium successfully messages sent in this session h successfully messag
3. B H Uoc 3 files 576 KB nii Insktal_lacio_InstantMessaging pdf M lacolla 972 KB H instantMessaging bat MAlacolla LRE i jehatirc log M lacolla 3 KB MetPeerGroup 3 Files oro KB H Instal_lacio_InstantMessaging pdf M lacolla e KB H instantMessaging bat M iacolla is fee ichatire log M lacolla 3 KB i profesors 3 Files 578 KB H Instal_lacio_InstantMessaging pdf M acolla sical H instantMessaging bat M acolla LED b jehatirc log M lacolla 3 KB i alumnes 3 files 578 KB Se Instal_lacio_InstantMessaging pdf M acolla a72 RB H instantMessaging bat MAlacolla Ga fee jchatirc log MAlacolla 2 KB Figure 17 Shared files 4 9 2 File search The user can search shared files given its file name or by content Currently only the first option is available Fig 18 depicts the find by name parameters and the result of a seach Find s Parameters The filename contains Start seraching from the Group pfc y Extension Ys z i par OF pat OF log Ind processed in 9 milliseconds The total Time was 9 milliseconds Del this searcl File Name Size Seeds Name of the peers Groups of ti peers Hash chatirelog 5 KB 3 1 1 1 pfc UOC NetPeerGroup PLAST IOG583044 85 32088 3444246299294 3592612 Figure 18 Find by name The user can search files indicating a substring At the moment no advanced patterns like or are allowed The user can also specify the range of the file size to search The search starts
4. The P2P OVERLAY application User s manual Table of Contents ITP ic agora 14 ei 61a iaeeere meee ey mete eat ates Peer amy Sete Corian E Re ee en T nee Career l DY SUC ES Gure EA Se E aaa a T 2 2A DOMWale TEC UIC MENS eere n a N E A T E 2 22 Hardware es 811 meN irnar E E E T A E 2 KAPPAN INSANA ON s550 ceevence a e aT opteakaseeeiscasheaeaets 2 Seb Download iht sadin a E a edith dda act abe diet dell hc cag 2 32 Broker instalation and conn guritio li eesse a E A N 3 3 5 Client mnstallanloncand COnN Surati iosa A E E R 3 D E E a E E EEI E E E E E E A E E E EA EAT O 3 S EES e E E EE E EE A E EET 3 AA USET VS en E E ETE TTO 3 ArU conogra Oe oei E E AEA ATA ET E ETEA 4 AGT Ne by OF ANTOLINAN OU ei a ieee EA ee ee 5 PUSSES OX col ih rere Cae E ene EE ne ee N rc 6 KS KWAO OUD chosing esac ae ite oa eee dd meee vein ene eee 6 AO Cat Witla sinine USE ioare n idee tte helen erste Gea E T S 7 A Room manage mi N taonsaronenar nnan E A R EO J To eG HO anon shared Enen a E EAE E leds tac beacon ora 8 4O Sharina TCS a sosnnielGaa tutes a tedax tenuate tuted sah cee baa lubes hia iret clsambadiet stacy 8 os OG eg Cee directory SNAS ee a TOS 8 PIZTI Se ee re ee em A ne TY ee eer 9 4 9 3 File transfer and peer selection configuration 2 0 eeeeeeeccecccceeceaeseseeeeeceeeeseseeseaeeeseees 10 IS FIE transfer MMOFMAION a Ahaits cas alee dc dehododetdin N 11 4 10 Downloading a SHALCO ANG cadecxavedsaceinncssesinnconsoundeceantsdaassnssenevasaani
5. al Statistics ou say Hello Mr 1 Figure 11 Chat with a user Note that this window also allow to share files and submit tasks between the two peers 4 7 Room management A room is a temporal group created by a user Users can create rooms at any moment The mechanism to create a room is the following the user asks the broker to create a room by giving it a name and selecting the peers Al least one peer must be selected If the broker accepts the group it creates it The user can see the new room in the list of groups for example as prova2 in Fig 12 Peers Groups Me UPC q W UOC 1 Online MetPeerGroup a 1 Online lms overlay pe arowa 1 Online me alumnes 1 Online Figure 12 New room created Once the other users accept the invitation the new room is created New users can be invited at any time by clicking the Invite to a room button Fig 9 4 8 Sending a non shared file Users may require to send privately a file to another user To access this use case click on the SendFile button of the Messenger subpanel Fig 9 or the SendFile button of the chat with a single user window Fig 11 The sending file window is showed in Fig 13 Send a file Select the file Select a group NetPeerGroup Select the destination peer 1 Online accept O Figure 13 Sending a file The use must indicate the file to be sent and sele
6. asks e The directory where to store downloaded files e The size of the parts when a file is transmitted The default is 100 Kb This size is important because TODO Crops Group nfo Select a gesupe Mama Oveday e Weiheeracn Description Raul Farnandes s PRC E pip ts Responsable fuhata Parent Group UP Broker femsnideminozoml isi upe edu Number of users 1 User Info in this groug Feer Mame convidat Description r Stabs di re m ZPU LOdd Mhz y conne dion L Mbe s 364 kbps Executables 0 Directory Transfer UserDeteldransters Chame Gize mansnisshomg i100 KR Pinion thot All thes groups have this parses hes Statistics Clients stetistics of this greup Beokers statistics of thas groun Clante statistice of the met Breakers statictics af the net Figure 6 Groups and user information 4 3 Get network information The user can get configuration information upper part of Fig 6 about each group it belongs responsible person rendezvous location and number of connected users Note that the groups are hierarchical and the root group is always named NetPeerGroup The user can also get statistics lower part of Fig 6 about e the user s of a group pending tasks message statistics chat statistics file statistics and executable statistics e all the groups e a broker message statistics rooms statistics executable tasks statistics and groupware statistics e all brokers These s
7. cates the scenario name a description the group involved and the due to date As a result the broker creates the scenario and the user can see its initial state Fig 30 New Scenario S New Task T Info F Reload Change State Reassign ay User tasks n i Ji a Task State Completed Description Creator Assign Approved Start Date Total 1 Scenarios iE alumnes 1 Scenarios i PROJECT 1 O Tasks DESHI enric Pi Wer iie 1e eas CET e00 Figure 30 Initial scenario status 4 12 2 Creating a new learning task Now the owner of the scenario can create new learning tasks and assign them to users Fig 31 Scenario Task Name Description Group Assigned to peer Maximum Date to finish Figure 31 Learning task creation Once the broker creates the learning task the user can see the new task in the scenario 4 12 3 Learning task reassignment TODO 4 12 4 Changing the state of a task TODO
8. ct the destination peer and the group Once sent at the destination peer will pop up an acceptance window Figure 14 Figure 14 File acceptance window 4 9 Sharing files Users may wish to share files with a group Click on the Files button from the top panel Fig 5 The user is presented with the file subpanel of Fig 15 r Search by filename Fg configuration SF Search by file content iy Trasfers session g Shared Files Figure 15 File subpannel The user can choose to share files check the state of the transferred files configure the criteria to transfer and find files and find files by file name or content The next sections describe these actions in more detail 4 9 1 File directory sharing When the user clicks on the Shared Files button Fig 15 a new subpanel appears where the user can decide either to share a single file or directory or delete a shared file or directory Fig 16 depicts this panel my at me Add the files of a Folder 4 Add a File i 3 Del the files from a folder x Dela Figure 16 File sharing panel H The user can select the file directory and can specify which groups will share the files The window will show the shared files in each group Fig 17 Group File Folder Size Total 15 Files 2 3 MB if pfc 3 Files SEER phin Instal_lacio_InstantMessaging pdf M lacolla 9 2 KB H instantMessaging bat MAlacolla Le i jchatire log M lacolla 2 K
9. es sent in all sessions total successfully messages sent during the last 2h i Number of Messages in the outbox Queue now Average of Messages in the outbox Queue Number of Messages in the inbox Queue now Average of Messages in the inbox Queue Average of attempts in outbox in this session Average of attempts in outbox in all sessions total Average of attempts in outbox during the last 2 h Send bytes in this session Send bytes in all sessions total lt Figure 20 Configuration of peer selection 4 9 5 File transfer information The Transfer Session button Fig 15 displays the status of all the incoming and outcoming transfers Fig 21 Notice that the information includes the selected peer d 1 X Open z i Send File g Receive file kay Cancel Del i Clear Logs Download Transfers File Name State Completed Sender Peer Size Mes Instal lacio _InstantMe REQUEST SEN O 1 Online 572 KB Request sended Upload Transters File Name State Completed Destination Peer Size Mes Figure 21 Transfer information 4 10 Downloading a shared file To download a shared file click on the SharedFiles button of the Messenger subpanel Fig 9 A window like in the one of Fig 22 is displayed Request a shared File Select the sender peer enrif Online Select the file incidencies in3 txt Size of this file 547 Bytes Save in UserDatatransferss
10. files are available from http lacolla uoc edu overlay To start a component simply type java jar lt component jar gt 1 JXTAisa P2P middleware This version can be downloaded from http download jxta org build release 2 4 1b 3 2 Broker installation and configuration command java jar Broker jar With this broker packaged distribution no configuration is needed 3 3 Client installation and configuration command java jar Client jar With this client packaged distribution no configuration is needed 3 4 Peer discovery The discovery process is transparent to the user For a peer to discover a broker or a broker to discover another broker a web file containing a list of brokers is read In the current distribution the URL of this file is hard coded and points to http www lsi upc es rfernandez rendez dat The contents of this file 1s as follows tcp Lacolla uce edus 9 01 http y lacolla uoc edu 9700 To avoid these ports be closed by a firewall JXTA uses a tunneling configuration 4 Client use cases 4 1 User login Note This manual assumes that the information about the user login and the groups it belongs has already been entered in the broker s database See the administrator s manual for details Once launched the client prompts to enter the login information username convidat password SESSGo0e Figure 1 Sign up screen After that the application tries to locate a broker Fig 2
11. incidencies in3 txt i Figure 22 Shared file download form The user has to select the group the peer and file to download 4 11 Remote task management 4 11 1 Client configuration A client can also act as a simpleClient and participate in the execution of tasks The user can specify which kind of tasks the client will be able to run To configure the client go to Executable Tasks gt Config Figure 23 a Ly Ek The net gus Messenger ie Files O Executable Tasks B Groupware tools L JE Ra 2 No Configuration Group s Parameters Group If J Executable Types that can do Other Executable Types Connection JAVA vel LOGS UOC Figure 23 Configuring the Client as a SimpleClient The user can select for each group which executable types is allowed to run 4 11 2 Create a new executable task To create a new task go to Executable tasks gt new task Fig 24 The user must indicate the task name the type the group New Executable Task Task Name Tascaz Description Type Group Executable Expected time to compute Maximum Time How many tasks Included myself as a candidate peer Configure the method to search the best peer Figure 24 New task creation the type of task configuration see Fig 25 expected and maximum time number of slices to divide the task the peer selection mode if it is a candidate peer 4 11 3 Task configuration A type of
12. ions enric Group UPC Executable Hanoi 20 Execution Prevision Time ms 20000 Total Prevision Time ms 16366 Position in the execution queue IN EXECUTION Executable tasks in this computer q Task Name State Sender Pssages Total 2 executions ieee TASCAL FINISH 1 parts JAVA Queens 8 3000 Part 1 Executable FINISH lt br gt feo Part 1 FINISH Executable FINISH lt br gt TimeeEx Hove TASCAZ ACCEPT 1 parts JAVA Hanoi 20 20000 Executable Accepted Part 1 ACCEPT Executable Accepted Figure 27 Task information The user gets the state of each of the parts the task 1s divided By selecting a part the user gets additional information as for example the selected peer and the state in the execution queue 4 12 Learning task management The application offers also a groupware facility Users can create scenarios i e projects and assign learning tasks to other users A task here isn t meant to be an executable piece of code as in 4 11 Instead a task here 1s any kind of human performed work that helps to finish an scenario Fig 28 depicts the scenario panel Mew Scenario New Task Change State Info Reload Reassign User tasks Figure 28 Scenario panel 4 12 1 Scenario creation To create an scenario the user must click on the New Scenario button Fig 29 New Scenario Scenario Description Group Maximum Date to finish 16 03 2007 Cancel Figure 29 Scenario creation The user indi
13. oeds scart E 11 A Ale Remote task mana e Meniaga A A var dew E A N 12 41r Ms CA COT UNE ALON e ac ce cals aoc EON 12 ALe Croitean Ww CXCCUIAOLS LAS Kisra or a nda naetuscatathne O 12 KIES TISK COMTIC UNA LI OM cts css ciate t ct st sass valk sSiosaie a paula tanputtaa haha lected ue datas ongidadtes pucaaloeeced oes 13 ALA PCr SEIS CON COMIC IEA OM 6 edge ET Oued ieahaee ides nett eet sae as 13 Sy Us AG Ge CU OM asa sh e tlre setae aaa raes fea as ss Sale ate aetna SH a folk aire eee 13 EEOAE ONA O 8 Dene ee en ee ee ere see A ene DERS eae EN 13 A Wd Learming task Mmana OCIS 5 i peziort cone ieee ben cua scenes ET EE NTE 14 A12 T Scena ocre ON serenana a a S a 14 412 2 Creatine a new dearing Task oien T E T 15 4 12 3 earning task reassignment TODO iceneriiionniaiii eea E edsavaaansadaeeuenaaenae a 15 4124 Chans na thestateor a task TODO rr N 15 1 Introduction This manual explains how to install and use OVERLAY a peer to peer P2P application carried out by Raul Fernandez in his final engineer degree at the UOC A P2P application is a distributed application where each participant shares its own resources with the other participants Shared resources typically include storage capacity computational power or media files OVERLAY is a centralized structured P2P application At present users can use OVERLAY to share files send messages create room chats and execute its own Java tasks remotely in parallel The peers involved in this
14. sends the logging information Fig 3 and if successful the user receives a connection confirmation Fig 4 The first time this process it may take a while due to JXTA internals Otherwise after 60 seconds without response the client gets finished As a result JXTA creates a jxta directory with configuration information The user can then use the application Fig 5 Connection Attempting to find a rendezvous node 59 seconds Remaining time Figure 2 Finding a rendezvous broker Connection Sending the logging request The first time can be late 37 seconds Remaining time Figure 3 Sending logging request Connection Logging request sended Waiting a response Connection Info Aame OF Wie peser Gon tiot ID OF hhe beers arm ta aia SST SZ BLES I DIEA eo rA Poa OSs eso Sd PASC eee FUE TSU SAA MAIN DnD no Don LET oe cee Sengezmour O omjerima ouid 59651 dsb odd ood Fer dor AOsd2 SOFT OS oe oS Fees OO Peace Rao Tine ta conieci 3 seconds Figure 4 Successful response received from a broker T The net ais Messenger Pig Files Jop Executable Tasks Groupware bool ee Figure 5 Top panel with available user buttons 4 2 User configuration By clicking on The net button the user can provide configuration information middle of Fig 6 The user can specify e Its own state online absent e The CPU and network speed used for brokers when choosing candidates to run t
15. task needs to be configured to indicate which task specifically to perform Fig 24 2 Executable Task Mode Java Task Atos iw s upc es rtermandez examples Backtracking jar JAR necessary for the execution Figure 25 Type of task configuration The user must indicate de execution mode Demo User the specific task to perform and the JARs necessary for the execution 4 11 4 Peer selection configuration As with files the user can configure how to select the peer s to execute the tasks The configuration is the as in Fig 20 4 11 5 Task execution Once the broker has selected a peer to execute a part of the task it sends a request to the client asking to accept it Fig 26 In case of a SimpleClient will always accept the request 4 11 6 Task information The user can get at any moment the state of the tasks the client is involved which Fig 27 Executable tasks in a remote computer Task Name State Destination X Executable Task Remote Info Messages Total 3 executions Bese TASCAL FINISH 1 parts JAY xecutable FINISH lt br gt Task N TASCAS Part 1 FINISH earns lt BR gt Quer tere lt B sa TASCA2 ERROR 2 parts JAYA Description O candidates found lt br p Part 1 ERROR sended to the broker ae Part 2 ERROR Type JAVA sended to the broker Foe TASCA3 ACCEPT 1 parts JAY ASCA3 accepted by th ine Dart 1 ACCEPT State ACCEPTED accepted bythe destin Destinat
16. tatistics are given per session last TODO average and total statistics At the moment the statistics are available only from the screen 4 4 User discovery The Messenger button shows which other users are connected to each group Fig 7 Note that your own user won t be displayed Peers 4 Groups a ae oF By rRermandezco f Online ae UOZ ae Ga tharmandeeco f online me MekPesrar op i tRermandezco f Onine H me eTl o ha f ermandezco f Online 3 ke STD Group e tfemandezco f online lite alumnes to Be rhemandeszco foniine Figure 8 Users connected to the network The Messenger button also opens a sub panel Fig 9 Its buttons are activated according the user s selection Gup Info Mew Boon Inse fo 4 rI Chat Send a Fae Shared Filles Sih ae Ensue View Tosk Peee s chatie Figure 9 Messenger subpanel 4 5 Chat with a group By selecting a group and clicking on the Chat button Fig 9 the user can chat with the whole group A group chat window will be opened Fig 10 Y Conversa tions save d for this group dal Statistics ou say Hello group Figure 10 Chat with a group 4 6 Chat with a single user By selecting a user and clicking on the Chat button Fig 9 the user can chat exclusively with the other user A single user chat window will be opened Fig 11 1 Online Ma Send a File g Shared Files L Submit an Executable ay iew Tasks d
Download Pdf Manuals
Related Search