Changes between Version 20 and Version 21 of HowTo/ManageCustomImagesInstaGENI


Ignore:
Timestamp:
02/15/15 08:30:28 (9 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HowTo/ManageCustomImagesInstaGENI

    v20 v21  
    55This 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.
    66
    7 == Custom Images with Flack ==
    8 
    9 The Flack 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 
    13 The Flack tool can make a copy of an OS image from any active node in a slice. The custom image that Flack creates is a capture of your original image that is available via a URN and URL for use by later slices in the same rack or in other racks. In this example we have a slice named ''lntest''  which includes 2 hosts is used to create image.
    14 
    15 1. First access the slice that includes the node whose setup you would like to capture in a custom image. This example uses the GENI portal, where you select  the "Launch Flack" button for the slice:
    16 
    17 [[Image(CustomImage-flack-pt.jpg)]]
    18 
    19 2. Once you have selected the slice in Flack you will see the the resources in use:
    20 
    21 [[Image(CustomImage-topo-pt.jpg)]]
    22 
    23 3. We are going to select '' '''host2''' '' to generate a custom image. First click on the '' '''host2''' ''  information button [[Image(info.jpg)]], this brings up the host details. Select the ''Create Image'' button:
    24 
    25 [[Image(CustomImage-create-pt.jpg)]]
    26 
    27 4. Selecting the ''Create Image'' button results in a pop-up requesting that you name the custom image that is about to be created for you:
    28 
    29 [[Image(CustomImage-name-pt.jpg)]]
    30 
    31 5. Clicking the '' '''OK''' '' button will start the custom image creation. You will then see a results window which will report that the image is creates and provides information to use the image on future slices:
    32 
    33 [[Image(CustomImage-confirm-pt.jpg)]]
    34 
    35 You may choose to ''copy'', ''save'' or ''email'' the custom image information.  You are now ready to use your custom image in other slices.
    36 
    37 === Using your Custom Image ===
    38 
    39 This section will show you how to use the custom image creates in the previous section. The procedure is the same whether the image is on the local Rack or on any other InstaGENI rack.
    40 
    41 1. To use your custom image in the same rack, first create your new slice and then proceed to define the sliver. Once you have added a host, select the node information button and click on the  ''Select a user for user-created disk images'' pull-down:
    42 
    43 [[Image(CustomImage-select-pt.jpg)]]
    44 
    45 Once you have selected the  ''Select a user for user-created disk images'' a pop-up windows will show your user URN, keep the default if you a using your own image, if you are using someone else's image, you must enter their URN:
    46 
    47 [[Image(CustomImage-select1-pt.jpg)]]
    48 
    49 Click on OK to get the list of available images.
    50 
    51 2. When the previous step is completed, you can click on the "Select user-created disk image" pull-down to get a list of all known images at all aggregates and select your image, for our example we will select the image named "!MyCustomImage" created earlier:
    52 
    53 [[Image(CustomImage-list-pt.jpg)]]
    54 
    55 After the selection you will see the Name of the image detail in the "Name" or "URL" field:
    56 
    57 [[Image(CustomImage-name-urn-pt.jpg)]]
    58 
    59 Your node will be created using the custom image you just selected.
    60 
    61 
    62 === Deleting your Custom Image ===
    63 
    64 Currently Flack does not support deleting custom images. If you would like to delete your custom image you can follow the omni instructions in the Omni [wiki:HowTo/ManageCustomImagesInstaGENI#DeletingyourCustomImage1 Deleting Custom Images] section.
     7
    658
    669== Custom Images with Omni ==
     
    242185
    243186Your image is now been removed!
     187
     188== Custom Images with Flack - Deprecated ==
     189NOTE: If you create an Image with Flack it will be created as private, i.e. only you will have access to the image, to make it public you have to email geni-users@googlegroups.com and
     190ask to be made public
     191
     192The Flack tool supports create, using, listing and deleting custom images.  Each of these custom image functions are outlined in this section.
     193
     194=== Creating a Custom Image ===
     195
     196The Flack tool can make a copy of an OS image from any active node in a slice. The custom image that Flack creates is a capture of your original image that is available via a URN and URL for use by later slices in the same rack or in other racks. In this example we have a slice named ''lntest''  which includes 2 hosts is used to create image.
     197
     1981. First access the slice that includes the node whose setup you would like to capture in a custom image. This example uses the GENI portal, where you select  the "Launch Flack" button for the slice:
     199
     200[[Image(CustomImage-flack-pt.jpg)]]
     201
     2022. Once you have selected the slice in Flack you will see the the resources in use:
     203
     204[[Image(CustomImage-topo-pt.jpg)]]
     205
     2063. We are going to select '' '''host2''' '' to generate a custom image. First click on the '' '''host2''' ''  information button [[Image(info.jpg)]], this brings up the host details. Select the ''Create Image'' button:
     207
     208[[Image(CustomImage-create-pt.jpg)]]
     209
     2104. Selecting the ''Create Image'' button results in a pop-up requesting that you name the custom image that is about to be created for you:
     211
     212[[Image(CustomImage-name-pt.jpg)]]
     213
     2145. Clicking the '' '''OK''' '' button will start the custom image creation. You will then see a results window which will report that the image is creates and provides information to use the image on future slices:
     215
     216[[Image(CustomImage-confirm-pt.jpg)]]
     217
     218You may choose to ''copy'', ''save'' or ''email'' the custom image information.  You are now ready to use your custom image in other slices.
     219
     220=== Using your Custom Image ===
     221
     222This section will show you how to use the custom image creates in the previous section. The procedure is the same whether the image is on the local Rack or on any other InstaGENI rack.
     223
     2241. To use your custom image in the same rack, first create your new slice and then proceed to define the sliver. Once you have added a host, select the node information button and click on the  ''Select a user for user-created disk images'' pull-down:
     225
     226[[Image(CustomImage-select-pt.jpg)]]
     227
     228Once you have selected the  ''Select a user for user-created disk images'' a pop-up windows will show your user URN, keep the default if you a using your own image, if you are using someone else's image, you must enter their URN:
     229
     230[[Image(CustomImage-select1-pt.jpg)]]
     231
     232Click on OK to get the list of available images.
     233
     2342. When the previous step is completed, you can click on the "Select user-created disk image" pull-down to get a list of all known images at all aggregates and select your image, for our example we will select the image named "!MyCustomImage" created earlier:
     235
     236[[Image(CustomImage-list-pt.jpg)]]
     237
     238After the selection you will see the Name of the image detail in the "Name" or "URL" field:
     239
     240[[Image(CustomImage-name-urn-pt.jpg)]]
     241
     242Your node will be created using the custom image you just selected.
     243
     244
     245=== Deleting your Custom Image ===
     246
     247Currently Flack does not support deleting custom images. If you would like to delete your custom image you can follow the omni instructions in the Omni [wiki:HowTo/ManageCustomImagesInstaGENI#DeletingyourCustomImage1 Deleting Custom Images] section.