revamped sfa impl doc

[sfa.git] / INSTALL.txt

diff --git a/INSTALL.txt b/INSTALL.txt
index 144af0f..7718165 100644 (file)
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,34 +1,54 @@
-Dependencies:
-=============
-make
-gcc
-openssl-devel/libssl-dev
-pyOpenSSL >= 0.7
-m2crypto
+========== INSTALL
+Assuming that you've set up your yum repo like for a myplc install,
+you should be able to just
 
+# yum install sfa-plc
 
-Install:
-========
-cd geniwrapper/trunk
-make 
+========== CONFIGURE
 
+---
+Inspect your plc config:
 
-Configure:
-==========
-geni-config-tty
+[2009.06.09--1l-f8-32-vplc07] / # plc-config-tty 
+Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_USER
+PLC_ROOT_USER = root@test.onelab.eu
+Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_PASSWORD
+PLC_ROOT_PASSWORD = test++
+---
+sfa-config-tty
 
-or
- 
-edit /etc/geni/geni_config
-* set GENI_PLC_USER to PLC_MAINTENANCE_USER in /etc/planetlab/plc_config
-* set GENI_PLC_PASSWORD to PLC_MAINTENANCE_PASSWORD in /etc/planetlab/plc_config
+* set GENI_PLC_USER            to PLC_ROOT_USER 
+* set GENI_PLC_PASSWORD                to PLC_ROOT_PASSWORD
+write and quit
 
-copy authorities/ple/ple.pkey to geni/server.key
+*NOTE* xxx at this point you get a warning b/c the authorities hierarchy has not been created yet; ignore
+---
+run gimport
+
+[2009.06.09--1l-f8-32-vplc07] / # sfa-import-plc.py 
+Import: creating top level authorities
+Hierarchy: creating authority: plc
+plc : 
+Import: creating table for authority plc
+NOTICE:  table "geni$plc" does not exist, skipping
+  inserting authority record for plc
+
+--- 
+run sfa-config-tty again - to initialize /etc/sfa/authorities/plc/plc.pkey
+
+[2009.06.09--1l-f8-32-vplc07] / # sfa-config-tty 
+Enter command (u for usual changes, w to save, ? for help) q
+                /etc/sfa/authorities/server.key
+copied from     /etc/sfa/authorities/plc/plc.pkey
+---
+
+
+xxx tested this far xxx
 
 
 Federation:
 ===========
-edit /etc/geni/aggregates.xml and /etc/geni/registries.xml  
+edit /etc/sfa/aggregates.xml and /etc/sfa/registries.xml  
 * set addr to ip or hostname of federated peer
 * set port to geni service port on federated peer
 * set hrn to humarn readable name of federated peer interface
@@ -40,16 +60,16 @@ Run:
 
 First run:
 # initialize the registry by running the registry import tool 
-python gimport.py
+python sfa-import-plc.py
 
 # start the services
-/etc/init.d/geniwrapper start 
+service sfa start
 
 or 
 
-plc.py -r -d
-plc.py -a -d
-plc.py -s -d
+sfa-server.py -r -d
+sfa-server.py -a -d
+sfa-server.py -s -d
 
 
 Use:
@@ -57,14 +77,15 @@ Use:
 
 Copy my private PL (RSA) ssh key to ~/.sfi/quetier.pkey
 
-in cmdline
-edit  configSfi.sh
+Copy /etc/sfa/sfi_config in ~/.sfi
+edit  sfi_config
+
 export SFI_AUTH=ple.upmc
 export SFI_USER=$SFI_AUTH.quetier
 export SFI_REGISTRY=http://138.96.255.199:12345/
 export SFI_SM=http://138.96.255.199:12346/
 
-source configSfi.sh
+source sfi_config
 
 ./sfi.py list ple
 ./sfi.py show ple.upmc.quetier