Changes between Version 3 and Version 4 of GpoLab/MyplcNodeDataplaneInterfaces


Ignore:
Timestamp:
04/27/11 11:26:55 (13 years ago)
Author:
tupty@bbn.com
Comment:

gst 2032: updating patch section based on experiences with helping Clemson set up

Legend:

Unmodified
Added
Removed
Modified
  • GpoLab/MyplcNodeDataplaneInterfaces

    v3 v4  
    99=== Variables ===
    1010
    11 <version>: the target plifconfig version
     11|| '''Variable'''       || '''Description'''                            || '''Notes'''                    ||
     12|| <plifconfig-version> || The target plifconfig version                || Example: plifconfig-2.0        ||
     13|| <python-version>     || The version of python installed on your node || Examples: python2.5, python2.6 ||
     14|| <myplc-node>         || FQDN of a target MyPLC-based !PlanetLab node ||                                ||
    1215
    1316=== Set Up the Environment for VLAN Interfaces ===
     
    1821{{{
    1922cd ~
    20 tar xvzf /path/to/plifconfig-<version>.tar.gz
     23tar xvzf /path/to/<plifconfig-version>.tar.gz
    2124}}}
    2225
     
    2932 * Run the `add_vlan_tagtype_to_plc_db` script:
    3033{{{
    31 sudo ~/plifconfig-<version>/myplc/add_vlan_tagtype_to_plc_db
     34sudo ~/<plifconfig-version>/myplc/add_vlan_tagtype_to_plc_db
    3235}}}
    3336
    3437 * Confirm tagtype was added:
    3538{{{
    36 sudo ~/plifconfig-<version>/myplc/add_vlan_tagtype_to_plc_db -- -n
     39sudo ~/<plifconfig-version>/myplc/add_vlan_tagtype_to_plc_db -- -n
    3740echo $?
    3841}}}
     
    4043If '''1''' is printed out by the echo command then the VLAN tagtype was successfully added to the !PlanetLab database.
    4144
    42 ==== Apply the Patch on All Nodes ====
    43 
    44 In order to create VLAN interfaces on a node, you need to patch your plnet.py file.  This will need to be done on each !PlanetLab node associated with your MyPLC.
    45  * Copy the patch file to your nodes:
    46 {{{
    47 scp ~/plifconfig-<version>/nodes/plnet.patch root@<fqdn_of_node>:~/
    48 }}}
    49 
    50  * Login to the node as root
    51  * Create a copy of the original plnet.py, and keep it in your home directory for safe keeping:
    52 {{{
    53 cd /usr/lib/python2.5/site-packages/
    54 cp plnet.py ~/plnet.py.orig
    55 }}}
    56 
    57  * Still on the node as root, apply the patch:
    58 {{{
    59 cd /usr/lib/python2.5/site-packages/
    60 patch < ~/plnet.patch
    61 }}}
    62 
    63  * Restart !NodeManager on the node:
     45==== Apply the Patch to `plnet.py` File on All Nodes ====
     46
     47In order to create VLAN interfaces on a node, you need to patch your `plnet.py` file on '''each''' !PlanetLab node associated with your MyPLC.  The following instructions assume that your MyPLC machine has patch installed.
     48
     49 * Log into your MyPLC-based !PlanetLab node as root and make a backup of the existing `plnet.py` file
     50{{{
     51cp /usr/lib/<python-version>/site-packages/plnet.py ~/plnet.py.orig
     52}}}
     53
     54 * From your MyPLC machine, copy the `plnet.py` file over from your MyPLC-based !PlanetLab node.
     55{{{
     56scp root@<myplc-node>:/usr/lib/<python-version>/site-packages/plnet.py ~/
     57}}}
     58
     59 * Apply the patch from your patch machine:
     60{{{
     61patch ~/plnet.py < ~/<plifconfig-version>/nodes/plnet.patch
     62}}}
     63
     64 * If the patch succeeded, copy the newly patched file from your patch machine over to your MyPLC-based !PlanetLab node:
     65{{{
     66scp ~/plnet.py root@<myplc-node>:~/usr/lib/<python-version>/site-packages/
     67}}}
     68
     69 * Login to the MyPLC-based !PlanetLab node as root and restart !NodeManager:
    6470{{{
    6571service nm restart
    6672}}}
    6773
    68 ==== What if the patch didn't work? ====
     74==== What if the patch failed? ====
    6975If the patch did not work please let us know at gpo-infra@geni.net.
    7076