User Guide & Developer Guide for ATROSIM
Contents
1. A A 2 B B 1 Fix on screen Figure 7 Simulation Event Window and Property Window Figure 7 shows the combination of Windows gt Simulation Event and Windows gt Property Window to view the traffic flow and detail of an event In this picture the cycle orange and rectangle green represent Request and Response packages respectively These shapes are customized by the RIP protocol da Network Routing Protocol Simulator File Edit Simulation Windows Help 7 lal D Computer Router Sy Switch Connection Choose a subnet gt TT 1 Oo Ta mm mm Ly Position A 43 229 Figure 8 Simulation State Window Figure 8 shows the usage of Simulation State window The display format is defined by in this screen shot the RIP Wk Network Routing Protocol Simulator File Edit Simulation Windows Help A 0 0 0 0 A 0 0 0 0 A 0 0 0 0 B 0 0 0 0 6 0 0 0 0 A 0 0 0 0 C 0 0 0 0 B 0 0 0 0 salpadoi4 E Command Response Metric 0 E Table litem 0 A A 2 DestnationIP 0 0 0 0 DestinationNam A uJ Device Events ai Simulation State Ready Figure 9 Node State Window and Package Sniffer Window 3 Routing Protocol Plug in Developer Note Steps in create a routing protocol library Create a Class Library Project in Visual Studio 8 Add reference to assembly ATROSIM exe Add a class that implements interface ATROSIM Simulation RoutingProtocolController Add a class that implements interfa2. the Simulation Options displays Here you can choose options for the simulation We strongly suggest choosing Step by step simulation You can also click E Step by Step simulation on tool bar to turn on step by step simulation mode Go to menu Simulation gt Manage Protocols the Routing Protocol Manager window is displayed as in Figure 6 In this dialog you can see the list of available protocols o Click on Add Library to add a library dll containing routing protocol o Selecta protocol from the list box click on Activate button to make a protocol active o Click Configure to configure a protocol s parameters if the activated protocol supports this function a Routing Protocol Manager Protocol Manager This dialog allows you to manage Routing protocol add n library Active Protocol Available Prototols Name RIPv1 Library RIP Version 1 0 0 0 Culture neutral Pub Description RIP version 1 Configure Figure 6 Routing Protocol Manager Dialog Goto menu Simulation gt Start lt Protocol Name gt to begin simulation If you are in step by step simulation mode the simulation will pause after each step Once the simulation pauses you can see the package flow and state of each node by showing one or more following windows o Windows gt Package Sniffer F5 list of all packages in time order sent by the protocol and detail of a package o Windows gt Node State F6 view the newest routing table of selected compute
3. 1 InterfaceCount EO Interfaces E 0 ConnectorLocation IP MaxConnection Subnet SubnetMask A il ConnectorLocation IP MaxConnection Subnet SubnetMask 2 2 items Router1 192 166 1 2 7 192 168 1 2 1 192 168 1 0 192 168 0 0 192 168 1 0 192 168 2 0 1 192 168 2 0 The network that this device belong to Position A 4 0 107 diy Network Routing Protocol Simulator pa ole s File Edit Simulation Windows Help Hie a D Computer Router Qo Switch Connection 100 InterfaceCount 2 hra E Interfaces 2 items Routerd E 192 168 1 2 E 0 Router1 192 168 1 2 192 168 1 1 WO 192 168 2 1 ConnectorLocation Auto D 192 168 0 1 IP 192 168 1 2 MaxConnecton 1 Subnet 192 168 1 0 A Subnetmask zp El 1 192 168 1 0 ConnectorLocaton Computers W 192 168 2 2 MaxConnection Subnet 192 168 2 0 SubnetMask 295 255 2550 Subnet The network that this device belong to Position A 470 107 Figure 3 Specify properties of Router 1 Insert connection o Goto menu Edit gt Add Connection or click in tool bar Then click 2 devices to connect If target or source device has many interfaces then window New Connection appears as in Figure 4 You can select a source device s interface to connect to a target device s interface New Connection el Create Connection Create a new connection between two devices Source Device Interface com Tei Maat 1 F
4. Control ref to container of the control showOptionDialog Display a dialog allowing user to change protocol parameters Parameters TAppContext current running context generatePackageDescription Generate a short description for a package like the one display in Figure 7 Parameters TAppContext current running context StringBuilder where you add your description Package the package for generating description TABLE II MEMBERS OF IROUTINGPROTOCOL INTERFACE O MemberName OOOO O osin Called by the simulation engine when the protocol is being stopped receiveData Called when there is a package sent to this instance The call is made in a thread separated with that calls the run member Parameters filled by the caller MedialInterface specify which interface receives data T ae Package the package sent to this node EE Call by the underlying send routine to find out a suitable route Parameters filled by the caller HostIdentity the identity of the target in pair of name and IP address out uint filled by the callee to specify which interface IP used for sending package out HostIdentity filled by the callee to specify the next destination of sending package Return true ic route HOG otherwise return false been changed p Spa rea om RoutingTable of the protocol pe sere Raut ofthe preteen es aR We RoutingTable of the protocol ep Siren Steen ens when st fe spen
5. User Guide amp Developer Guide for ATROSIM Viet Hung Nguyen and Le Minh Sang Tran ngvhung minhsang3000 gmail com Introduction ATROSIM Another Tool for Routing Protocol Simulation is an elegant tool that supports simulation of routing protocol in a visual way This document is a user guide and protocol developer guide for ATROSIM 1 Main Features The main features of ATROSIM also referred to as Simulator a tool supporting visual routing protocol simulation are as following Create a network topology that contains switches nodes and computers end points by a user friendly graphical interface The topology can be saved to disk to later usage Specify the connection metric between nodes The metric could be in uni direction or bi direction Able to simulate different protocols o Each protocol is implemented as a separated library and will be plugged into the Simulator at runtime Protocol developers are able to define data structure for the internal state of each node Protocol developers are able to use their own message structure to exchange data between nodes Visualize simulation progress o Show internal state of each node o Show the input output messages of a node in a time line virtual time Oo Suspend Resume the routing progress at one or more nodes Visualize protocol reaction o Allow user to change topology at runtime to see protocol reaction 2 Application User guide The ATROSIM consists of two maj
6. belongs to Changing Subnet will change the IP and SubnetMask to appropriate values Determine how many connections are able to plug into an MaxConnection ag interface This value should not be greater than MaxConnection Perinterface For switch this value always equals 2147483647 PERN Determine traffic cost from Source to Target Null for disconnected Determine traffic cost from Target back to Source Null for ReverseCost 7 disconnection When SupportBiDirectionCost is false this value always equals Cost r i 3 a Legend topology document W computer e3 router D switch 5 interface connection o a EE a 2 1 2 Reuse document s network Every time you make a new file if you feel boring of going to Network Collection Editor window as in Figure 2 to create a collection of subnets before you can assign which router computer to which subnet Then Like From an existing file which already has collection of subnets Go to menu File gt Export document networks to save that collection of subnets file extension network When create a new file you can reuse that collection by going to menu File gt mport document Network Then you can click on hoose a subnet on tool bar to choose a particular subnet Later every new inserted router computer will be automatically assign the 1 interface to this particular subnet Protocol Simulation Go to menu Simulation gt Options
7. ce ATROSIM Simulation RoutingProtocol ee ae i Compile the project and enjoy If you want to customize the package shape see Figure 7 then 6 Add a class inherited from ATROSIM Simulation PackageEventRecord 7 Set the PackageEventType property of the ISimulationEngine to your class If you want to create your own event then 8 Add a class inherited from ATROSIM Simulation EventRecord 9 Use the ATROSIM Simulation Visualizer service to record your event The detail of IRoutingProtocolController and RoutingProtocol are described in TABLE II and TABLE III TABLE II MEMBERS OF IROUTINGPROTOCOLCONTROLLER O MemberName OOOO osin constants of type ProtocolFlag type InternalStateDisplayStyle createProtocolInstance Create an instance of protocol to run on a node Parameters TAppContext current running context RuntimeDevice the device that protocol runs on TSimulationEngine reference to the simulation engine createStateViewControl Create a control displaying specific state of a protocol Parameters Control reference to the container of the created control ProtocolState a specific state to view cloneStateViewControl Duplicate a control displaying specific state of a protocol based on an existed one createInternalStateViewControl Create a control displaying the internal state of a protocol Parameters TAppContext current running context TRoutingProtocol the protocol to be displayed
8. d Be simulation resume Called by the simulation engine when it tries to resume the Notice that all operations in the TRoutingProtocol interface are call back operations Therefore you should not make any direct call to them The protocol body can take advance of some useful services provided by the simulator which are listed in TABLE IV These services are acquired by the given running context For instance to get the TVisualizer service you can invoke Context getService lt IVisualizer gt TABLE IV SERVICES PROVIDED BY THE APPLICATION CONTEXT ISimulationEngine Provide access to the simulation engine Mostly use for internal operations However you may find some useful members for developing protocol here Provide means for developer to visualize the running of a protocol Allows protocol to emit message during its lifetime The usage of these services can be found out in an example of implementation of RIP
9. igure 4 New Connection window Edit connection cost select a connection go to menu Windows gt Object property or hot key F4 to show Property Window of the selected connection Then specify Cost ReverseCost of connection note that ReverseCost is different from Cost only in case SupportBiDirection True Result will be as in O D m S Routeri Computert 0 172 10 23 1 0 192 168 0 1 1 192 168 0 2 Figure 5 Network topology items and Connection Delete an item router computer go to menu Edit gt Delete or hot key Delete Save file menu File gt Save file extension is atrosim In general the following table shows common properties of a topology document and each kind of devices TABLE I LIST OF PROPERTIES APPLIED FOR NETWORK TOPOLOGY OBJECTS Property tones List of subnets in a document A Subnet has its own color that makes the topology easier to view MaxConnectionPerInterface The maximum number of connections for an interface CTO i y y O ShowIPAddress Show hide IP address below a device SupportBiDirectionCost z Determine whether this document support uni bi direction cost Type of a device prn eain Specify the number of interfaces of a device For switch this value InterfaceCount always equals one List of interfaces connected to a device PTR Determine the IP address of an interface Determine the Subnet mask of an interface Oa Pa a Determine which subnet a device
10. or a amp Color _ White f li etworks Collection Tite lt Untitled gt 3 Options MaxConnectionPerinterfi 1 NextDeviceName 3 ShowlPAddress True Suppor tBiDirection True N Area 1 Networks e a Area Fi Ready Position X 492 Y 158 Figure 1 Application Main Screen In Area 1 click Lal at Network Collection to open Network Collection Editor window as in Figure 2 Then Add a subnet and its parameters in the right side or Remove a subnet Then click OK O Network Collection Editor 192 168 1 0 192 168 2 0 192 168 3 0 192 168 4 0 192 168 5 0 192 168 6 0 192 168 7 0 192 168 8 0 192 9 0 t Subnet L System Drawing Bi 132 168 0 0 SubnetMask 299 255 255 0 Figure 2 Network Collection Editor window Insert new network device router computer switch o Goto menu Edit gt Add Computer Edit gt Add Router Edit gt Add Switch or click Ay 5 Q in the tool bar to insert new computer router switch Select a network device go to menu Windows gt Object property or hot key F4 to show Property Window of the selected item to specify item s properties such as interface count IP subnet as in dia Network Routing Protocol Simulator Sj s File Edit Simulation Windows Help a i E Ll D Computer Router Qy Switch Connection 100 Routerd 192 168 1 1 D 192 168 0 1 Computers 192 168 2 2 o Figure 3 ie ics ie D 192 168 2
11. or parts i Network topology editor and ii Protocol Simulation This part of the document gives an introduction about these functions The application needs to run on the Net 3 5 framework How to run the program Execute the file atrosim ATROSIM bin Debug ATROSIM exe Or view the source code by open the solution atrosim ATROSIM ATROSIM s n then you can build the solution project and run it inside the Visual studio 2 1 Network Topology Editor The Editor is a kind of Multi Documents Interface MDI editor that allows users to open many documents at the same time each document is displayed as a tab At startup no document is opened user then can open an existing document atrosim or create a new one 2 1 1 How to create a new network document Goto menu File gt New or click on iia in the tool bar Create subnet network Menu Windows gt Object property or hot key F4 to show Property Window of this network document as in Figure 1 We strongly suggest you to click on each property in Area 1 to see its description showed in Area 2 Network Routing Protocol Simulator _ O cide a File Edit Simulation Windows Help a eS ld A AD Computer 4 Router Q Switch amp Connection 100 Choose a subnet ial Step by Step simulation p Untitled x Properties ax ATROSIM Document NetworkDocument X Untitled m2 B Misc ee ieee Actvene gt rtd Auth
12. r router You can also see the internal state of the routing protocol running on this node ay o Windows gt Simulation State F7 view the routing table of all nodes in each step of the simulation o Windows gt Simulation Event F8 or Device Event view the events during the simulation By default when a package is sent receive a corresponding event is recorded The protocol can also generate its own event for instance when a node runs garbage collection in RIP You can click on the event to see its detail in the Windows gt Property Window F4 o Windows gt Console F9 displays all messages emitted during the simulation While the simulation is running you are able to change the network topology to see the protocol reaction for instance change connection cost add device and so on The following are some screen shots illustrating the usage of abovementioned windows These screen shots are from the simulation of RIP protocol on a document named test_rip atrosim This function is available when the simulating protocol gives support File Edit Simulation Windows Help ih E lal 4D Computer rag Router te Switch Connection Choose a subnet gt Direction EndTime RIP RIP Comma Response Metic 0 BEAN tems 0 AA 2 1 B 8 1 Destinato 0 0 0 0 Destinato B ID 6 Protocol TCP Routingly IP SourcelP 0 0 0 0 SourceNar C TTL 0 State 0 Time 347022 Go Event information 6 received from C cost 1 Response Table
Download Pdf Manuals
Related Search