| 572 | | |
| 573 | | |
| 574 | | == Install Static ARP Tables for Experimental Topology == |
| 575 | | |
| 576 | | === Description === |
| 577 | | |
| 578 | | 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. |
| 579 | | |
| 580 | | === Variables === |
| 581 | | |
| 582 | | || '''Variable''' || '''GPO Values''' || '''Description''' || '''Important Notes''' || |
| 583 | | || `<script>` || `/root/install_geni_core_arp_entries.sh` || The script which is used to install the ARP entries || || |
| 584 | | || `<arp_file>` || `/root/geni-core-arp.txt` || Config file containing hostnames, MAC addresses, and IPs of hosts || || |
| 585 | | || `<arp_url>` || `http://www.gpolab.bbn.com/arp/geni-core-arp.txt` || Source URL containing the most recent version of `<arp_file>` || || |
| 586 | | |
| 587 | | === Reference === |
| 588 | | |
| 589 | | To configure static ARP installation on your system, and to ensure ARP entries are installed after each system boot, follow these steps. |
| 590 | | |
| 591 | | On each PlanetLab node in your MyPLC installation: |
| 592 | | |
| 593 | | 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: |
| 594 | | {{{ |
| 595 | | sudo chown root <script> |
| 596 | | sudo chmod a+x <script> |
| 597 | | }}} |
| 598 | | |
| 599 | | 2. Download the most recent version of the ARP entries config file into `/root`, where `<script>` expects it to be: |
| 600 | | {{{ |
| 601 | | sudo wget -O <arp_file> <arp_url> |
| 602 | | }}} |
| 603 | | |
| 604 | | 3. Run the script right away to seed the ARP entries. This is just: |
| 605 | | {{{ |
| 606 | | sudo <script> |
| 607 | | }}} |
| 608 | | and you can verify that ARP entries have been added by looking at the arp table, which should now contain many entries: |
| 609 | | {{{ |
| 610 | | arp -a |
| 611 | | }}} |
| 612 | | |
| 613 | | 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: |
| 614 | | {{{ |
| 615 | | sudo chown root /etc/rc.d/rc.local |
| 616 | | sudo chmod a+x /etc/rc.d/rc.local |
| 617 | | }}} |
| 618 | | |
