| 1 | = NodeHandler FAQ = |
| 2 | |
| 3 | Here you can find the answer to some of the most frequently asked questions about !NodeHandler. If you have a question not answered by this page you can ask it on the MailingList. |
| 4 | |
| 5 | Questions answered in seperate pagess: |
| 6 | * [wiki:NodeHandler/FAQ/HowToControlNodes How to control nodes?] |
| 7 | * [wiki:NodeHandler/FAQ/ToCreateDebianPackage Which Tools are needed to create a debian package?] |
| 8 | * [wiki:NodeHandler/FAQ/ToUseNoiseGenerator How to Use Noise Generator in experiments?] |
| 9 | * [wiki:NodeHandler/FAQ/SandBoxConvention Sandbox IP convention?] |
| 10 | * [wiki:NodeHandler/FAQ/ProgrammingNodeID How to Program a Node ID box?] |
| 11 | |
| 12 | == How to check the status of my experiment? == |
| 13 | |
| 14 | Point your browser to http://remote.orbit-lab.org:4000/xml |
| 15 | |
| 16 | == How do I log into a node to see what is happening? == |
| 17 | |
| 18 | From remote.orbit-lab.org, you can use the serial console access provided by CM as follows |
| 19 | |
| 20 | telnet 10.1.x.y 3025 |
| 21 | |
| 22 | == How do I check the status of the imaging process? == |
| 23 | |
| 24 | Point your browser to http://remote.orbit-lab.org:4000/progress |
| 25 | |
| 26 | == How to interpret the progress bar? == |
| 27 | |
| 28 | INFO exp: Progress: 30/45/60 min/avg/max (84.571326) |
| 29 | |
| 30 | For the imaging process, this means that slowest node is 30% done and fastest node is 60% done |
| 31 | The average might require an additional explanation. |
| 32 | |
| 33 | INFO exp: Progress: 90/85/100 min/avg/max (234.240859) |
| 34 | |
| 35 | The average is calculated as the progress over ALL nodes, while the min/max |
| 36 | are for the nodes which have started frisbee already. In the above case, a |
| 37 | few nodes hadn't booted up yet. |
| 38 | |
| 39 | == Where are the noise antennas located? == |
| 40 | |
| 41 | * Antenna 1: Between node2-1 and node2-2 |
| 42 | * Antenna 2: Between node2-7 and node2-8 |
| 43 | * Antenna 3: Between node7-1 and node7-2 |
| 44 | * Antenna 4: Between node7-7 and node7-8. |
| 45 | |
| 46 | [Kishore] |
| 47 | |
| 48 | == Where can I find information about the wireless cards used in Orbit == |
| 49 | |
| 50 | Please look at the madwifi driver for atheros cards, the ipw2200 driver |
| 51 | for Intel cards and related documentation online. I believe the |
| 52 | model no. for atheros cards is AR5212. [Kishore] |
| 53 | |
| 54 | == Which interface is which? == |
| 55 | |
| 56 | For Atheros based nodes, ath1 is near the power supply, ath0 is near the serial port |
| 57 | For Intel based nodes, eth3 is near the power supply, eth2 is near the serial port |
| 58 | |
| 59 | == It seems that Node[5,6] cannot receive any packet from Node[7,4] == |
| 60 | |
| 61 | If you assign the netmask in the script to be 255.255.255.0 it filters out |
| 62 | all nodes but something1.something2.somethin3.x. If you assign 255.255.0.0 all the nodes on the grid are on the same subnet. [Haris] |
| 63 | |
| 64 | == When I run 'ntpdate ntpservername' on a node, I got an error that the ntp port is used already. == |
| 65 | |
| 66 | The nodes run ntpd as a service which occupies the port and hence you get the error when you try to manually run ntpdate. You could disable ntpd, run ntpdate manually and then enable ntpd again to overcome the slight drifts. [Sachin] |
| 67 | |
| 68 | == Interpreting error messages == |
| 69 | === Error message === |
| 70 | FATAL run: Exception: Can't switch off node ALL:ALL (#<Net::HTTPServerError:0xb7be7ce4>) RuntimeError |
| 71 | /tmp/eee.972/lib/handler/cmc.rb:46:in `nodeOff' |
| 72 | |
| 73 | Fix: CMC service is not running (or dead), need to restart CMC service |
| 74 | |
| 75 | == Where can I find out more about the schema used in the Orbit database? == |
| 76 | Is this some thing I design myself for my own purposes or is there some |
| 77 | previously designed schema that everybody uses? How does one experiment |
| 78 | code write stuff to the database, or does this happen automatically? |
| 79 | |
| 80 | ORBIT Services will create ONE database (same name as |
| 81 | experiment ID) per experiment. However, the database may contain multiple tables. One for |
| 82 | each application/configuration used in the experiment and - soon, but not |
| 83 | yet - an experiment specific table containing all the experiment related |
| 84 | information. |
| 85 | |
| 86 | Each application (in the definition file) tells nodehandler what is needs as |
| 87 | inputs and what are the statistics it will report. Accordingly nodehandler instructs the oml grid service to create a table in the |
| 88 | database with the appropriate schema. |
| 89 | |
| 90 | |
| 91 | The database schema for the receiver side information is as follows |
| 92 | Where rcvd_pkt_size_sample_sum = throughput |
| 93 | |
| 94 | |
| 95 | || Field || Type || |
| 96 | |
| 97 | || node_id || varchar(32) || |
| 98 | || sequence_no || int(11) || |
| 99 | || timestamp || int(11) || |
| 100 | || stream_no || int(11) || |
| 101 | || pkt_seqno || int(11) || |
| 102 | || sender_port || int(11) || |
| 103 | || flow_no || int(11) || |
| 104 | || pkt_num_rcvd || int(11) || |
| 105 | || rcvd_pkt_size_sample_sum || int(11) || |
| 106 | || rx_timestamp || int(11) || |
| 107 | || rssi || int(11) || |
| 108 | || xmitrate_sample_mean || float || |
| 109 | |
| 110 | |
| 111 | |