= MyPLC and SFA Evaluation =

The MyPLC software versions evaluated based on instructions from [http://svn.planet-lab.org/wiki/MyPLC PlanetLab MyPLC] page and using the [http://svn.planet-lab.org/wiki/MyPLCUserGuide MyPLC User Guide].

The SFA software versions evaluated based on instructions from [http://svn.planet-lab.org/wiki/SFAGuide PlanetLab SFA Guide]. Also reviewed the [http://svn.planet-lab.org/wiki/SFATutorial SFA Tutorial].

The BBN Internal instructions for [http://groups.geni.net/syseng/wiki/GAPI_Installation MyPLC and SFA] were reviewed 
as part of this evaluation. 

All evaluations were executed on Fedora 8 Systems.

Time frame: These evaluations took place from May 19 through June 2, 2010

= MyPLC and SFA Findings =

'''MyPLC Findings''' Not yet completed.

'''SFA Findings''' None.

'''BBN GENI API Findingings'''

The BBN Internal instructions for MyPLC and SFA required some clarification and all 
feedback was incorporated in the [http://groups.geni.net/syseng/wiki/GAPI_Installation GAPI_Installation] 
page:
 * Steps did not clearly identify what was being executed and why.
 * No clear distinction between user and admin actions, "Your account" used to describe either.
 * SFA prerequisites not fully captured. 

= MyPLC and SFA How-to = 

'''MyPLC How-to'''

1. Configured a !PlanetLab yum repo in /etc/yum.repos.d containing:
{{{
[myplc]
name= MyPLC
baseurl=http://build.planet-lab.org/planetlab/f8/pl-f8-i386-4.3-k22-latest/RPMS/
enabled=1
gpgcheck=0
}}}
2. Installed MyPLC:
{{{
$ sudo yum install myplc
}}}
3. Started MyPLC:
{{{
 $ sudo service plc start
}}}
4. Configured MyPLC:
{{{
$ plc-config-tty 
Enter command (u for usual changes, w to save, ? for help) u
== PLC_NAME : [ln plc2] 
== PLC_SHORTNAME : [lnplc2] 
== PLC_SLICE_PREFIX : [lnpl2] 
== PLC_ROOT_USER : [root@localhost.localdomain] 
== PLC_ROOT_PASSWORD : [root] 
== PLC_MAIL_ENABLED : [true] 
== PLC_MAIL_SUPPORT_ADDRESS : [lnevers@bbn.com] 
== PLC_DB_HOST : [128.89.91.23] 
== PLC_API_HOST : [128.89.91.23] 
== PLC_WWW_HOST : [128.89.91.23] 
== PLC_BOOT_HOST : [128.89.91.23] 
== PLC_NET_DNS1 : [128.33.0.20] 
== PLC_NET_DNS2 : [128.33.1.20] 
}}}
5. Start the plc server:
{{{
 $ sudo service plc start
}}}

You may now login as a root user.
[[Image(2010-07-22_myplc-1.jpg)]]

You may register a node from the left hand navigation Node-> Register Node.  This will kick off a 9 
steps procedure captured below:
[[Image(2010-07-22_myplc-node-0.jpg)]]

<<<NEED CAPTURE FOR ADDING NODE>>>





'''SFA How-to'''

In addition testing was completed using the [http://svn.planet-lab.org/wiki/SFAInstallationGuide PlanetLab SFA] instructions and with !PlanetLab resources, as captured below:

1. Configured a !PlanetLab yum repo in /etc/yum.repos.d containing:
{{{
[myplc]
name= MyPLC
baseurl=http://build.planet-lab.org/planetlab/f8/pl-f8-i386-4.3-k22-latest/RPMS/
enabled=1
gpgcheck=0
}}}
2. Installed SFI tools:
{{{
$ sudo yum install sfa-plc sfa-client

}}}

3. Configured SFA:
{{{
 $ sudo sfa-config-tty
 Enter command (u for usual changes, w to save, ? for help) u
 == SFA_INTERFACE_HRN : [plc.gpotest] 
 == SFA_REGISTRY_ROOT_AUTH : [plc.gpotest] 
 == SFA_REGISTRY_HOST : [localhost] 
 == SFA_AGGREGATE_HOST : [localhost] 
 == SFA_SM_HOST : [localhost] 
 == SFA_PLC_USER : [root@localhost.localdomain] 
 == SFA_PLC_PASSWORD : [root] 
 == SFA_PLC_DB_HOST : [localhost] 
 == SFA_PLC_DB_USER : [pgsqluser] 
 == SFA_PLC_DB_PASSWORD : [22f4a8bd-866b-4b0a-bd19-d28ce45a21b5] 
 == SFA_PLC_URL : [https://localhost:443/PLCAPI/] 
 Enter command (u for usual changes, w to save, ? for help) w
 Wrote /etc/sfa/configs/site.xml
 Merged
         /etc/sfa/default_config.xml
 and     /etc/sfa/configs/site.xml
 into    /etc/sfa/sfa_config.xml
 You might want to type 'r' (restart sfa), 'R' (reload sfa) or 'q' (quit)
 Enter command (u for usual changes, w to save, ? for help) q 
}}}

4. Copied my private key to the SFI configuration directory:
{{{
 $ mkdir ~/.sfi
 $ cp ~/.ssh/id_rsa ~/.sfi/lnevers.pkey
}}}

5. Creates sfi_config containing the following:
{{{
SFI_AUTH="plc.gpotest.gpolabln"
SFI_USER="plc.gpotest.gpolabln.root"
SFI_REGISTRY="http://localhost:12345"
SFI_SM="http://localhost:12347"
SFI_GENI_AM="http://localhost:12348"
}}}

6. Restart the SFA, import policy and start again:

{{{
$ sudo service sfa reload
$ sudo sfa-import-plc.py
$ sudo service sfa start
}}}

7. Verified the setup can be used:
{{{
 $ sfi.py list plc.gpotest.gpolabln
 plc.gpotest.gpolabln.aloria (node)
 plc.gpotest.gpolabln.test (slice)
 plc.gpotest.gpolabln.test2 (slice)
 plc.gpotest.gpolabln.root (user)
 plc.gpotest.gpolabln.lnevers (user)
 plc.gpotest.gpolabln.luisanevers (user)
}}}


''' BBN GENI API How-to'''

Using the instructions detailed at the [http://groups.geni.net/syseng/wiki/GAPI_Installation GENI API Installation] page,
installed, configured and ran both MyPLC and SFA installation on three separate Fedora 8 systems.  
Instruction issues were fed back and resolved in the GAPI_Installation web page, therefore they are 
not duplicated here.

Once installed according to the directions on GAPI_Installation page, was able to run the MyPLC and successfully register users and nodes.