portal/templates/onelab/onelab_manual-delegation.html

   1 {% extends "layout.html" %}
   2
   3 {% block content %}
   4
   5 <div class="col-md-8">
   6         <br>
   7         <h2>Manual Delegation</h2>
   8         <h3>Install SFA</h3>
   9
  10         <p>
  11                 In order to delegate your credentials to the OneLab portal, you need to install SFA tools.<br>
  12         </p>
  13         <p>
  14                 <strong>[Requirement: python 2.7 or higher]</strong>
  15         </p>
  16         <h4>For Mac and Linux</h4>
  17         <p class="command">
  18                 $ sudo easy_install pip<br>
  19                 $ sudo pip install sfa
  20         </p>
  21         <h4>For Windows</h4>
  22         <p>Please download <a target="_blank" href="https://bootstrap.pypa.io/get-pip.py">get-pip.py</a></p>
  23         <p class="command">
  24                 $ python get-pip.py<br>
  25                 $ pip install sfa
  26         </p>
  27
  28         <p>
  29         To get more information about pip, please visit: <a target="_blank" href="https://pip.pypa.io/en/latest/installing.html">https://pip.pypa.io/en/latest/installing.html</a>
  30         </p>
  31         <p>
  32         More details about SFA is available at the following address:
  33         <a target="_blank" href="http://svn.planet-lab.org/wiki/SFATutorialInstall#installingthroughpipfromPyPI">Installing SFA</a>
  34         </p>
  35
  36         <h3>Configuring SFA</h3>
  37
  38         <p>
  39                 Once SFA tools are successfully installed, you need to configure the SFA client aka SFI
  40         </p>
  41         <p class="command">
  42                 $ mkdir ~/.sfi <br>
  43                 $ cd ~/.sfi <br>
  44                 $ cp ~/.ssh/id_rsa ~/.sfi/user-hrn.pkey
  45         </p>
  46
  47         <p>
  48                 Here, 'user-hrn' is your SFA hrn. If e.g., your OneLab account email is mohammed-yasin.rahman at upmc.fr, then your user-hrn is <b><i>'onelab.upmc.mohammed-yasin_rahman'.</i></b></p>
  49         <p>
  50                 In this example, a user-hrn is built using the root authority i.e, <b><i>'onelab'</i></b> followed by a <b>'.'</b> then the sub authority i.e., <b><i>'upmc'</i></b>
  51                 followed by a <b>'.'</b> and then the last fragment in the hrn is made of the local part of your email adress i.e., <b><i>'mohammed-yasin_rahman'</i></b>
  52                 (with dots replaced with underscores).
  53         </p>
  54
  55         <p>
  56                 Next, you will setup your ~/.sfi/sfi_config. The following represents the sfi_config file for a OneLab user:
  57         </p>
  58
  59         <p class="command">
  60                 [sfi]<br>
  61                 auth = onelab.upmc<br>
  62                 user = onelab.upmc.mohammed-yasin_rahman<br>
  63                 registry = http://portal.onelab.eu:6080/<br>
  64                 sm = http://sfa3.planet-lab.eu:12346/<br>
  65         </p>
  66
  67         <p>
  68                 Here again, <b><i>'user'</i></b> is your user-hrn, and <b><i>'auth'</i></b> is the authority that you belong to, in most cases you should just drop the last part of your hrn.
  69         </p>
  70         <p>
  71                 Add the the following to sfi_config for delegating credentials to OneLab portal:
  72         </p>
  73         <p class="command">
  74                 [myslice]<br>
  75                 <br>
  76                 backend  = http://portal.onelab.eu:7080<br>
  77                 delegate = onelab.myslice<br>
  78                 platform = myslice<br>
  79                 username = mohammed-yasin.rahman@lip6.fr
  80         </p>
  81         <p>
  82                 Test the SFA layer:
  83         </p>
  84         <p class="command">
  85                 $ sfi.py version
  86         </p>
  87         <p>
  88                 And finally delegate your credentials to the portal
  89         </p>
  90         <p class="command">
  91                 $ sfi.py myslice
  92         </p>
  93         <p>
  94         The complete tutorial is available at the following address:
  95         <a target="_blank" href="http://trac.myslice.info/wiki/InstallSfa">http://trac.myslice.info/wiki/InstallSfa</a>
  96         </p>
  97
  98         <br />
  99
 100 </div>
 101 {% endblock %}
 102