We use the standard AM for now. NT.
[sfa.git] / INSTALL.txt
index 4bf0be4..b93abae 100644 (file)
@@ -1,4 +1,8 @@
 This installation note assumes that you have installed and configured MyPLC in the usual manner, and you have set up your yum repo like for a MyPLC install.
+
+Once you have completed the server configuration, a brief introduction to the SFA user tools is here:
+    http://svn.planet-lab.org/wiki/SFAGuide
+
 -----
 1) Install the SFA packages:
 
@@ -26,8 +30,8 @@ These four configuration parameters are required for SFA server configuration
 
  set SFA_PLC_USER              to     PLC_ROOT_USER 
  set SFA_PLC_PASSWORD          to     PLC_ROOT_PASSWORD
- set SFA_PLC_DB_USER                   to     PLC_DB_USER
- set SFA_PLC_DB_PASSWORD       to     PLC_DB_PASSWORD
+ set SFA_DB_USER               to     PLC_DB_USER
+ set SFA_DB_PASSWORD   to     PLC_DB_PASSWORD
 write and quit
 
 *NOTE* at this point you get a warning b/c the authorities hierarchy has not been created yet; ignore
@@ -59,23 +63,22 @@ This will initialize /etc/sfa/authorities/server.key from /etc/sfa/authorities/p
 This will start Registry, Slice Manager and Aggregate Manager. Your ps command output would look like:
 
 # ps -ef | grep python
-root     24944     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -r -d
-root     24957     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -a -d
-root     24970     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -s -d
+root     24944     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-start.py -r -d
+root     24957     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-start.py -a -d
+root     24970     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-start.py -s -d
 -------
 4) Configure SFA client:
 
  (a) # mkdir ~/.sfi 
- (b)copy your private key to ~/.sfi/username.pkey Replace username with your actual account name 
+ (b)copy your private RSA key to ~/.sfi/username.pkey Replace username with your actual account name.  NOTE: DSA KEYS WILL NOT WORK
  (c) # cp  /etc/sfa/sfi_config ~/.sfi/
  (d) edit ~/.sfi/sfi_config. A sample configuration looks like:
 
-       export SFI_AUTH=plc.pl
-       export SFI_USER=plc.pl.root
-       export SFI_REGISTRY=http://vplc25.inria.fr:12345/
-       export SFI_SM=http://vplc25.inria.fr:12347/ 
+       SFI_AUTH='plc.pl'
+       SFI_USER='plc.pl.root'
+       SFI_REGISTRY='http://vplc25.inria.fr:12345/'
+       SFI_SM='http://vplc25.inria.fr:12347/' 
 
- (e) # source ~/.sfi/sfi_config 
 ------
 5) Testing:
 
@@ -114,7 +117,7 @@ At this stage you should be able to run sfi command. Some sample outputs are:
 
  (e) # sfi.py resources
 <?xml version="1.0" ?>
-<Rspec duration="3600" start_time="1246736949"><networks><NetSpec duration="3600" name="plc" start_time="1246736950"><nodes><NodeSpec cpu_min="" cpu_pct="" cpu_share="" disk_max="" duration="" init_params="" name="pif.inria.fr" start_time="" type=""><net_if><IfSpec addr="138.96.250.224" init_params="" ip_spoof="" max_kbyte="" max_rate="" min_rate="" name="True" type="ipv4"/></net_if></NodeSpec></nodes></NetSpec></networks></Rspec>
+<RSpec duration="3600" start_time="1246736949"><networks><NetSpec duration="3600" name="plc" start_time="1246736950"><nodes><NodeSpec cpu_min="" cpu_pct="" cpu_share="" disk_max="" duration="" init_params="" name="pif.inria.fr" start_time="" type=""><net_if><IfSpec addr="138.96.250.224" init_params="" ip_spoof="" max_kbyte="" max_rate="" min_rate="" name="True" type="ipv4"/></net_if></NodeSpec></nodes></NetSpec></networks></RSpec>
 ------
 
 6) Federation configuration: