| 490 | |
| 491 | == Install Static ARP Tables for Experimental Topology == |
| 492 | |
| 493 | === Description === |
| 494 | |
| 495 | OpenFlow-based experimental topologies (see [wiki:OpenFlow/CampusTopology] for example topologies) often need hardcoded ARP entries on participating hosts. If your MyPLC PlanetLab hosts participate in such a topology, you may need to add static ARP entries. |
| 496 | |
| 497 | === Variables === |
| 498 | |
| 499 | || '''Variable''' || '''GPO Values''' || '''Description''' || '''Important Notes''' || |
| 500 | || `<script>` || `/root/install_geni_core_arp_entries.sh` || The script which is used to install the ARP entries || || |
| 501 | || `<arp_file>` || `/root/geni-core-arp.txt` || Config file containing hostnames, MAC addresses, and IPs of hosts || || |
| 502 | || `<arp_url>` || `http://www.gpolab.bbn.com/arp/geni-core-arp.txt` || Source URL containing the most recent version of `<arp_file>` || || |
| 503 | |
| 504 | === Reference === |
| 505 | |
| 506 | To configure static ARP installation on your system, and to ensure ARP entries are installed after each system boot, follow these steps. |
| 507 | |
| 508 | On each PlanetLab node in your MyPLC installation: |
| 509 | |
| 510 | 1. Get the ARP installation shell script (e-mail `gpo-infra@geni.net` if you do not have this script), install it as `<script>`, and make sure it is executable: |
| 511 | {{{ |
| 512 | sudo chown root <script> |
| 513 | sudo chmod a+x <script> |
| 514 | }}} |
| 515 | |
| 516 | 2. Download the most recent version of the ARP entries config file into `/root`, where `<script>` expects it to be: |
| 517 | {{{ |
| 518 | sudo wget -O <arp_file> <arp_url> |
| 519 | }}} |
| 520 | |
| 521 | 3. Run the script right away to seed the ARP entries. This is just: |
| 522 | {{{ |
| 523 | sudo <script> |
| 524 | }}} |
| 525 | and you can verify that ARP entries have been added by looking at the arp table, which should now contain many entries: |
| 526 | {{{ |
| 527 | arp -a |
| 528 | }}} |
| 529 | |
| 530 | 4. Configure the local system startup script to add ARP entries every time the system boots. GPO infra has an `/etc/rc.local` script which can be used to configure ARP entries after nodemanager successfully runs for the first time (and brings up secondary interfaces configured by PLC). Install this script as `/etc/rc.d/rc.local`, and ensure it is executable: |
| 531 | {{{ |
| 532 | sudo chown root /etc/rc.d/rc.local |
| 533 | sudo chmod a+x /etc/rc.d/rc.local |
| 534 | }}} |