MassWare User`s Manual Version 1.0.2
Contents
1. else if e mType MassWare MassWareArchEventArgs REACTIVE CHANGE toolStripStatusLabel Text Reactive Architecture Changed mMessage Stop and release the middleware object if thisWare null thisWare Stop thisWare Dispose Q GC Collect 5 Source File List Mass Ware cs XMLParser cs Architecture cs Actuator cs EventBC cs EventComp cs EventBool cs EventExpr cs ExprParser cs SyncRequest cs SyncReply cs UDPServer cs UDPClient cs Masslet cs WebCam cs JPEGCompress cs JPEGDecompress cs Display cs MassTool cs AvailableCPU cs ABWPTR cs Common cs PTRClient cs PTRServer cs Decision Engine main class Contain a XML parser and a reconifigurator the XML Parser to parse the XML file create the event sensors and actuators the MassWare reconfigurator contains multiple actuators the MassWare actuator contains a component chain the MassWare event the MassWare compare event the MassWare Boolean event the MassWare expression event the expression parser to parse the expression event the synchronization request package the synchronization reply package the receiver side of the communication channel the sender side of the MassWare communication channel the Masslet base class it defines the message type for masslet communication the WebCam component that grab the image from the camera the J2. XML schema file any user developed XML file should follow this schema for grammar check vcRules xml XML based adaptation policy script file for the video conferencing application elRules xml XML based adaptation policy script file for the E learning application 3 Usage Instructions 3 1 Modify the XML file Set the components locations in the XML script file to your local components directory For example if your measurement tool ABWPTR dll is in D temp set your script file like component cid l 01 lt file gt D tempyABWPTR dll lt file gt lt name gt MassTools ABWPTE ABWPTPRZ name lt ytype gt Double z vtype lt alias gt AVAILABLEBW lt alias gt param pid 001 gt zname SetPacketsize lt name gt lt voype gt Ints2z z vtype value 32 lt value gt lt param gt param pid 00a gt zname SetPackethum lt name gt lt voype gt Int32 z vtype value 2 lt value gt lt param gt param pid 03 SetInterval z name lt voype gt Int32 z vtype value 30000 paran components Also modify the reconfiguration components locations in the XML script file 3 2 Start the application Video conferencing application 1 Download all the files to two different machines 2 Double click the VideoConferencing exe file to start the application and you will get the following GUI Fig 3 HS The Mobile 4Qwareware ideo Application
3. B x File Adaptation Help Connect to Connect to a remote application Zz Figure 3 The Graphic User Interface of Video conferencing Demo The main frame is divided into two sub frames The left frame is view of local video and the right frame is the view of remote video The status bar shows the current action and internal stats 3 Start the application in another machine 4 Connect to remote machine by click Connect to submenu in File menu as Fig 3 5 After connecting that machine or connecting to itself click start menu to start the data video capture and transmission The left frame will show the local camera video and the connected remote application will show your video view in its right window E learning application 1 Download all the files to two different machines 2 Double click the teacher exe file to start the teacher server and you will get the following GUI Fig 4 FormSlide Router Configuration Student Shengpu from IP 128 180 121 94 connected Student Siliang from IP 128 180 123 19 connected Student Ging from IP 128 180 123 21 connected Professor A Figure 4 The Graphic User Interface of the Teacher program in the E Learning Demo There are two frames in the teacher side the main frame left side contains the menu bar and two areas the video area that show the local and connected student videos and the text area show for message chatti
4. MassWare User s Manual Version 1 0 2 p The Mass Ware Team LONG Lab Lehigh University http marches cse lehigh edu Laboratory of Network Group Aug 15 2008 L WRAL OMe RR clea ts ciara cists E alates Gs at lo eg ss Gale ese 3 I WAS S T 3 2 DetolstEatOfbs 4 2 IistallattOn Instruction 6 o ITS BIC LIONS AE ar oa ater es ad ta Du deep eo a ce ee ae aT cee deh ac obe Raa EE I 7 JA Modi he XML E ER HERREN y 3 2 Lat ENG applied ica UE su Ou p uM cua DE MIDI CI D 7 4 Development Instr cttOls nu c ben ptu ae 10 4 1 The Mass Ware system D NIE 10 4 2 Nass Ware application development ius eto d een rita Eo toa de eda dee Re Qo Ee tod ade tea ea 10 De OUECE Pie EISE oe oia p debiera atit content ideas ah sparen tora oae cuneta une UE iicet cod epit Sai Todes 12 6 Source Code Copy Si elc E pM dedi ies 13 1 Introduction 1 1 MassWare MassWare Mobile Ad hoc and Sensor Systems Middleware is an adaptive and reflective middleware framework to solve the critical issue of the reconfiguration time and engineer real time distributed adaptive applications in the dynamic environments Compared to the traditional middleware that supports the single component chain based application architecture MassWare maintains mul
5. PEG Compress component that compress the input image the JPEG decompress component the display component that display the received image in local window the MassTool base class it defines the message type for masstool communication the measurement tool component that measure the available CPU the measurement tool component that measure the available bandwidth the common definition for ABWPTR server and client the client side of the PTR bandwidth measurement tool the server side of the PTR bandwidth measurement tool 6 Source Code Copyright Copyright c 2008 Lehigh University Bethlehem PA USA All rights reserved This source code 15 a part of the MARCHES project The MARCHES project is supported by the National Science Foundation and carried out at the Laboratory Of Networking Group LONGLAB IN NO EVENT SHALL LEHIGH UNIVERSITY BE LIABLE TO ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION EVEN IF LEHIGH UNIVERSITY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE LEHIGH UNIVERSITY SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE SOFTWARE PROVIDED HEREUNDER IS ON AN AS IS BASIS AND LEHIGH UNIVERSITY HAS NO OBLIGATION TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS
6. echanisms it achieves it primary goal of facilitating a software developer to handle adaptation inside their applications therefore to let the software developer to be more focused on application s own logic instead of dealing with the complexity of adaptation The Demonstration also validates the efficiency of the run time reconfiguration for supported applications There are two applications implemented and used in this demonstration Video conference application the video conferencing application is a peer to peer application and each distributed program contains a sender part and a receiver part In the sender part proactive actuators prepare and send video frames and in the receiver part reactive actuators receive and display the frames There are four masslets Grab Compress Decompress and Display and two awaretools that measure the available bandwidth between the hosts and the available CPU resource respectively The application architecture can be dynamically reconfigured by using or not using the Compress masslet or using different compressing ratio according to three adaptation rules E learning application The E learning application is client server application for distance education The teacher server program can prepare and disseminate video audio and text message and share slides with connected students Based on the network conditions the server program can dynamically change the video and audio quality or shut d
7. ng The slide right side frame is adjustable to sharing the interest desktop image e g slides to connected remote students 3 Start the student exe in another machine and you will get the following GUI Fig 5 4 5 0 1 ApplicationStudent File Router Configuration fou have been connected to Teacher Prof Liang Professor A Figure 5 The Graphic User Interface of the Student Program in the E Learning Demo There are also three frames in the student side the video left top area that show the local and remote teacher videos the text left bottom area show for message chatting and the slide area that shows the slides in connected teacher machine Connect to the teacher program from the student program by click the Connect to submenu in the File menu You will see the message in the text message area if the connection is established After connecting that machine or connecting to itself the student can retrieve the slides from the teacher side and communication with the teacher through video audio and text information 4 Development Instructions 4 1 The MassWare system UML diagram icampoanentChain CampanenthWanager Reconfiguratior ocriptParser fg SyncReply Event Compareevent BooleanEvent ExpressianEvent Figure 6 The UML diagram of MassWare Implementation As shown in Fig 6 MassWare contains three c
8. ore classes blue color Event MassWareAgent and Reconfigurator The Event class 1s the core class of MassWare sensor which can be further inherited by CompareEvent BooleanEvent and ExpressionEvent The CompareEvent contains two double type event sources left hand side and right hand side and a compare conditioner for comparing the two event sources The BooleanEvent contains two Boolean type event sources and a Boolean conditioner The ExpressionEvent 15 the class to build context expressions in a binary tree manner It supports addition subtract multiply and division operations and brackets The ExpressionParser is used to parse the ExpressionEvent to build the expression tree The MassWareAgent class 1s the core class of the MassWare decision engine It invokes the ScriptParser object to parse the user defined adaptation policy script builds the hierarchical events and subscribes the actuators to corresponding event sensors It also communicates with peer agents for synchronization after reconfiguration The Reconfigurator is the core class of the MassWare reconfigurator It contains multiple actuators and each actuator contains a component chain The corresponding actuator notified by the context sensor will active its component chain to process the application data 4 2 MassWare application development All the source code are implemented in Microsoft Visual Studio 2005 Setthe environment Add middleware reference to
9. own the video and audio components and only send the text messages 2 Installation Instructions Requirements Operating System Windows XP amp Windows Mobile 5 6 Memory 256MB minimum or more Runtime environment Net 2 0 Development kit Microsoft Visual Studio 2005 Other required tools MSXML 4 0 Provided file list for the demo applications Mass Ware dll the major DLL file of the MassWare system Masslet dll the masslet base component MassTool dll the awaretool base component VideoConferencing exe the executable file of the video conferencing application Teacher exe the executable file of the teacher program in the E learning application Student exe the executable file of the student program in the E learning application Provided example components Measurement Tool Components ABWPTR dll get the available bandwidth data based on IGI PTR algorithm AvailableCPU dll get the available CPU data Users can use their own developed measurement tools by just replacing the tools description in the script file Reconfigurable Components WebCam dll grab the video from the camera JPEGCompress dll compress the video data by JPEG algorithm JPEGDecompress dll decompress the video by JPEG algorithm Display dll display the data in local view Users can also use their own components and please refer the XML file description in the following pages Provided XML script files dcRules xsd
10. r The core layer consists of eight function modules which construct the adaptive and reflective framework for accommodating MassWare components and efficiently reconfiguring its behaviors Measurement tools a decision engine and an XML based script parser constitute the basic reflection model A dynamic reconfigurator and a hierarchical event interpreter are proposed to support the efficient context evaluation and reconfiguration In addition a communication channel for the inter communication among peer agents an information register requester for reporting fetches awareness information to from a centralized information manager and a component manager for managing all types of MassWare components are designed as surrounding services Measurement tools are the lowest building blocks that monitor the dynamic environments and report the environment awareness results as the contextual information to be processed by event sensors The sensors and actuators in addition to adaptation policies are defined by application developers or users in a XML script file There are two types of actuators proactive and reactive ones each of which contains a component chain and performs reconfiguration actions The XML script parser parses the script file and constructs the sensors and proactive actuators to process local data The reactive actuators are constructed through the synchronization process with peer agents to process the received data Once a context t
11. riggers an event sensor a corresponding proactive actuator will be activated by the decision engine to perform reconfiguration actions In the operation layer various services are offered by software components that implement specific algorithms and protocols There are two types of components in the operation layer computing components called masslets for processing application data and awareness measurement tool components called awaretools for measuring contextual information A MassWare supported application consists of a list of computing components and can be adaptively reconfigured at run time according to context changes and adaptation policies Adaptation A Distributed Adaptive Application Ad Adaptation zm ee Program Program aod Op eration Computing Components Computing Components Actuator a Reconfigurator Decision Decision Engine amet Parser Event ceased Sensors Tenet lables Communication Channel Centralized Information Manager Network Hardware Fig 2 System architecture of MARCHES 1 2 Demonstration This demonstration illustrates the major functionality of MassWare an adaptive and reflective context aware middleware framework that efficiently handles reconfiguration for distributed real time and embedded DRE applications in a generic consistent and clearly separated way By providing a set of tools and underlying m
12. the application project MassWare dll Define the middleware object and instantiate it with the script file MassWare MassWare thisWare null thisWare new MassWare MassWare D temp vcRules xml Initialize the middleware and define the architecture change callback function thisWare Initialize thisWare AddArchSubscriber new MassWare Architecture MassWareArchChangeEventHandler MassWareArchChanged Set the application level component parameters set the parameter list object paramlist localWnd Handle localWnd Width localWnd Height set the parameter for the component 1 WebCam WebCam thisWare SetAppParameter Masslets WebCam WebCam SetLocalWindowInf 181 paramlist new object 3 remoteWnd Handle remoteWnd Width remoteWnd Height thisWare SetAppParameter Masslets Display Display SetDisplayInf paramlist thisWare SetAppParameter MassTools ABWPTR ABWPTR SetRemoteAddr new object remoteIP Start Engine start the middleware and run time reconfigure the application behavior accroding to the adaptation plicies thisWare Start Implement the behavior change call back function private void MassWareArchChanged object sender MassWare MassWareArchEventArgs if e mType MassWare MassWareArchEventArgs PROACTIVE CHANGE toolStripStatusLabel Text Proactive Architecture Changed
13. tiple component chains Fig 1b Therefore there is a new method proposed for the behavior reconfiguration that switches active and inactive chains This new method replaces the traditional method of modifying the single chain structure to reduce the local behavior change time Further according to the new method an efficient active message based asynchronous synchronization protocol is proposed for synchronizing the behaviors of distributed programs This results in a dramatic reduction of the distributed behavior synchronization time by eliminating the operation suspension time and buffer clearance time The robustness of the distributed application is improved since the use of active messages results in no synchronous communication and system halting in the synchronization process E122 Active Chain i Inactive Chain i MD DORODD OTO One Chain Modified Chain Inactive Chain j Active Chain j Architecture 1 Architecture 2 Architecture 1 Architecture 2 a b Fig 1 Dynamic reconfiguration architecture a single component chain architecture in existing middleware b multiple component chain architecture in MassWare MassWare is located between the lower hardware and network layer and the upper application layer to monitor environments and support application adaptation It is peer to peer middleware and there is one middleware agent per application in each host Each MassWare agent can be separated into a core layer and an operation laye
Download Pdf Manuals
Related Search