= [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure Understanding the AM API] =
{{{
#!html
- In Flack, you can manipulate
the details of the request for a node or link with the "i" button
on the relevant component on the canvas. Do this now on the
client node.
|
Figure 3-3 Edit the nodes
|
- When you open the node information, you should see options like those
in the figure. The controls available to you will vary depending on the
types of the aggregate manager and the component, but many features are
widely available throughout GENI.
- The way we will request installation of the proper software and execution
of our experiment is to add install and execute services.
-
First, select "+ Add Install Service" as shown. Flack will now
prompt you for an "Archive URL" and a location for installation. For this
experiment, please enter the appropriate URL.
Aggregate Type |
Archive URL |
Installation Location |
InstaGENI
|
http://www.gpolab.bbn.com/experiment-support/UnderstandAMAPI/ig/underAMAPI_ig.tar.gz |
/local
|
ExoGENI
|
http://www.gpolab.bbn.com/experiment-support/UnderstandAMAPI/eg/underAMAPI_eg.tar.gz |
/local
|
- Similarly, please use the "+ Add Execute Service" button to request
that the appropriate command be run after the node is booted.
Aggregate Type |
Client Install Script |
Server Install Script |
Shell |
InstaGENI
|
sudo /local/install-script.sh |
sudo /local/install-script.sh |
sh |
ExoGENI
|
/local/install-client.sh |
/local/install-server.sh |
sh |
| Be very careful when entering this information -- these commands will not
be executed yet, so it will be some time before you will see any relevant
error messages if there is a mistake here. |
|
Figure 3-4 Specify the tarball and install script
|
|
- Once both the install and execute services are specified, please
choose Apply. Then repeat the procedure to add the appropriate install and
execute services on the server node.
- Also on the server node, click on the link tab
and select Routable Control IP as shown in the figure.
|
Figure 3-5 On the Link tab, select the
"Routable Control IP" button.
|
}}}
If you have time, it would be instructive to download the `underAMAPI_*.tar.gz` file yourself, and inspect the contents. You will see the `install-script.sh` file referred to in the execute service, and this is a good example of how you can ask for GENI components to perform tasks for you without any manual intervention. This is a very useful facility for large experiments!
== 3.4. Export the modified request RSpec ==
Now we will pull back some of the covers and inspect exactly what Flack has been doing for us when preparing the RSpecs for the experiments we design. Each node and link has a corresponding element in the RSpec, and the details of the component configuration (such as the install and execute services we requested above) are specified with attributes, or sometimes child elements, within those portions of the document.
{{{
#!html