Changes between Version 28 and Version 29 of HowTo/ManageCustomImagesInstaGENI


Ignore:
Timestamp:
05/13/16 08:46:05 (8 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • HowTo/ManageCustomImagesInstaGENI

    v28 v29  
    33= InstaGENI Custom Images =
    44
    5 This page capture examples for creating InstaGENI Custom images using both Flack and Omni tools. Custom images are usually created when you have defined and experiment node that has all the features and applications that you intend to use again and again for additional experiments.
     5This page capture examples for creating InstaGENI Custom images using both the GENI Portal and Omni tools. Custom images are usually created when you have defined an experiment node that has all the features and applications that you intend to use again and again for additional experiments.
    66
    77== Custom Images with Omni ==
    88
    9 The Omni tool also supports create, using, listing and deleting custom images.  Each of these custom image functions are outlined in this section.
    10 
    11 === Creating Custom Image ===
    12 
    13 The omni tools allows experimenters to create custom images by replicating any node in an active experiment.  In this example a slice '' '''lntest''' '' is used which includes 2 hosts.  The '' '''host1''' '' image will be captured with omni.
     9The Omni tool supports create, using, listing and deleting custom images.  Each of these custom image functions are outlined in this section.
     10
     11=== Creating a Custom Image ===
     12
     13The omni tool allows experimenters to create custom images by replicating any node in an active experiment.  In this example a slice '' '''lntest''' '' is used which includes 2 hosts.  The '' '''host1''' '' image will be snapshotted with omni.
    1414
    15151. In order to capture the Image running on '' '''host1''' '' we must determine the URN for the host1 device by getting a sliver status:
    1616{{{
    1717$ omni.py sliverstatus -a gpo-ig lntest -o
    18 17:24:08 INFO     omni: Loading agg_nick_cache file '/home/lnevers/.gcf/agg_nick_cache'
    19 17:24:08 INFO     omni: Loading config file /home/lnevers/.gcf/omni_config
    20 17:24:08 INFO     omni: Using control framework portal
    21 17:24:08 INFO     omni: Substituting AM nickname gpo-ig with URL https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0, URN urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm
    22 17:24:09 INFO     omni: Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest expires on 2013-11-04 21:21:50 UTC
    23 17:24:09 INFO     omni: Status of Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest:
    24 17:24:11 INFO     omni:  (PG log url - look here for details on any failures: https://boss.instageni.gpolab.bbn.com/spewlogfile.php3?logfile=3769ab3e1ea15ccc069641ec06e946b5)
    25 17:24:11 INFO     omni: Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest at AM https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0 has overall SliverStatus: unknown
    26 17:24:11 INFO     omni: Writing to 'lntest-sliverstatus-instageni-gpolab-bbn-com.json'
    27 17:24:11 INFO     omni: Sliver status for Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest at AM URL https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0
    28 17:24:11 INFO     omni: ------------------------------------------------------------
    29 17:24:11 INFO     omni:  Completed sliverstatus:
    30 Args: sliverstatus lntest
    31 
    32   Result Summary: Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest expires on 2013-11-04 21:21:50 UTC
    33 Slice urn:publicid:IDN+ch.geni.net:ln-prj+slice+lntest at AM https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0 has overall SliverStatus: unknown.
    34  Saved sliverstatus on lntest at AM https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0 to file lntest-sliverstatus-instageni-gpolab-bbn-com.json.
    35 Returned status of slivers on 1 of 1 possible aggregates.
    36 17:24:11 INFO     omni: ============================================================
    3718}}}
    3819
    … …  
    4324 "attributes": {
    4425 "exclusive": "false",
    45  "sliver_id": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+18223",   <<<<This URN is needed to create image.>>>>
     26 "sliver_id": "urn:publicid:IDN+instageni.gpolab.bbn.com+sliver+18223",   <==This URN is needed to create image
    4627 "component_manager_id": "urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm",
    47  "client_id": "host1",                                                    <<< Information is for host1>>>
     28 "client_id": "host1",                                                    <== This is host1
    4829 "component_id": "urn:publicid:IDN+instageni.gpolab.bbn.com+node+pc1"     
    4930}}}
    … …  
    6950{{{creating public image ['urn:publicid:IDN+instageni.gpolab.bbn.com+image+ch-geni-net:Icreatedthisimage', 'https://boss.instageni.gpolab.bbn.com/image_metadata.php?uuid=ef4340a8-4017-11e3-9226-029e26f15299']}}}.  The new custom image URN and URL can be used for other nodes to load the image.
    7051
     52{{{
     53#!html
     54<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/stock_notes.png" width="40" height="40" alt="Note"></td><td> The image is usually ready in less than 10 minutes, an email notification will be sent, but the notification tend to be handles as spam by email servers.</td></tr></table>
     55  </li>
     56</ol>
     57</td>
     58</tr>
     59</table>
     60}}}
     61
     62
    71634. Omni also includes a command to ''' ''listimages'' ''', which lists your custom images, both public and private:
    7264{{{
    … …  
    10395  <node client_id="cust-host1" exclusive="false">
    10496      <sliver_type name="emulab-openvz" />
    105       <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+ch-geni-net:Icreatedthisimage" />
     97      <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+ch-geni-net:Icreatedthisimage" url="https://boss.instageni.gpolab.bbn.com/image_metadata.php?uuid=ef4340a8-4017-11e3-9226-029e26f15299" />
    10698      </sliver_type>
    10799      <interface client_id="cust-host1:if0" />
    … …  
    121113}}}
    122114
    123 If you plan to use the custom image in the same rack as the original sliver used to generate the image,  you only need to specify your custom image URN:
     115If you plan to use the custom image in the same rack as the original sliver used to generate the image,  you only need to specify your custom image URN if you are using in the same rack:
    124116{{{
    125117   <disk_image name="urn:publicid:IDN+instageni.gpolab.bbn.com+image+ch-geni-net:Icreatedthisimage" />
    … …  
    187179
    188180When you are ready to create your custom image:
    189  1. Go to the "Manage slice" page for your slice,
    190  1. Select the compute node that you want to "snapshot" (create a custom image),
    191  1. Click on the "Snapshot" button.
     181 1. Go to the "Slices" page and select your slice,
     182 2. Select the compute node that you want to save,
     183 3. Click on the "Snapshot" button.
    192184
    193185[[Image(CustomImage-Portal.jpg, 50%)]]
    … …  
    196188
    197189[[Image(NameImage-Portal.jpg, 50%)]]
     190
     191
     192{{{
     193#!html
     194<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/stock_notes.png" width="40" height="40" alt="Note"></td><td> Choose a custom image name that reflects its content. Also note that the image name MUST include alphanumeric characters only.
     195</td></tr></table>
     196  </li>
     197</ol>
     198</td>
     199</tr>
     200</table>
     201}}}
    198202
    199203