INSTALL.txt

   1 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.
   2
   3 Once you have completed the server configuration, a brief introduction to the SFA user tools is here:
   4     http://svn.planet-lab.org/wiki/SFAGuide
   5
   6 -----
   7 1) Install the SFA packages:
   8
   9 # yum install sfa-plc sfa-client
  10
  11 Note that the above command installs both sfa server (sfa-plc) and sfa client packages along with necessary dependency packages. Depending on the requirements, you may choose to install the appropriate one (server, client or both) for you. For e.g. to set up your own SFA server on top of your MyPLC, you need sfa-plc. On the other hand, if you plan to use an existing SFA server, you would typically need the sfa-client only.
  12 -------
  13 2) Note down the PLC_ROOT_USER, PLC_ROOT_PASSWORD, PLC_DB_USER and PLC_DB_PASSWORD of your MyPLC installation:
  14
  15 # plc-config-tty
  16 Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_USER
  17 PLC_ROOT_USER = root@test.onelab.eu
  18 Enter command (u for usual changes, w to save, ? for help) s PLC_ROOT_PASSWORD
  19 PLC_ROOT_PASSWORD = test++
  20 Enter command (u for usual changes, w to save, ? for help) s PLC_DB_USER
  21 PLC_DB_USER = pgsqluser
  22 Enter command (u for usual changes, w to save, ? for help) s PLC_DB_PASSWORD
  23 PLC_DB_PASSWORD = 4a333aba-a322-41b1-9c05-90b4f34d1332
  24
  25 These four configuration parameters are required for SFA server configuration
  26 -------
  27 3) Configure and start SFA servers:
  28
  29 (a) # sfa-config-tty
  30
  31  set SFA_PLC_USER               to     PLC_ROOT_USER
  32  set SFA_PLC_PASSWORD           to     PLC_ROOT_PASSWORD
  33  set SFA_PLC_DB_USER            to     PLC_DB_USER
  34  set SFA_PLC_DB_PASSWORD        to     PLC_DB_PASSWORD
  35 write and quit
  36
  37 *NOTE* at this point you get a warning b/c the authorities hierarchy has not been created yet; ignore
  38
  39 (b) # sfa-import-plc.py
  40
  41 (o/p will look like this)
  42 Import: creating top level authorities
  43 Hierarchy: creating authority: plc
  44 plc :
  45 Import: creating table for authority plc
  46 NOTICE:  table "sfa$plc" does not exist, skipping
  47   inserting authority record for plc
  48 Import: adding plc to trusted list
  49 Import_Site: importing site plc.internet2
  50 Hierarchy: creating authority: plc.internet2
  51   inserting authority record for plc.internet2
  52 Import_Site: importing site plc.pl
  53 Hierarchy: creating authority: plc.pl
  54   inserting authority record for plc.pl
  55 Import: importing person plc.pl.root
  56 Import: creating table for authority plc.pl
  57 NOTICE:  table "sfa$plc$pl" does not exist, skipping
  58
  59 (c)  run sfa-config-tty again and select q to come out of the config command
  60 This will initialize /etc/sfa/authorities/server.key from /etc/sfa/authorities/plc/plc.pkey
  61
  62 (d) # service sfa start
  63 This will start Registry, Slice Manager and Aggregate Manager. Your ps command output would look like:
  64
  65 # ps -ef | grep python
  66 root     24944     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -r -d
  67 root     24957     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -a -d
  68 root     24970     1  0 May11 ?        00:00:00 /usr/bin/python /usr/bin/sfa-server.py -s -d
  69 -------
  70 4) Configure SFA client:
  71
  72  (a) # mkdir ~/.sfi
  73  (b)copy your private RSA key to ~/.sfi/username.pkey Replace username with your actual account name.  NOTE: DSA KEYS WILL NOT WORK
  74  (c) # cp  /etc/sfa/sfi_config ~/.sfi/
  75  (d) edit ~/.sfi/sfi_config. A sample configuration looks like:
  76
  77         SFI_AUTH='plc.pl'
  78         SFI_USER='plc.pl.root'
  79         SFI_REGISTRY='http://vplc25.inria.fr:12345/'
  80         SFI_SM='http://vplc25.inria.fr:12347/'
  81
  82 ------
  83 5) Testing:
  84
  85 At this stage you should be able to run sfi command. Some sample outputs are:
  86
  87  (a) # sfi.py list plc.pl
  88      plc.pl.netflow (slice)
  89      plc.pl.sirius (slice)
  90      plc.pl.root (user)
  91      plc.pl.pif (node)
  92
  93  (b) # sfi.py show plc.pl.pif
  94      gid:
  95           hrn: plc.pl.pif
  96          uuid: 99878316891261700702442883738232624912
  97      hrn: plc.pl.pif
  98      type: node
  99      node_type: regular
 100      hostname: pif.inria.fr
 101
 102  (c) # sfi.py show plc.pl.root
 103        gid:
 104           hrn: plc.pl.root
 105          uuid: 67306954103472941609600457537601239401
 106      hrn: plc.pl.root
 107      type: user
 108      last_name: Administrator
 109      phone: None
 110      key: plc.pl.root#user
 111      first_name: Default
 112      email: root@vplc25.inria.fr
 113
 114  (d) # sfi.py slices
 115      plc.pl.netflow
 116      plc.pl.sirius
 117
 118  (e) # sfi.py resources
 119 <?xml version="1.0" ?>
 120 <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>
 121 ------
 122
 123 6) Federation configuration:
 124
 125 (a) Follow the same procedure to install and configure second MyPLC with SFA server.
 126 (b) On each PLC, edit the /etc/sfa/registries.xml file
 127
 128     set addr to ip or hostname of federated (remote) peer
 129     set port to sfa service port on federated (remote) peer
 130     set hrn to human readable name of federated (remote) peer interface
 131 Sample configuration:
 132
 133 <registries>
 134         <registry addr="vplc26.inria.fr" hrn="ple" port="12345"/>
 135 </registries>
 136
 137 (c) Likewise, edit the /etc/sfa/aggregates.xml
 138 Sampel configuration
 139
 140 <aggregates>
 141         <aggregate addr="vplc26.inria.fr" hrn="ple" port="12346"/>
 142 </aggregates>
 143
 144 (d) trade trusted root gid's (seen on /etc/sfa/trusted_roots)
 145 we have to copy the gid of first SFA server to the /etc/sfa/trusted_roots directory of second one and vice-versa.
 146