EuQoS MCAST Installation Manual - IAM
Contents
1. tapinstall remove TAPDEY returned 0 TAP Win32 INSTALL tap0501 Figure 4 6 Installation of driver files Page 10 of 28 V1 0 1 EuQoS MCAST Installation Manual U x x af y ky OS 7 Confirm installation of the not validated driver by clicking on Continue Installation Hardwareinstallation A Die Software die fur diese Hardware installiert wird TAP wWin32 Adapter va hat den Windows Logo T est nicht bestanden der die Kompatibilit t mit Windows xP uberpruft Warum ist dieser Test wichtig Das Fortsetzen der Installation dieser Software kann die korrekte Funktion des Systems direkt oder n Zukunft beeintr chtigen Microsoft empfiehlt strengstens die Installation jetzt abzubrechen und sich mit dem Hardwarehersteller fur Software die den Windows Logo Test bestanden hat in Verbindung zu setzen Installation fortsetzen Installation abbrechen Figure 4 7 Confirmation request for installing driver 8 Wait until the installation is complete then click Next gt iik OpenVPN 2 0 9 Setup Installation Complete Setup was completed successfully Completed LEEK Updating drivers For tap0801 From C Program Files OpenYPNidriver OemWwinzk inf A Drivers updated successfully tapinstall install returned O tapinstall cumulative status 0 Output folder C Program Files OpenvPN Extract INSTALL wins32 Ext Extract license Ext 100 Extract openvpn ico 100 E2. 22 Authentication requester Page 18 of 28 V1 0 1 EuQoS MCAST Installation Manual 10 Wait until all files are installed 80080 Install tun tap driver Installing tun tap driver Introduction License Select Des Installation Ty Install Finishing Installation Finis Running ethertap kernel extension Installer script Go Back gt Continue Figure 4 23 Installation progress 11 Click on Close to finish the installation O OPA Install tun tap driver Introduction License Select Des Installation Ty Install The software was successfully installed oe ee Go Bad es 4 Figure 4 24 Successful installation Page 19 of 28 V1 0 1 EuQoS MCAST Installation Manual 4 4 Configuring of TAP under Mac OS X No configuration is required after you restarted the system you have successfully installed and en abled the tuntap driver for Mac OS X 4 5 Installation of TAP under Linux Normally Linux comes with TAP support out of the box Nevertheless if you need to compile a new kernel version that supports TAP use make menuconfig and navigate to Device Drivers 2 Network device support gt Universal TUN TAP device driver support and enable the Universal TUN TAP device driver support as shown n Figure 4 25 Hd root zeus usr src kernels 2 6 14 1 1653 FC4 x86 64 ajl File Edit View Terminal Tabs Help Arrow keys na
3. 33 3001 ready TapInterface lt tapd gt 728 Figure 6 2 Successful launch of MCAST under Windows Page 23 of 28 V1 0 1 EuQoS MCAST Installation Manual EU a OS x Ky Aaja 6 3 Testing MCAST installation To test MCAST you need at least two running and connected instances of MCAST where one is defined as the master node and the other s is are connecting to this master node for details please see Section 5 2 When all the instances of MCAST are running you can start the test application located in the cli ent resp client subfolder of the mcast installation directory This test application will join to a multicast group wait 1 sec and then send the message is alive prefixed with its name amp IP ad dress All already active test applications will show this message as they receive it through MCAST You can start the test application from within the MCAST installation folder as follows java Djava net preferlPv4Stack true jar client client jar Example procedure for testing two ore more MCAST installations e Start the test application as described above on the master node The following message will appear 1 second after the application has been started received through multicast socket hostname x x x x is alive where hostname will be the master node s host name and x x x x will be the master nodes IP address e Start the test application as described above on another host running MCAST the me
4. MCAST 8 2 Problems with VLC running under Windows Problem When I want to send receive IP Multicast data through MCAST under windows the UDP packets are not routed through the TAP interface Solution You have to set the IP address that has been assigned to the TAP interface in the IPv4 multicast output interface address option of VLC To change these settings open VLC and hit CTRL S to open the preferences window enable Advanced options in the lower right and then select on the left in the section Stream output the sub section Access output and enter the TAP IP address for the field IPv4 multicast output interface address see also Figure 8 1 amp Preferences 4 Audio Access output video amp Input Codecs Access output module Default Stream output Access output Hop limit TTL Muxers Packetisers a SAP IPv amp multicast output interface Sout stream I amp VOD IPv4 multicast output interface address 172 30 1 10 Advanced EIS EN Interface Access output modules control the ways the muxed streams are sent This setting allows you to always Force a specific access output method You should probably not do that You can also set default parameters for each access output Reset All Advanced options Figure 8 1 VLC option for setting the IPv4 multicast output interface address Page 27 of 28 V1 0 1 EuQoS MCAST Installation Manual 8 3 Probl
5. be Wechseln zu LAN oder Hochgeschwindigkeitsinternet Netzwerkaufgaben tap bridge Neue Verbindung erstellen ws k Netz zwe i abel wurde entfernt f Ein Heim oder ein kleines Ca TAP Win32 Adapter Vo Firnennetzwerk einrichten Windows Firewalleinstellungen AN Verbindung ndern erbindung hergestellt mit Fir a Netzwerkger t deaktivieren TA Mware Accelerated AMD PCN Xx verbindung rep ml verbindung umbenennen Status der Verbindung anzeigen lv 2 Einstellungen dieser Verbindung ndern Andere Orte G Systemsteuerung Figure 4 13 Network connections Windows will tell you that there is no cable plugged in the tap bridge This is no problem as long as MCAST is not running the interface is not opened hence Windows will claim that network cable s connected After you started MCAST th s message should disappear and the tap bridge should be connected as any other working network interface in Windows 4 3 Installation of TAP under Mac OSX In the following subsections we describe how to install and configure the TAP driver which is re quired for MCAST for the Mac OS X platform Please follow the steps described in this installation manual l Unpack the tuntap tiger driver archive tuntap tiger 20060513 tar gz downloaded from the EuQoS FTP server I tuntap tiger 200605 143 tar gz Figure 4 14 Tuntap driver archive for Mac OS X Page 14 of 28 V1 0 1 EuQo
6. Configuring of TAP under Windows 1 Seta valid not yet used MAC address for the TAP interface Eigenschaften von TAP Win32 Adapter VB Allgemein Erweitert Treiber Details Folgende Eigenschaften sind f r diesen Netzwerkadapter verf gbar Klicken Sie links auf die Eigenschaft die ge ndert werden soll und w hlen Sie den Wert auf der rechten Seite aus Eigenschaft Wert MAC Address s 800020743F3E Media Status MTU r 2 Non Admin Access Nicht vorhanden Figure 4 11 Setting a MAC address 2 Set also a not yet used valid IP address from the range 172 16 0 0 172 31 255 255 Eigenschaften von Internetprotokoll TCP IP Allgemein IP Einstellungen konnen automatisch zugewiesen werden wenn das Netzwerk diese Funktion unterst tzt Wenden Sie sich andernfalls an den Netzwerkadministrator um die geeigneten IP Einstellungen zu beziehen O IP Adresse automatisch beziehen Folgende IP Adresse verwenden IP Adresse 172 30 1 10 Subnetzmaske 255 240 0 0 Standardgateway 172 16 0 1 s Folgende DNS Serveradressen verwenden Bevorzugter DNS Server Alternativer DNS Server Figure 4 12 Setting an IP address Page 13 of 28 V1 0 1 EuQoS MCAST Installation Manual 3 Rename the TAP Interface in the network connections settings to tap bridge pn Netzwerkverbindungen Datei Bearbeiten Ansicht Favoriten Extras Erweitert z Zur ck 7 I Zz Suchen TE Ordner GE
7. ODE true Neugos p4 mcast gt SET USE_EUQOS false GzNeugos p4 mcast gt G Progra 2 WJavanjdk1 5 8_12 hbin java Djava lihbrary path jni tuntap jar multicast middleware jar log4j WARN No appenders could be found for logger Corg apache hivemind impl amp m1M oduleDescriptorProvider gt log4j WARN Please initialize the log4j system properly peer instance started java library path jni tuntap gt starting group peer DHT bind address hrogle fc38d1s3 138 92 64 33 3008 gt gt gt gt boot handle SNH lt x262B8F gt 136 92 64 132 306080 83723721496762967831 node ready peer started gt gt gt gt gt gt gt gt gt joining group 239 255 255 258 received WantToJoin lt Group 239 255 255 258 from 8887582E344986473C378BA45 44045 BE1 577D2B5 gt for lt xE78B19 gt hot true received JoinTo lt Group 239 255 255 258 bootstraps LENOUO BE3FAEES 138 92 64 132 3865 1 for lt 8x888758 gt hot true gt joining to ring on LENOUO SE3FAEES 13 92 64 132 3 5 gt gt gt gt gt gt gt gt gt joining group 172 30 255 255 received JoinToCGroup 172 36 255 255 bootstraps I gt for lt 8x888758 gt hot false gt joining to ring on bootstrapping group 239 255 255 258 from LENOUO BE3FAEES5 138 92 64 132 3885 bootstrapping group 172 38 255 255 from rice pastry socket 1186664434758 No bootstrap node provided starting a new rin g binding to address hbrogle fc38d1s3 130 92 64 33 3861 brogle fc38d1s3 138 92 64
8. S MCAST Installation Manual tuntap_tiger_ 20060513 lt tuntap_tiger_20060513 CO MET a S O O README README installer startup_item pkg we tap_kext pkg tun kext pka _ tuntap_installer mpkg N lof Selected 14 52 GE available Figure 4 15 Tuntap driver installer for Mac OS X 3 Click on Continue on the installation confirmation requester determines if the software can be installed Are you sure you want to continue def This package contains a program that If you re not sure about the source of this package click Cancel to prevent it from running the program and installing the software Figure 4 16 Installation conformation reguester Page 15 of 28 V1 0 1 EuQoS MCAST Installation Manual ke uQo nstallation Manua EU OS y Aa 4 Click on Continue on the welcome screen BOO Install tun tap driver Welcome to the tun tap driver Installer This will install the tunfap software on your computer Introduction tunftap is free as in free beer and reedom but you are welcome to License donate if you like it In order to do so just click the image below you need a PayPal account Select Dest Installation Typ r 4 Install mjin TOU En Go Back 4 Figure 4 17 Welcome screen of the installer 5 Click on Continue when you have read the Software License Agreement 80080 Install tun tap driver Software Lice
9. S WORKING BUT THE APPLICATION DOES NOT RECEIVE ANY IP MULTICAST PACKETS sesse sesse 27 8 2 PROBLEMS WITH VLC RUNNING UNDER WINDOWS esse sees ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee deed AR RARR RR RR EE RE ee ee 27 8 3 PROBLEMS WHEN STARTING MCAST UNDER WINDOWS esse sesse ee ee ee ee ee ee ee ee ee ee ee dese dese ede ee ee Re ee ee ee 28 Page 4 of 28 V1 0 1 EuQoS MCAST Installation Manual U A K O S y 1 Introduction This document presents the set of steps required to install and configure the EuQoS MCAST Soft ware module and the required helper tools drivers This manual has been built and tested in the following way 1 The EuQoS MCAST Software module system has been validated in UBern testbed 2 EuQoS MCAST has been tested with the EuQoS P 4 system 3 LAAS and TID used this installation manual and the MCAST packages available at the FTP server to successfully install the Software This manual shows the steps required to install and configure the EuQoS MCAST components under Windows Linux and Mac OS X Page 5 of 28 V1 0 1 EuQoS MCAST Installation Manual U A K O S at 2 General Hardware and Software Requirements Basic Hardware requirements There are no special Hardware requirements for MCAST a standard PC with at least 512 MB of RAM should be sufficient to install and use MCAST Basic Software requirements e Sun JDK1 5 e Ant 1 5 x only if you need to compile MCAST which is not requi
10. Section 0 To write your own client program using MCAST you can just include the library client jar which is located in the client directory of your MCAST installation Do not move the client jar to another location since it uses relative paths to include other libraries from the MCAST installation The following parts will be marked with certain colors for better understanding The Windows specific part to find the TAP interface is marked in orange e The steps required for opening a multicast socket and joining a group are marked in blue e The commands for performing the QoS reservation are marked in red e Data reception parts are marked in green import ch unibe iam mcast client import java io IOException import java net DatagramPacket import java net Inet4Address import java net InetAddress import java net InetSocketAddress import java net MulticastSocket import java net NetworkInterface import java net SocketException import java util Enumeration public class DummyClient private static Networklnterface determinelnterface throws SocketException Networklnterface ret null for Enumeration ne NetworklInterface getNetworklInterfaces ne hasMoreElements Networklnterface ni NetworklInterface ne nextElement System out printin iface ni getName display name ni getDisplayName if ni getDisplayName startsWith TAP Win32 ret ni return ret public stati
11. V1 0 1 EuQoS MCAST Installation Manual U A K O S PR EuQoS MCAST Installation Manual Editors Marc Brogle Dragan Milic UBern Date 06 05 08 No of pages 28 Synopsis Contributions Page 1 of 28 V1 0 1 EuQoS MCAST Installation Manual U A K O S at Executive Summary This document presents the steps to install and configure the EuQoS MCAST module Page 2 of 28 V1 0 1 EuQoS MCAST Installation Manual U A K O S at Revision History V1 0 1 06 02 2008 Updated it with info about ver sion 4 0 4 V1 0 12 12 2007 Added QCM configuration de scription and parts about Li nux Mac OS X configuration rearranged the sections and subsections VO 12 24 09 2007 Added Mac OS X install in structions VO 15 08 2007 Updated for new version of mcast v4 0 1 which fixed a DHT issue and also added text about 3s delay of test client VO 1 beta 06 08 2007 First draft of the installation manual covering only the Windows platform Page 3 of 28 V1 0 1 EuQoS MCAST Installation Manual Table of Contents REVISION HISTORY oorsese oes Deeds Gee ee GE oe oe ed Ee ed eed ee ee ge ON Gie ee ed od eke Ge oe eed ee ee ed vee ee eek ee ie 3 TABLE OF CONTENTS oo sissies oe Ese Gee Ge deed ee Gede des Ge Ee Ge ON AN Ge Gee Wed Ge eN Ge eN Ge se NEG Ge N Ed NG GN SG eN ed die af L INTRODUE TION sesde see nenn ee Ge ei ee eg eg ee Ge eg ge 5 2 GENERAL HARDWARE AND SOFTWARE REQUIREMENTS 00000r0ss0ssns
12. c void main String argv throws IOException ReservationSystemFailureException InetSocketAddress groupSocketAddress new InetSocketAddress Inet4Address getByAddress new byte byte 239 0 0 9 1234 MulticastSocket ms new MulticastSocket groupSocketAddress getPort Networklnterface ni determinelnterface if ni null ms setNetworklnterface ni ms joinGroup groupSocketAddress getAddress Page 25 of 28 V1 0 1 EuQoS MCAST Installation Manual U x f O S m Ky Aaja MulticastReservation mr ReservationManager createSession groupSocketAddress 0 mr reserveResources 2 1024 1024 300 20 byte packetBuffer new byte 65536 DatagramPacket dp new DatagramPacket packetBuffer packetBuffer length boolean terminate false byte toSend Inet4Address getLocalHost toString is alive getBytes UTF 8 System arraycopy toSend 0 packetBuffer 0 toSend length dp setData packetBuffer dp setLength toSend length dp setSocketAddress groupSocketAddress ms setTimeToLive 255 ms send dp dp setLength packetBuffer length do ms receive dp oyte data dp getData int len dp getLength String received new String packetBuffer O len UTF 8 System out printIn received trough multicast socket received TODO set terminate to true to end the loop while terminate mr release ms close The libraries jar files required to compile and run the DummyClient or
13. c webapp 6920 main INFO Initializing Spring root WebApplicationContext 6920 main INFO org springframework web context ContextLoader Root WebApplicationContext initialization started 6952 main INFO org springframework web context support XmlWebApplicationContext Refreshing org springframework web context support Xm lwebApplicationContext 3b6dbd display name Root WebApplicationContext startup date Wed Dec 12 14 25 10 CET 2007 root of context hi erarchy 7002 main INFO org springframework beans factory xml XmlBeanDefinitionReader Loading XML bean definitions from ServletContext resourc e WEB INF applicationContext xml 7114 main INFO org springframework web context support XmlWebApplicationContext Bean factory for application context org springframe work web context support XmlWwebApplicationContext 3b6dbd org springframework beans factory support DefaultListableBeanFactory 2e60f3 7127 main INFO org springframework beans factory support DefaultListableBeanFactory Pre instantiating singletons in org springframewo rk beans factory support DefaultListableBeanFactory 2e60f3 defining beans routing table manager root of factory hierarchy EE new instance of the facade 7148 main INFO org springframework web context ContextLoader Root WebApplicationContext initialization completed in 228 ms 7265 main INFO com opensymphony xwork2 config providers XmlConfigurationPprovider Parsing configuration file struts default
14. d testing MCAST installation 6 1 Starting MCAST installation under Linux or Mac OS X To start MCAST under Linux or Mac OS X run the file start mcast sh as ROOT user in the MCAST installation directory after you have modified it as described in Section 5 2 Please note e Ifyou start the master node it will wait for connections from other instances of MCAST e If you start a non master node instance of MCAST it will try to connect to the master node as it has been defined during configuration as described n Section 5 2 The file start mcast sh looks e g as follows export FORCE_ROOT FORCE_ROOT false export MASTER_NODE MASTER_NODE 10 195 0 6 2222 export TEST CODE false export USE EUOOS true export SHOW OCM CONSOLE false export QCM_USERNAME QCM_USERNAME dummyauth90 eugos org export QCM_PASSWORD QCM_PASSWORD password java Djava library path jni tuntap jar multicast middleware jar A successful start of MCAST connecting to remote master node is shown in Figure 6 1 82 00 Terminal bash 137x49 Las Ds bart middleware brogle sudo start middleware sh multicast filter ready java library path jni tuntap add net 224 0 0 0 gateway tap0 opened peer instance started old peer started peer started 5688 main INFO org mortbay log Logging to org slf4j impl SimpleLogger org mortbay log via org mortbay log S1f4jLog 5733 main INFO org mortbay log jetty 6 1 5 ter controller war yrab3
15. ded from the EuQoS FTP server to a directory of your choice e g C euqos p4 mcast 5 2 Configuring MCAST Edit the qcm properties in the conf resp conf subfolder of the MCAST installation to point to your AQSSN e g for UBern aqssn location http 10 95 0 4 8080 aqssn services AQSSN To configure MCAST you have to modify the start file called start mcast bat Windows or start mcast sh Mac OS X amp Linux in the directory where you installed MCAST as follows 1 Set the JAVA HOME for Mac OS X and Linux or JAVA_HOME for Windows variable to point to the SUN JDK 1 5 installation directory 2 One host has to be the master node to which an instance of MCAST has to connect to for bootstrapping to find the P2P network for a given multicast group On that host set the MASTER_NODE resp MASTER_NODE to its own public IP address as follows IP ADDRESS 2222 e g 10 195 1 10 2222 For all other instances of MCAST set th s variable accordingly to point to the same master node defined before see also Figure 5 1 IP 10 195 1 50 IP 10 195 1 60 IP 10 195 1 70 connects to for bootstrapping Connects to connects to for bootstrapping for bootstrapping pa IP 10 195 1 10 Master Node For all hosts including the master node itself the variable MASTER_NODE is set to 10 195 1 10 2222 Figure 5 1 Connections resulting from setting SMASTER NODE Page 21 of 28 V1 0 1 EuQoS MCAST Installation Manual 6 Starting an
16. eferred to the SW packages available in home eugos prototype 4 mcast In this folder you can find the following files O mcast v4 0 4 zip gt EuQoS MCAST package for Windows Linux Mac OS X using EuQoS prototype P 4 EuQoS MCAST Installation Manual v1 0 1 pdf gt this installation manual openvpn 2 0 9 install exe 2 Windows OpenVPN installer contains TAP interface for Windows tuntap tiger 20060513 tar gz 2 Mac OS X 10 4 tuntap driver universal binary tuntap leopard 20071114 tar gz 2 Mac OS X 10 5 tuntap driver universal binary mchat java gt a simple java IP Multicast chat application jdk 1 5 0 12 windows i586 p exe gt JDK 1 5 for Windows installer vlc 0 8 6c win32 exe 2 VLC Video Lan Client for Windows vlc 0 8 6c mac dmg gt VLC Video Lan Client for Mac OS X universal binary vlc 0 8 6c win32 exe 2 VLC Video Lan Client for Windows Page 7 of 28 4 V1 0 1 EuQoS MCAST Installation Manual ty x EU OS d Installation and configuration of TAP 4 1 Installation of TAP under Windows In the following subsections we describe how to install and configure the TAP driver which is re quired for MCAST for the Windows platform Please follow the steps described in this installation manual l Launch the OpenVPN openvpn 2 0 9 install exe installer downloaded from the EuQoS N FTP server openypn 2 0 9 install Figure 4 1 OpenVPN 2 0 9 installation file 2 Inthe welcome screen click Ne
17. ems when starting MCAST under Windows Problem When I run MCAST under Windows a message error message saying something like EXEPTION ACCESS VIOLATION appears see also Figure 8 2 c C WINDOWS system32 cmd exe Neugos p4 mcast gt start mcast bat Neugos p4 mcast gt SET JAVA_HOME C Progra 2 Java jdki 5 6_12 Neuqos p4 mcast gt SET MASTER_NODE 136 92 64 132 3666 Neugos p4 mcast gt SET TEST_CODE true Neugos p4 mcast gt SET USE_EUQOS false eugos p4 mcast gt C Progra 2 Java jdki 5 _12 bin java Djava library path jni tuntap jar multicast middleware jar log4j WARN No appenders could be found for logger org apache hivemind impl m1M oduleDescriptorProvider gt log4j WARN Please initialize the log4j system properly peer instance started java library path jni tuntap gt starting group peer DHT bind address brogle fc3 d1s3 130 92 64 33 3 0 Ht An unexpected error has been detected by HotSpot Virtual Machine tt Ht EXCEPTION_ACCESS UIOLATION xcOQ 88005 gt at pc 6x16861584 pid 2688 tid 2632 tt Java UM Java HotSpot TM gt Client UM lt 1 5 8_12 h84 mixed mode sharing Problematic frame G Ctuntap d11 6x1584 Ht An error report file with more information is saved as hs_err_pid2688 log thread 3828 also had an error If you would like to submit a bug report please visit Ht http java sun com webapps bugreport crash jsp Ht Neugqos p4 mcast gt _ Figu
18. nds unibe ch 130 92 70 46 2222 routing table MulticastRoutingTable gt 224 0 0 251 TapInterface tap0 20 A PeerConnection local 130 92 65 55 64799 remote mm cnds unibe ch 130 92 70 46 2222 20 v Figure 6 1 Successful launch of MCAST under Mac OS X Page 22 of 28 V1 0 1 EuQoS MCAST Installation Manual 6 2 Starting MCAST installation under Windows To start MCAST under Windows run the file start mcast bat in the MCAST installation directory after you have modified it as described in Section 5 2 Please note Ifyou start the master node it will wait for connections from other instances of MCAST Ifyou start a non master node instance of MCAST it will try to connect to the master node as it has been defined during configuration as described in Section 5 2 The file start mcast bat looks e g as follows set JAVA_HOME C Progra 1 Java jdk1 5 0_12 set FORCE_ROOT false set MASTER_NODE 10 195 0 6 2222 set TEST_CODE false set USE EUOOS true set SHOW OCM CONSOLE false set OCM USERNAME dummyauth90 eugos org set QCM_PASSWORD password JAVA_HOME bin java Djava library path jni tuntap jar multicast middleware jar A successful start of MCAST connecting to remote master node is shown in Figure 6 2 C eugos p4 mcast gt start mcast bat C eugos p4 mcast gt SET JAYVA_HOME C Progra 2 Java jdki 5 6_12 Gz eugos p4 mcast gt SET MASTER_NODE 136 92 64 132 3606 C C eugos p4 mcast gt SET TEST_C
19. nse Agreement tunfap driver for Mac OS X Copyright c 2004 2005 2006 Mattias Nissler lt mattias nissler gmx de gt Introduction License Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met Select Dest Installation Typ a 1 Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution 3 The name ofthe author may not be used to endorse or promote products derived from this software without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE AUTHOR AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR Install ry Figure 4 18 Software License Agreement Page 16 of 28 1 0 1 1 y y EuQos MCAST Installation Manual U i u k OS y 6 Click on Agree to accept the Software License Agreement To continue installing the
20. re 8 2 Error message with wrong TAP interface name Solution Be sure that the TAP interface in the network connection settings has been renamed to tap bridge and does not have another name like e g LAN Connection 2 see also Figure 8 3 pS Netzwerkverbindungen Bearbeiten Ansicht Favoriten Extras Erweitert wi P Suchen TE Ordner Hab Netzwerkverbindungen v Wechseln zu LAN oder Hochgeschwindigkeitsinternet Netzwerkaufgaben l AN Connection 2 E Neue verbindung erstellen etzwerkkabel wurde entfernt Ein Heim oder ein kleines Laia AP Win32 Adapter v Firmennetzwerk einrichten windows Firewalleinstellungen LAN Yerbindung ndern EO Netzwerkgerat deaktivieren ml verbindung umbenennen By Einstellungen dieser Yerbindung ndern GF Systemsteuerung u Netzwerkumgebung Eigene Dateien Figure 8 3 Wrongly named TAP interface Page 28 of 28
21. red for the installation e Operating System o Windows 2000 or Windows XP but NOT yet Windows Vista o Mac OS X Tiger 10 4 x or Leopard 10 5 x o Linux with a kernel 2 4 or newer with enabled TunTap functionality e TAP interface using OpenVPN installer for Windows the tuntap driver for Mac OS X or the since kernel 2 2 in Linux included tuntap driver for Linux installed and configured described in this manual e An IP Multicast application like DummyClient VLC or mchat for testing The Sun JDK 1 5 has to be installed but has not to be made available in the PATH PATH for Windows environment variable The path to the JDK 1 5 can be set explicitly just for starting the MCAST module This allows having a JDK 1 4 2 installation being used as the default JVM for all other and especially EuQoS related applications If problems arise during the installation of two different JDKs JVMs especially concerning the default JVM being used by the system please contact Marc Brogle brogle iam unibe ch and Dragan Milic milic iam unibe ch for further support The installation of the Sun JDK 1 5 and Ant 1 5 x are not described in this manual but instead their own specific installation manuals can be used directly Page 6 of 28 V1 0 1 EuQoS MCAST Installation Manual x i x O EU OS 3 Deployment packages The MCAST deployment and additional utility driver packages are available at the EuQoS FTP server This manual is r
22. rror creating shortcut C Dokumente und Einstellungen Administrator Startmen lPr Error creating shortcut C Dokumente und Einstellungen Administrator Startmen lPr Created uninstaller C Program Files OpenVPN Uninstall exe Completed Figure 4 8 Confirmation of copied files Page 11 of 28 V1 0 1 EuQoS MCAST Installation Manual ty x EU OS 9 Finish the installation by clicking on Finish iik OpenVPN 2 0 9 Setup Completing the OpenVPN 2 0 9 Setup Wizard Open PN 2 0 9 has been installed on your computer Click Finish to close this wizard Show Readme Figure 4 9 Finishing the installation 10 After the TAP driver has been successfully installed via the OpenVPN installer the new vir tual network interface has to be configured see Section 4 2 Gerate Manager Datei Aktion Ansicht e EA PARA a BROGLE FC30DLS3 F Anschl sse COM und LPT Audio video und Gamecontroller w Batterien 4 Computer Diskettencontroller 4 Diskettenlaufwerke gt DYD CD ROM Laufwerke Grafikkarte IDE ATA ATAPI Controller Se Laufwerke M use und andere Zeigeger te BB Netzwerkadapter ES BA VMware Accelerated AMD PCNet Adapter Prozessoren SCSI und RAID Controller N Systemger te Tastaturen gt USB Controller Figure 4 10 Successful installation of the TAP interface Page 12 of 28 V1 0 1 EuQoS MCAST Installation Manual 4 2
23. software you must agree to the terms of the software license agreement Click Agree to continue or click Disagree to cancel the installation Disagree Agree Figure 4 19 Accepting the Software License Agreement 7 Select a destination the boot hard drive and click on Continue 0 00 Install tun tap driver Select a Destination Select a destination volume to install the tun tap driver Introduction software License Select Destinatio nstallation Type nstall Macintosh HD Finish Up 111GB 14 5GB Free You have chosen to install this software on the volume Macintosh HD Go Back Continue Figure 4 20 Installation destination selection Page 17 of 28 V1 0 1 EuQoS MCAST Installation Manual 8 Click on Install fresh install or Upgrade update existing to start the installation 80080 Install tun tap driver Easy Install on Macintosh HD Introduction Click Upgrade to perform a basic installation of this software package on the volume Macintosh License Select Destinatio HD Installation Type Install Finish Up Customize GoBack Upgrade Figure 4 21 Start the installation 9 Authenticate root rights required yourself and click on OK Authenticate Installer requires that you type your password 8 a ET a v Name Marc Brogle Password esesseseeel Details Figure 4
24. ssage received through multicast socket hostname x x x x is alive will show on the test applica tion that has been just started as well as on the instance of the test application is running on the master node where hostname will be the host s name and x x x x will be the IP address of the host where the second application has been launched e If you run the application on additional machines where MCAST is already running and connected to the master node the message is alive will show on all previously started and active test applications running on other hosts including the master node A successful test of MCAST with two instances would look e g as follows c C WINDOWS system32 cmd exe test mcast bat C eugos p4 mcast gt ocd client C eugos p4 mcast c lient gt java jar client jar 0 08 2007 86 66 29 org apache axis utils JavaUtils isAttachmentSupported WARNUNG Unable to find required classes javax activation DataHandler and javax mail internet MimeMultipart gt Attachment support is disabled received trough multicast socket brogle fc38d1s3 172 308 1 18 is alive received trough multicast socket LENOUO BE3FAEES 1A 3 H 3 is alive Figure 6 3 Successful test of MCAST with two instances Page 24 of 28 V1 0 1 EuQoS MCAST Installation Manual EU a OS Ky Aaja 7 Example code for using QoS enabled MCAST DummyClient In this Section we present the source code of the test application used in
25. uuesssssssnnnunssssnssnnnensnnnse 6 3 DEPLOYMENT PACKAGES Gr nein nie 7 4 INSTALLATION AND CONFIGURATION OF TAP 000000000000ss0u00000000000000000000u0000 000000000000 00000 0000000000000 8 4 1 INSTALLATION OF TAP UNDER WINDOWS er een ee smee nee dees ee Een Ge Se ee 8 42 CONFIGURING OF TAP UNDER WINDOWS zen oe se he oe se ke ede ke ee ee ke eg Ee oe GE 13 453 INSTALLATION OF TAP UNDER MAC OS X en Veen as Bed ses ese sk ees ee ee ee ie RE ee de ke is GE oe 14 Ae CONFIGURING OF LAP UNDER MACOS ea een 20 4 5 INSTALLATION OF TAP UNDER LINDE iese Gees de oe Ge Gee ee oe Ge be Ge ee Ge ee Ge ee ee ee ee ee duces 20 AG CONFIGURING OF LAP UNDER LINUX esse ee ee Ge ie ese ee Ede ee 20 3 INSTALLING AND CONFIGURING MCAST anna 21 SL DREI REM AST ee ee AE NE RE N N EE 21 32 SEONEIGURING NIC ST een 21 6 STARTING AND TESTING MCAST INSTALLATION 220000000s00000000000000000000000000000 000000000000 00000 000000 22 6 1 STARTING MCAST INSTALLATION UNDER LINUX OR MAC OS Mees s ss ees ese ee ee ee ee ee ee ee ee ee ee ee ee ee RE ee ee ee ee ee 22 6 2 STARTING MCAST INSTALLATION UNDER WINDOWS sees sesse sees sesse sesse ees ee ee ee es ee ee 23 63 TESTING ME AS TINS TALIA TION sesse on GR Re GE ee ee ie lok ER Ge r EN Gee Ge nip aar Gee ee GN ERGER Ee 24 7 EXAMPLE CODE FOR USING QOS ENABLED MCAST DUMMYCLIENT 0000000000000000000 25 8 TROUBLESHOOTING sicritaria Gee Gee ee ee ee Ge Oe ee Ge Ge Ee ee Gede Ee eN ee ek es ie 27 8 1 MCAST I
26. vigate the menu lt Enter gt selects submenus gt Highlighted letters are hotkeys Pressing lt Y gt includes lt N gt excludes lt M gt modularizes features Press lt Esc gt lt Esc gt to exit lt gt for Help lt gt for Search Legend built in excluded lt M gt module lt gt N twork device support ummy net driver support onding driver support QL serial line load balancing support lt M gt Universal TUN TAP device driver support eneral Instruments Surfboard 1000 RCnet devices gt HY device support gt thernet 10 or 100Mbit gt thernet 1000 Mbit gt lt Exit gt lt Help gt Figure 4 25 TAP support for the Linux kernel 4 6 Configuring of TAP under Linux No configuration is required for TAP under Linux restart the system if you recompiled the kernel Page 20 of 28 V1 0 1 EuQoS MCAST Installation Manual U A K O S y 5 Installing and configuring MCAST The following subsections will describe the installation and configuration of the MCAST module Please note that the MCAST version provided at the moment will take the QoS requests from ap plications but will actually not perform the corresponding EuQoS reservations This will ease the development of EuQoS MCAST aware applications using Multicast QoS reservations without re quiring a fully working EuQoS environment 5 1 Installing MCAST To install MCAST unzip the archive mcast_v4 0 4 zip downloa
27. xml 7328 main INFO com opensymphony xwork2 config providers xmlConfigurationProvider Parsing configuration file struts plugin xml 7387 main INFO com opensymphony xwork2 config providers XmlConfigurationPprovider Parsing configuration file struts xml 7397 main INFO org apache struts2 config BeanSelectionProvider Loading global messages from translation 7453 main INFO org apache struts2 spring StrutsSpringObjectFactory Initializing Struts Spring integration 7454 main INFO com opensymphony xwork2 spring SpringObjectFactory Setting autowire strategy to type 7454 main INFO org apache struts2 spring StrutsSpringObjectFactory initialized Struts Spring integration successfully 7673 main INFO com opensymphony xwork2 util ObjectTypeDeterminerFactory Setting DefaultObjectTypeDeterminer as default 7903 main WARN org apache axis utils JavaUtils Unable to find required classes javax activation DataHandler and javax mail internet MimeMultipart Attachment support is disabled 8057 main INFO org mortbay log Started SelectChannelConnector 0 0 0 0 8090 adding route 224 0 0 251 gt TapInterface tap0 exists false connecting to mm cnds unibe ch 130 92 70 46 2222 new peer connection local 130 92 65 55 64799 remote mm cnds unibe ch 130 92 70 46 2222 adding route 224 0 0 251 gt PeerConnection local 130 92 65 55 64799 remote mm cnds unibe ch 130 92 70 46 2222 exists false connected to mm c
28. xt gt to continue the installation Ak OpenVPN 2 0 9 Setup Welcome to the OpenVPN 2 0 9 Setup Wizard This wizard will guide you through the installation of Open PN an Open Source YPN package by James Yonan Note that the Windows version of OpenYPN will only run on Win 2000 XP or higher Figure 4 2 OpenVPN installer welcome screen Page 8 of 28 V1 0 1 EuQoS MCAST Installation Manual ts x EU OS y 3 Accept the license agreement by clicking I agree ik OpenVPN 2 0 9 Setup License greement Please review the license terms before installing OpenVPN 2 0 9 Press Page Down to see the rest of the agreement Open PN TM An Open Source YPN daemon Copyright C 2002 2005 Open PN Solutions LLC lt info openypn net gt This distribution contains multiple components some of which Fall under different licenses By using OpenVPN or any of the bundled components enumerated below you agree to be bound by the conditions of the license for each respective component Open PN trademark IF vou accept the terms of the agreement click I Agree to continue You must accept the agreement to install OpenVPN 2 0 9 Figure 4 3 License agreement of OpenVPN 4 Select only TAP Win32 Virtual Ethernet Adapter and unselect all other options ilk OpenVPN 2 0 9 Setup Choose Components Choose which Features of OpenVPN 2 0 9 you want to install Select the components to install upgrade Stop an
29. y penYPN processes or the Open PN service if it is running All DLLs are installed locally Select components to install OpenvPN File Associations OpenSSL DLLs _ Openssl Utilities TAP Win32 Virtual Ethernet Adapter Add OpenVPN to PATH Add Shortcuts to Start Menu Description Space required 115 0KB Figure 4 4 Selection of installation components Page 9 of 28 V1 0 1 EuQoS MCAST Installation Manual ty x EU OS y 5 Select the installation path and click on Install iik OpenVPN 2 0 9 Setup Choose Install Location Choose the folder in which to install OpenVPN 2 0 9 Setup will install OpenYPN 2 0 9 in the Following Folder To install in a different Folder click Browse and select another folder Click Install to start the installation Destination Folder C Program Files OpenvPN Space required 115 0KB Space available 4 6GB Figure 4 5 Selection of installation path 6 The installation will start to copy the drivers iik OpenVPN 2 0 9 Setup Installing Please wait while Open PN 2 0 9 is being installed TAP Win32 INSTALL tap0801 HERRRREERRRRERERRERE Output Folder C Program Files OpenYPNibir Extract tapinstall exe 100 Output Folder C Program Files OpenYPNidriver Extract OemWinzk inf 100 Extract tap0501 sys 100 tapinstall hwids returned 0 TAP Wins2 REMOVE OLD TAP No devices removed tapinstall remove TAP returned 0 No devices removed
30. your own application using MCAST are relative to the client subdirectory in the MCAST installation directory e lib euqos p3 axis 1 4 Jjar e lib ugos p3 axis jaxrpc 1 4 jar e lib ugos p3 axis schema 1 3 jar e lib eugos p3 axis wsdldj 1 5 1 jar e lib euqos p3 commons discovery 0 2 jar e lib euqos p3 commons interfaces 3 0 jar e lib eugos p3 commons logging 1 0 4 jar lib eugos p3 saaj ap 1 2 jar If you need further assistance in developing a skeleton and assemble the required libraries please contact Dragan Milic milic iam unibe ch for further support Page 26 of 28 V1 0 1 EuQoS MCAST Installation Manual an 8 Troubleshooting If you have problems with MCAST please have a look at the following subsections for a possible solution If you do not find an answer there please contact Marc Brogle brogle iam unibe ch and Dragan Milic milic iam unibe ch for assistance 8 1 MCAST is working but the application does not receive any IP multicast packets Problem MCAST is configured properly all hosts connect to the master peer and in the console of MCAST I can see that the connections are working and the multicast group joins are performed successfully Still my application does not receive the IP Multicast packets on the machine Solution If you are running Windows please make sure that the TAP interface has a unique IP address which 1s not used by any other host running
Download Pdf Manuals
Related Search