DIMES Planner

1. DIMES Planner The DIMES Project Tel Aviv University October-2010

2. Agenda DIMES Website Planner Login Creating a new experiment - Wizard Creating a new experiment - XML Monitoring an experiment Experiments’ results Log in to DIMES database Using MySql

3. DIMES Website • http://www.netdimes.org • Main page: • Agent and measurements status • Agents’ geographical distribution • News and updates • Navigation menu: • Download the agent! • Browse the website • Access forums and support • Can be very helpful!

4. Planner Login • http://www.netdimes.org/Planner/login.jsp or • From navigation menu: • For Researchers • Plan a DIMES experiment

5. Planner Login Click on register to create a new account Fill in your details • Create a new user:

6. Planner Login • Main Page: • Top menu – navigate within planner • DIMES Planner FAQ • Top Menu • Welcome – return to main page • Manage experiments • Statistics / Results • Personal details • Admin planner – For DIMES team only

7. Planner Login • Main Page:

8. Creating a wizard experiment Select “Create a new experiment”

9. Creating a wizard experiment Provide a UNIQUE Experiment name Desrcibe the experiment (Required for experiment approval)

10. Creating a wizard experiment • Select “Edit Details” on the manage experiments page • Edit test properties Click to continue

11. Creating a wizard experiment Define measuring agents Define destination targets

12. Creating a wizard experiment Name of a new agents group Number of agents in the group Agents are automatically selected based on a given condition: Select agent condition Submit agents group

13. Creating a wizard experiment Name of a new destinations group Number of IPs in the group Method of IP selection Logical selection is as with agents. Fixes selection: : Single destination IP address to add Copy-paste IP addresses from atext editor List of added IP addresses

14. Creating a wizard experiment

15. Creating a wizard experiment Match source to destination group by selecting (selection will be highlighted):

16. Creating a wizard experiment • Experiment is ready! • Press “submit” on “Manage Experiments” page. • Experiment will be review and approved by the DIMES team • Required in order to avoid abuse • Control agent resources • Once an experiment is approved, it’s status will change to “Running”

17. Creating a wizard experiment Name of a new agents group Number of agents in the group Agents are automatically selected based on a given condition: Select agent condition Submit agents group

18. Creating XML experiment Select “Create a new experiment using XML file”

19. Creating XML experiment Copy + Paste your xml file into the blank text area and press submit: Press DTD to see file format

20. Creating XML experiment Scrolling down the page: Example XML files Additional Instructions

21. Creating XML experiment <?xml version="1.0"?> <DIMES_experiment> <generalProperties protocol="UDP" operation="TR"> <name> planner_xml_12-3-10 </name> <description>Example of using an XML to create an experiment </description> </generalProperties> <groups> <agents> <logicalGroup name="Agents1" max="10“> <conditions> <condition param="LastAccess" relation="undefined"> <values>10</values> </condition> </conditions> </logicalGroup> </agents> <dests> <fixedGroup name="Agents1" max="10"> 194.90.1.5 132.66.48.2 209.85.135.104 </fixedGroup> </dests> </groups> <mapping> <mapItem agentsGroup="Agents1" destsGroup="Agents1" /> </mapping> </DIMES_experiment> :

22. Creating XML experiment • After submitting: • Will get a success message if the experiment was written correctly • A copy of the experiment will be mailed to you • Will get an error message if there was a mistake in the XML file • Manage Experiments page: • Review and change the experiment • Submit the experiment when ready • From here on, identical to a Wizard experiment

23. Monitoring an experiment • First option: • Manage Experiments page • Click on an experiment’s “View details” • Click on “View experiment history log” • Observe the experiment’s progress • Check and verify that it makes a progress!

24. Monitoring an experiment • Second option: • Statistics/Results page • Click on an experiment’s “More details” • Observe the experiment’s progress • Check and verify that it makes a progress!

25. Experiment’s Results • Access • Statistics/Results page • Click on an experiment’s “More details” • Request results file: • Raw results / Traceroutes / Pings / etc. • Will be sent via mail • Results are also added to DIMES main tables

26. Log In to DIMES DB • Accessing DIMES DB requires to open a tunnel to TAU servers • Use Putty • http://www.chiark.greenend.org.uk/~sgtatham/putty/ • Required configuration: • Host name: gp.tau.ac.il • Under connections  SSH  Tunnels • Need to be configured for each database • Source port: <N> (example: 5551) • Destination: b<n>. evergrow.iucc.ac.il:3306 • Example: b1.evergrow.iucc.ac.il:3306 • Press Add! • Save! • Use your TAU user and password to log in

27. Log In to DIMES DB

28. Logging In to DIMES DB

29. MySql Access • DIMES database is MySql based • Use MySql workbench  SQL Development • Formerly MySql Query Browser • Database access: • Localhost:<port number> • Example: localhost : 5551 / 127.0.0.1 : 5551 • Configured under “New Connection” or “Manage Connections” • User: • codeLimited • Can only read • Write under DIMES_PLAYGROUND schema only

30. MySql Access

31. MySql Access

32. MySql Access • Running MySql queries: • Read at http://www.mysql.com/ • Select forst the Schema • The most basic query: • Select * from Table_name; • Basic Format: • Select <fields name> from <table names> where <conditions>group by <field name> order by <field name> limit <results number>; • Example: Select sourceAs, SourceIP, DestAs, DestIP from IPEdgesMedianTbl where SourceAs=DestAs order by sourceIP limit 10; • Many more query types and features!

33. MySql Access