small updates to generated login base and site name for geni users
[sfa.git] / INSTALL.txt
index 840a307..d748883 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:
 
@@ -52,8 +56,10 @@ Import: importing person plc.pl.root
 Import: creating table for authority plc.pl
 NOTICE:  table "sfa$plc$pl" does not exist, skipping
 
-(c) # service sfa start
+(c)  run sfa-config-tty again and select q to come out of the config command
+This will initialize /etc/sfa/authorities/server.key from /etc/sfa/authorities/plc/plc.pkey 
 
+(d) # service sfa start
 This will start Registry, Slice Manager and Aggregate Manager. Your ps command output would look like:
 
 # ps -ef | grep python
@@ -64,16 +70,15 @@ root     24970     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-ser
 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:
 
@@ -112,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: