stop sfa service prior to uninstall
[sfa.git] / INSTALL.txt
1 ========== INSTALL
2 Assuming that you've set up your yum repo like for a myplc install,
3 you should be able to just
4
5 # yum install sfa-plc
6
7 ========== CONFIGURE
8
9 ---
10 Inspect your plc config:
11
12 [2009.06.09--1l-f8-32-vplc07] / # plc-config-tty 
13 Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_USER
14 PLC_ROOT_USER = root@test.onelab.eu
15 Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_PASSWORD
16 PLC_ROOT_PASSWORD = test++
17 ---
18 sfa-config-tty
19
20 * set GENI_PLC_USER             to PLC_ROOT_USER 
21 * set GENI_PLC_PASSWORD         to PLC_ROOT_PASSWORD
22 write and quit
23
24 *NOTE* xxx at this point you get a warning b/c the authorities hierarchy has not been created yet; ignore
25 ---
26 run gimport
27
28 [2009.06.09--1l-f8-32-vplc07] / # sfa-import-plc.py 
29 Import: creating top level authorities
30 Hierarchy: creating authority: plc
31 plc : 
32 Import: creating table for authority plc
33 NOTICE:  table "geni$plc" does not exist, skipping
34   inserting authority record for plc
35
36 --- 
37 run sfa-config-tty again - to initialize /etc/sfa/authorities/plc/plc.pkey
38
39 [2009.06.09--1l-f8-32-vplc07] / # sfa-config-tty 
40 Enter command (u for usual changes, w to save, ? for help) q
41                 /etc/sfa/authorities/server.key
42 copied from     /etc/sfa/authorities/plc/plc.pkey
43 ---
44
45
46 xxx tested this far xxx
47
48
49 Federation:
50 ===========
51 edit /etc/sfa/aggregates.xml and /etc/sfa/registries.xml  
52 * set addr to ip or hostname of federated peer
53 * set port to geni service port on federated peer
54 * set hrn to humarn readable name of federated peer interface
55
56 trade trusted root gid's (found in /usr/share/geniwrapper/geni/trusted_roots/) 
57
58 Run:
59 ====
60
61 First run:
62 # initialize the registry by running the registry import tool 
63 python sfa-import-plc.py
64
65 # start the services
66 service sfa start
67
68 or 
69
70 sfa-server.py -r -d
71 sfa-server.py -a -d
72 sfa-server.py -s -d
73
74
75 Use:
76 ==== 
77
78 Copy my private PL (RSA) ssh key to ~/.sfi/quetier.pkey
79
80 Copy /etc/sfa/sfi_config in ~/.sfi
81 edit  sfi_config
82
83 export SFI_AUTH=ple.upmc
84 export SFI_USER=$SFI_AUTH.quetier
85 export SFI_REGISTRY=http://138.96.255.199:12345/
86 export SFI_SM=http://138.96.255.199:12346/
87
88 source sfi_config
89
90 ./sfi.py list ple
91 ./sfi.py show ple.upmc.quetier