HyperCast 2.0 User Manual - Computer Science
Contents
1. ener 14 6 3 DISTRIBUTED WHITEBOARD ccccccccccsssecsssssssses sesssscescececeecesceceecssusaas 16 7 RUNNING MEASUREMENT EXPERIMENTS 17 7 1 STARTING RUNCONTER O Lists S teer ore Eee eee S Saa a 17 7 2 STARTING 6 0 0 18 7 3 RUNCONTROL 55 00000000 18 7 4 REMOTE TERMINAL FROM RUNCONTROL TORUNSERVERS 19 8 APPENDIX CONFIGURATION FILE HYPERCAST PROP 20 1 24 2002 User s Manual 2 1 Introduction This User Manual contains a brief description for installing and configuring the HyperCast 2 0 software The manual describes how to configure the software for the two overlay network topologies that have been implemented 1 e alogical hypercube where a rendezvous of nodes is done via IP multicast and e a Delaunay triangulation where a rendezvous is done with a server The user manual also describes how to run three simple demo applications which are included in HyperCast 2 0 These applications are e amany to many file transfer program MFTP e amedia streaming application and e adistributed whiteboard In addition we describe a set of tools for testing and monitoring overlay networks created by HyperCast 2 0 2 Getting Started 2 1 Required Resources HyperCast 2 0 is written in Sun Microsy2. or gt buttons The User List shows all current users in the overlay Each whiteboard is associated with a user who is identified as username host timestamp The File Save menu saves the content of the canvas as a JPEG image 1 24 2002 User s Manual 17 7 Running Measurement Experiments To run measurement experiments with HyperCast there are two programs called RunControl RC2 and RunServer RS2 A host that runs a RunServer creates a specified number of overlay sockets The RunControl program is a monitoring program which communicates with the RunServer programs at different hosts to collect measurement data from the overlay sockets and to modify configuration parameters see Figure 6 Run Server E Overlay Socket E Overlay Socket Overlay Socket Overlay Socket HyperCast Run Run Overlav Socket Overlay Controller Server Veray S00 Network Overlay Socket d Overlay Overlay Socket Run ise Overlay Socket Overlay Socket Socket Figure 6 A RunServer can create several overlay sockets The Runcontrol remotely monitors these sockets by communicating with the RunServers that started the overlay sockets 7 1 Starting RunControl The RunControl program is a console for the control of measurement experiments The RunControl provides a command line interface that allows a user to control and measure data from experiments The user can change the parameters o
3. server in the configuration file 3 Start applications Once the DT server is running applications can be started Applications that cannot reach the DT server are not integrated in the overlay network 1 24 2002 User s Manual 9 4 Configuring an Overlay Server An overlay server is a server that can help with the management of overlay IDs and overlay attributes and helps with the configuration of application that use HyperCast overlay socket For example if an application does not know the attributes for an overlay network the overlay server can provide these attributes and ensure that the attributes used by all applications are compatible A HyperCast overlay server can be used 1 to create overlay IDs 1 to query if an overlay network with a given Overlay ID exists or not 2 to download the attributes of an overlay network The overlay server is implemented as a minimal HTTP server Refer to the chapter Overlay Network Management of the HyperCast 2 0 Design Documents for an in depth discussion of overlay servers Any HyperCast 2 0 overlay network can be run with or without an overlay server If no overlay server is used all configuration information for an overlay socket is read from the local configuration file with default name hypercast prop Hence the application users must ensure that the configuration files are compatible If all applications use the same configuration file compatibility of the appli
4. SOCKET ADAPTER SocketAdapter ScktAdptTCP SocketAdapter ScktAdptUDP ScktAdptTCP MaximumPacketLength 16384 ScktAdptUDP MaximumPacketLength 16384 ScktAdptTCP Timeout 10000 ScktAdptTCP MaxIdleTime 2000 ScktAdptUDP MessageBufferSize 100 1 24 2002 User s Manual FE FE FE E IE AE AE FE AE E AE AE E FE AE FE FE AE FE FE E FE AE FE FE AE FE FE AE FE FE AE FE AE FE FE AE FE EA H NODE Node DT2 0 Node HC2 0 DT2 0 Coords 12345 67890 DT2 0 Coords USE_IP DT2 0 Coords RANDOM10000 DT2 0 TimeoutTime 10000 DT2 0 SlowHeartbeatTime 2000 DT2 0 FastHeartbeatTime 250 DT2 0 ServerHeartbeat 250 DT2 0 TryBackupServerTime 10000 HC2 0 SleepTime 400 HC2 0 MaxAge 5 HC2 0 MaxMissingNeighbor 10 HC2 0 MaxSuppressJoinBeacon 3 EE EE EE EE EE EEE EE EE T HN NODE ADAPTER The type of node adapter is implied by the selection of the Node NodeAdapter NodeAdptUDPServer NodeAdapter NodeAdptUDPMulticast NodeAdptUDPServer MaximumPacketLength 8192 NodeAdptUDPMulticast MaximumPacketLength 8192 NodeAdptUDPServer MessageBufferSize 18 NodeAdptUDPMulticast MessageBufferSize 18 NodeAdptUDPServer UdpServer0 127 0 0 1 8081 NodeAdptUDPServer MaxTransmissionTime 1000 NodeAdptUDPMulticast UDPMulticastAddress 224 228 19 78 9472 21
5. overlay network and the DT protocol Node DT2 0 which builds a Delaunay triangulation overlay network The choice of the overlay protocol requires that additional attributes be set For example the HC protocol uses IP multicast for the rendezvous process of new applications Hence an IP multicast address in one of the attributes e Selection of the protocol for data transfer Attribute SocketAdapter This selection determines how application data is transferred between overlay sockets The choices for the protocol are TCP and UDP If the socket adapter uses TCP for data transfer the configuration file has an entry SSocketAdapter TCP For UDP the entry is SocketAdapter UDP i Refer to the Chapter Overlay Network Management of the HyperCast 2 0 Design Documents for an in depth discussion of attributes 1 24 2002 User s Manual 6 3 2 Configuration of any HyperCast 2 0 Overlay Network To set up a new HyperCast 2 0 overlay network the following attributes are common to all overlay network topologies OverlayID some unique name gt Socket HCAST2 0 SocketAdapter ScktAdptTCP or ScktAdptUDP These attributes determine the overlay ID the version of the overlay socket and the type of socket adapter The version number must be HCAST2 0 The values of SocketAdapter must be ScktAdptTCP for data transfer with TCP or ScktAdptUDP for data transfer with UDP There are two additional
6. session The complete set of commands can be viewed by typing help at the RunControl s command prompt experiment status Prints the current status of the experiment start new sockets NumberofSockets Adds numberofSockets new overlay sockets to the experiment 1 24 2002 User s Manual 20 8 Appendix configuration file hypercast prop This is the HyperCast Configuration File c University of Virginia 2001 FE FE aE aE IE AE AE FE AE E FE aE EE EE EEE EEE EE EEE Y H LOG FILE LogFileName LogFileName stderr LogFileName stdout LogFileName hypercast log aE aE E FE FE EE EEE EE EE EE EEE EEE BREE ERROR FILE ErrorFileName ErrorFileName stderr ErrorFileName stdout ErrorFileName hypercast err HEHEHE HE HE HE EEE EEE HHH EEE HHH HEE HEE HEE E E E Overlay Server OverlayServer OverlayServer HTTP HTTP HTTPServer0 http 128 143 71 50 8080 0verlays HE HE HE HE TE TE TE E HE E Overlay OverlayID testOverlay KeyAttributes Socket SocketAdapter Node NodeAdapter NodeAdptUDPServer UdpServer0 Hae EE FE E FE FE FE FE AE EE FE AE FE EEE EEE EE EE ERE HE SOCKET Socket HCAST2 0 HCAST2 0 TTL 255 HCAST2 0 ReceiveBufferSize 200 HCAST2 0 ReadTimeout 0 FE FE HE E IE AE AE FE AE E FE AE E FE AE FE FE AE FE FE E FE AE FE FE AE FE FE AE FE FE AE FE AE EE E FE EHE H
7. 4 2002 User s Manual 10 application The created Overlay ID together with the key attributes is returned to the application b If the configuration file contains m Overlay ID and the overlay server has no record for this Overlay ID the server assumes that a new overlay network must be created Here the overlay server creates a new record that associates the submitted Overlay ID with the submitted key attributes and returns the Overlay ID with the key attributes to the application c If the configuration file contains an Overlay ID and the overlay server has a record for this Overlay ID the server returns the Overlay ID and the key attributes stored at the server to the application Any download key attributes from the overlay server take precedence over values in the configuration file gt Simple Overlay Server interface Microsoft Internet Explorer A Tw Ba ci QUAERIS Address http 128_ 143 137 Simple Overlay Server Interface Create Overlay gt QverlayID Subnit Statistics Page Active Overlay IDs Figure 3 Website of the overlay server 1 24 2002 User s Manual 11 The following are instructions to use the overlay server l Start an overlay server An overlay server can be started on any host where the HyperCast software is installed The command java classpath hypercast2 0 release jar edu virginia cs mng hypercast HTTP Server 8080 starts an overlay server at
8. HyperCast 2 0 User Manual Installation Configuration and Demo Applications HyperCast Team Department of Computer Science University of Virginia Email hypercast cs virginia edu Web http www cs virginia edu hypercast January 2002 University of Virginia 2002 1 24 2002 User s Manual 1 L INTRODUCTION k Wa aaa Goosecessdocesvecceesteesocseete os 2 2 eee oet ere o Dal wi Eo RE 2 2 1 REQUIRED RESOURCES n u 2 22 DOWNLOADING AND INSTALLING HYPERCAST 2 0 2 2 3 RUNNING A DEMO PROGRAM A DISTRIBUTED WHITEBOARD 4 CONFIGURING HYPERCAST 2 0 OVERLAY SOCKETS 5 3 1 A PRIMER ON HYPER CAST ATTRIBUTES nsn 5 3 2 CONFIGURATION OF ANY HYPERC AST 2 0 O VERLAY NETWORK 6 3 3 CONFIGURATION FORHYPERCUBE HC OVERLAY NETWORKS 7 3 4 CONFIGURATION OF DELAUNAY TRIANGULATION DT O VERLAY NETWORKS 8 4 CONFIGURING AN OVERLAY SERVER 9 5 RUNNING HELLOWORLD PROGRALMI 12 6 DEMO APPLICA TIONS 13 6 1 MULTICAST FILE TRANSFER PROTOCOL eene 13 6 2 MEDIASTREAMER AND MEDIA RECEIVER
9. amer Usage java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MediaStreamer wait time to start filenamel bitrate numloop filename2 bitrate numloop with e wait time to start Delay in seconds before the Media Streamer starts to transmit data default 30 seconds e filenamel filename2 Names of the media files 1 24 2002 User s Manual 15 bitrate Bitrate in kbps The default are 1500 kbps for MPEG 1 video mpg and 40 kbps for music mp3 loop number The number of times a file is transmitted by the MediaStreamer default 1 Example e The command java classpath hypercast2 0_release jar edu virginia cs mng hypercast demo MediaStreamer 20 mymedia mpg 1000 1 waits for 20 seconds before transmitting the file mymedia mpg at 1000 kbps for a single time e The command java classpath hypercast2 0_release jar MediaStreamer 60 mymedial mpg 1000 1 mymedia2 mpg 140 2 1 24 2002 User s Manual 16 6 3 Distributed Whiteboard A distributed whiteboard is a drawing utility that allows several users to share a drawing space The distributed whiteboard demo application is shown in Figure 1 A user can draw items on the whiteboard emove items copy or move items to another location in the whiteboard etc If the application is run on several hosts each drawing done on any whiteboard is displayed on all other whiteboards The configuration file nype
10. attributes for a log and an error messages The default value for these attributes is stderr which displays log and error messa ges on the monitor If the values are set to a file name the messages are written to a file LogFileName lt file name gt ErrorFileName lt file name gt The following subsection explains sample configurations of the HC and DT protocols 1 24 2002 User s Manual 7 3 3 Configuration for Hypercube HC Overlay Networks Hypercube HC overlay networks use IP multicast transmissions for the rendezvous process for adding new nodes to a hypercube and for preventing partitions Therefore the configuration file of an overlay socket that uses the hypercube protocol needs to contain an IP multicast address 1 Acquire an IP multicast address and port number To create a new HC overlay network the application must acquire an IP multicast address and a port number In the following we assume that the address and number 15 224 228 19 78 9472 This is the value in the hypercast prop file Set the configuration file The following attributes should be set when configuring an overlay socket for an HC overlay network KeyAttributes Socket SocketAdapter Node NodeAdapter NodeAdptUDPMulticast UDPMulticastAddress Node HC2 0 NodeAdapter NodeAdptUDPMulticast NodeAdpt UDPMulticast UDPMulticastAddress lt Multicast IP address port number gt Comments e For hypercube overla
11. cations is always ensured Download Overlay server attributes Application with overlay socket attributes Configuration file Figure 2 Applications read configuration parameters for an overlay socket from a configuration file and or download configuration parameters from an overlay server The configuration parameters are called attributes The application reads attributes from the configuration file hypercast prop If one of the attributes specifies an overlay server OverlayServerzHTTP the application downloads attributes from the overlay server The downloaded attributes overwrite the values of the configuration file When an application starts an overlay socket it performs the ollowing steps see Figure 2 1 It reads the attributes in the configuration file and 2 if the configuration file specifies an overlay server accesses the overlay server and send its key attributes to the server The server distinguishes a few cases a If the configuration file of the application contains no Overlay ID the server assumes that a new overlay network must be created and generates a new Overlay ID The created overlay ID consists of a string which contains the IP address and port number of the server and a timestamp The Overlay ID creates a record that associates the key attributes submitted by the In HyperCast 2 0 the overlay server only stores key attributes of an overlay network 1 2
12. e configuration file The following are the changes to the provided configuration file hypercast prop to run the DT protocol KeyAttributes Socket SocketAdapter Node NodeAdapter NodeAdptUDPServer UdpServer0 Node DT2 0 NodeAdapter NodeAdptUDPServer NodeAdptUDPServer UdpServer0 lt IP address port number of DT server Comments e Node DT2 0 selects the DT protocol as the overlay protocol Choosing the DT protocol requires to select NodeAdapter NodeAdptUDPServer and to set NodeAdptUDPServer UdpServer0 to the IP address and port number of the DT server e When Node DT2 0 the default value of NodeAdapter is NodeAdptUDPServer e When 128 143 71 50 8081 is the IP address and port number of the DT server then the setting should be NodeAdptUDPServer UdpServer0 128 143 71 50 8081 2 Start a DT server The DT protocol performs the rendezvous process with the help of the DT server For each overlay ID there is one dedicated application which acts as DT server The DT server must be started before any other application in the overlay A DT server is started with the command java classpath hypercast2 0_release jar edu virginia cs mng hypercast DT DT Server Recall that the IP address and the port number are stored in the configuration file in attribute NodeAdptUDPServer UdpServerO0 Since the IP address of the DT server must be the local address the DT server ignores the IP address of the DT
13. f an experiment and collect data from the overlay sockets of RunServers that are connected to the RunControl There are different versions of the RunControl program for experiments with Delaunay triangulation and hypercube overlay networks The RunControl program for Bir re overlay networks can be started as follows on Unix systems the 5 is replaced by y y java classpath hypercast2 0 release jar parser jar jaxp jar edu virginia cs mng hypercast HC HC RC2 noserver 1500 The RunControl program for ate triangulation overlay networks can be started as follows on Unix systems the 5 is replaced by java classpath hypercast2 0 release jar parser jar jaxp jar edu virginia cs mng hypercast DT DT RC2 noserver 1500 1 24 2002 User s Manual 18 In the preceding commands 1500 is the port number through which the RunControl initially communicates with the RunServers The noserver argument indicates that RunControl does not use a server to automatically discover RunServers When the Run Control is started it prints a line similar to the following Created noserver Socket at address 128 143 137 16 1500 The displayed line gives the IP address and port number of the socket through which the RunServers can establish communication with RunControl The user must initialize any RunServers that wish to use RunControl with this IP address and port number This line indicates the IP address and port number of the sockett
14. hat is used for communication between RunControl and RunServers Whenstarting a new RunServer you must provide this socket address Eventually the RunControl program displays the following command prompt gt In Section 7 3 we discuss the commands that can be typed at the command prompt The commands start a measurement experiment collect data and modify parameters of an experiment in execution 7 2 Starting RunServers A RunServer is started at each host that is involved in a measurement experiment The commands to start a RunServer is identical for hypercube and Delaunay triangulation overlay network experiments and is as follows on Unix systems the is replaced by M java classpath hypercast2 0_release jar parser jar jaxp jar edu virginia cs mng hypercast testing_and_monitoring RS2 128 143 137 16 1500 10 The command has three parameters The first parameter is a string which describes a set of attributes that override the attributes in the hypercast prop file An empty string indicates that there are no changes The second parameter 128 143 137 16 1500 is the address of RunControl The third parameter is the maximum number of overlay nodes that the RunServer will create 7 3 RunControl Commands We next discuss commands that can be typed at the command prompt of RunControl The commands help and neip neip give a complete list of available commands A simple experiment might use the following set
15. of commands e available Tells the number of available nodes running on all RunServers e create experiment 10 Tells one or more RunServers to start a total of 10 overlay sockets e Start transcript foo xml Indicates that all messages form the RunServers will be written to in XML format to file foo xml e slow start experiment 5 Tells all RunServers to generate new overlay sockets at a rate no greater than 5 overlay sockets per second 1 24 2002 User s Manual 19 e wait until stable Forces RunControl to wait until the overlay network has stabilized The command outputs the total time required by the overlay network to become stable e get bw results This command displays for each overlay socket the number of packets and bytes that were sent or received e stop transcript This command closes the transcript file e g foo xml e stop experiment This command terminates the overlay sockets of the RunServers and terminates the RunServers 7 4 Remote Terminal from RunControl to RunServers The RunControl program can create a remote terminal similar to telnet to a RunServer The remote terminal can be used to query orset the RunServer s local properties RunControl can only run one remote terminal at a time The ability to establish a remote terminal must be enabled by typing start telnet service port number at RunControl s command line prompt The following is a subset of the commands that can be used in a remote terminal
16. on The MediaStreamer and MediaReceiver use UDP for data transfer between neighbors in the overlay network The configuration files hypercast prop must be set to SocketAdapter ScktAdptUDP The MediaStreamer sends media files at a specified bit rate to a set of MediaReceivers The MediaReceiver sends the received data to a local UDP port for playback The MediaReceiver does not provide a media player Therefore some media player e g MpegTV available at http www mpegtv com is needed which can play media streams that are received from a UDP port Media Receiver Media Receiver Media Streamer HyperCast Overlay Network Media Receiver Figure 5 MediaStreamer and MediaReceiver applications The media receiver forwards the data to a local UDP port The Media Player is not part of the demo application The Media Player can be any network capable media player Starting a MediaReceiver Usage java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MediaReceiver port number where port number isthe port on which data is received default 6666 Example The command java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MediaReceiver 9000 starts a MediaReceiver which receives an incoming media stream at UDP port 9000 If the playback is done by a tool such as MpegTV the tool should be configured to receive data on port 9000 Starting the MediaStre
17. port number 8080 Set the configuration file Whether an overlay socket uses or does not use an overlay server is specified in the configuration file For example if an application uses an overlay server at IP address 128 143 137 16 and port 8080 the configuration file must contain the following entries OverlayServer HTTP HTTP HttpServer0 http 128 143 137 16 8080 Overlays If no overlay server is used the line reads OverlayServer or the line is commented out as follows OverlayServer HTTP or the line is missing Start applications Once the overlay server is running applications can be started Note For DT overlay networks a DT server must be started The overlay server and DT server are independent entities 1 24 2002 User s Manual 12 5 Running HelloWorld Program The software distribution contains the Java code of a simple application called HelloWorld which uses the overlay socket of HyperCast The HelloWorld application creates an overlay socket that joins an overlay network After joining the overlay the applications multicasts the string Hello World only once in a message to the overlay network All applications that receive the message display the content of the message on the screen After the string is sent the program waits in an infinite loop for Hello World strings sent from other members of the overlay network The downloaded software has two Java files with t
18. rCast distinguishes two types of attributes key attributes and configurable attributes Key attributes are important attributes of an overlay network in the sense that applications that have the same values assigned to the key attributes should be able to communicate The list of key attributes is part of the configuration of an overlay socket and is specified in the attribute KeyAttributes The attributes overlay ID and KeyAttributes are always key attributes and are not included in KeyAttributes The most important attribute of an overlay network is the overlay ID which uniquely identifies a specific overlay network Thus the overlay ID can be used as a key to determine the other attributes of an overlay network The HyperCast 2 0 protocol does not enforce a specific convention for selecting overlay IDs Good choices for overlay IDs are discussed in Chapter 4 of the HyperCast 2 0 Design Documents Note that many attributes have a default value If an attribute is expected in the configuration file but is missing then the default value is selected Default settings of attributes are explained in Appendix C of the HyperCast 2 0 Design Documents The following attributes select the overlay network topology and the protocol for data transfer The attributes should be set as key attributes e Selection of the overlay protocol Attribute Node The choices are the HC protocol Node HC2 0 which builds a logical hypercube
19. rcast prop is set as described in Section 3 The distributed whiteboard runs with the DT protocol 2 0 or the HC protocol 2 0 The socket adapter can be set to TCP SocketAdapter ScktAdptTCP orto UDP SocketAdapter ScktAdptUDP Start Whiteboard java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo Whiteboard Usage The whiteboard main window see Figure 1 consists of several areas which includes a drawing area a Tool Chooser a Color Chooser a Pager and a User List The Tool Chooser is used to choose a tool for drawing A tool is selected by clicking on the icon that represents the tool then all following operations are done with this selected tool The available drawing tools are BRUSH TEXT T LINE RECTANGLE 0 ROUND RECTANGLE 9 OVAL and POLYGON 4 When REMOVE is selected clicking on an item in the drawing canvas removes the item When MOVE is selected a drag and drop mouse operations can be used to move an item COPY is similar to MOVE but it areates a new copy of the selected item The Color Chooser is used to select a color for drawing The Pager is used to create a new page and switch between pages The whiteboard can contain several pages Drawing on one page will not affect other pages The current page number is shown in the textbox of the Pager To create a new page click New Page button To switch between pages click
20. release jar edu virginia cs mng hypercast DT DT Server The command displays the IP address and port number of the DT server e g DT Server Starts Successfully at 128 143 137 17 8081 3 In the second and third terminal start the Whiteboard application with the following command java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo Whiteboard You will see an interface similar to Figure 1 Select a shape or other object and draw in the canvas 2814 21 89181087 NT Figure 1 Whiteboard GUI 1 24 2002 User s Manual 5 3 Configuring HyperCast 2 0 Overlay Sockets Each overlay socket in HyperCast 2 0 can be configured to run different overlay network topologies and different protocols for data transfer The configuration of an HyperCast 2 0 overlay socket involves setting parameters called attributes in a configuration file The default name of the configuration file is hypercast prop The configuration file is read by an application when a new overlay socket is created This section discusses the most important configuration options Note The configuration of HyperCast overlay sockets can be simplified with the help of an overlay server The use of overlay servers is discussed in Section 4 For now we assume that no overlay server is used 3 1 A Primer on HyperCast Attributes The configuration of HyperCast is done by modifying attributes in the configuration file Hype
21. sfer protocol that can be run with or without a graphical user interface GUI The configuration files hypercast prop must be set so that the overlay sockets use TCP for data transfer between neighbors in the overlay network i e SocketAdapter ScktAdptTCP To start an MFTP client without a GUI in Windows or Unix type java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MFTP Text send To start an MTFP client with a GUI in Windows type java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MNGmftp windows To start an MTFP client with a GUI in Unix type java classpath hypercast2 0 release jar edu virginia cs mng hypercast demo MNGmftp unix Notes e The 15 shown in Figure 4 The use of the GUI should be self explanatory The application provides a minimal help menu e By default the program creates a directory called in the current working directory This folder holds the files received from other MFTP applications connected to the overlay network The directory store received files can be specified as follows o If MFTP is started without a GUI type the command etdir directoryname o If MFTP is started with a GUI you can set the receiving folder by selecting the Set Receive Folder sub menu under the File menu 1 24 2002 User s Manual 14 6 2 MediaStreamer and MediaReceiver This is a simple media streaming applicati
22. stems Java programming language and can be used on any platform on which the Java Development Kit JDK version 1 2 or higher is installed Information on downloading the JDK can be obtained from http java sun com The storage requirements of the uncompressed HyperCast 2 0 software are less than 2MB 2 2 Downloading and Installing HyperCast 2 0 Downloading e The HyperCast 2 0 software is available from http www cs virginia edu hypercast download html e Download one of the following two compressed archives The files in the archives are identical hypercast2 0_release zip best for Windows platforms hypercast2 0_release tar gz best for Unix platforms Installing on Windows 1 Create a directory e g hypercast2 0 and download hypercast2 0 release zip into this directory 2 Extract hypercast2 0_release zip into this directory with a package such as WinZip Installing on Unix 1 24 2002 User s Manual 3 1 Create a directory e g hypercast2 0 and download hypercast2 0 release tar gz into this directory 2 Create a terminal Unix shell or Windows command prompt and change to the created directory 3 Extract hypercast2 0 release tar gz with the following command gunzip hypercast2 0 release tar gz tar xvf The archives hypercast2 0 release zip and hypercast2 0 release tar gz are identical and contain the following files Table 1 Files contained in the downloaded archi
23. ve hypercast2 0 release jar a jar file that contains all Java classes of the HyperCast 2 0 software parser jar a jar file that contains the Java classes to process XML Documents Java API for XML Parsing hypercast prop The configuration file for HyperCast overlay sockets The content of the configuration file is listed in the Appendix of this manual User manual pdf This User manual in PDF format readme txt Readme file with instructions set up hypercast2 0 hypercast prop default A backup copy of the configuration file hypercast prop HelloWorld CallBack java Source code of sample programs Hello World NoCallBack java 1 24 2002 User s Manual 4 2 3 Running a Demo Program A Distributed Whiteboard The following steps describe how to run a simple demo application that uses the HyperCast 2 0 software The demo application is a distributed Whiteboard program The topology of the overlay network is a Delaunay triangulation Each Whiteboard application is started with the settings in the configuration file hypercast prop The content of the configuration file is included in the Appendix of this manual Instruction to run the demo program 1 Open three terminal windows on the same host In each terminal change to the directory where the HyperCast software is located e g hypercast2 0 2 In the first terminal start a so called server with the command java classpath hypercast2 0
24. wo versions of the HelloWorld program e HelloWorld_CallBack java e HelloWorld_NoCallBack java The difference between the two programs is explained in Part II of the design documents see http www cs virginia edu hypercast documentation html Programming The following explains how to compile and execute the HelloWorld program 1 Create a terminal and change to the directory where the HyperCast software is located 2 Compile the Java program with javac classpath hypercast2 0 release jar HelloWorld CallBack java 3 Within a short amount of time execute the Java program in multiple terminals or multiple hosts If necessary copy the compile d program HelloWorld CallBack class to remote hosts The program is executed with the command In Unix replace by 4 java classpath hypercast2 0 release jar HelloWorld CallBack 1 24 2002 User s Manual 13 6 Demo Applications The following three applications MFTP Media Streamer and Whiteboard are part of the software distribution The applications are not sophisticated and limited in features All applications can run with the HC and DT overlay protocols nrc X nici xij Phe Tes sarmer 2 t8 Dre EL 4 111228 5 Figure 4 Graphical user interface GUI of the MFTP application 6 1 MFTP Multicast File Transfer Protocol This is a multicast file tran
25. y networks it makes sense to use the acquired multicast IP address as the Overlay ID eg OverlayID 224 228 19 78 9472 e There are several attributes that describe transport addresses with an IP address and a port number Here the port number can be separated by a or a ipu So both 224 220 19 78 0472 and 224 228 19 78 9472 are valid e The choice of the KeyAttributes is not enforced However the shown list of key attributes is recommend Setting Node HC2 0 selects the HC protocol as the overlay protocol e Choosing the protocol requires to select NodeAdapter NodeAdptUDPMulticast and to se NodeAdptUDPMulticast UDPMulticastAddress to an IP address and port number e When NodezHC2 0 the default value of NodeAdapter is NodeAdptUDPMulticast Hence if no value for NodeAdapter is set in the configuration file the default value is chosen 3 Start applications Applications can be started immediately when the configuration file is set Refer to the Chapter Overlay Protocols of the HyperCast 2 0 Design Documents for an in depth discussion of attributes 1 24 2002 User s Manual 8 3 4 Configuration of Delaunay Triangulation DT Overlay Networks The Delaunay triangulation DT overlay network of HyperCast 2 0 uses a server program called DT server for performing rendezvous functions Therefore when the DT protocol is used one needs to start a DT server 1 Set th
Download Pdf Manuals
Related Search