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 | |
| 187 | |
| 188 | == Custom Images with Flack - Deprecated == |
| 189 | NOTE: 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 |
| 190 | ask to be made public |
| 191 | |
| 192 | The 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 | |
| 196 | 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. |
| 197 | |
| 198 | 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: |
| 199 | |
| 200 | [[Image(CustomImage-flack-pt.jpg)]] |
| 201 | |
| 202 | 2. Once you have selected the slice in Flack you will see the the resources in use: |
| 203 | |
| 204 | [[Image(CustomImage-topo-pt.jpg)]] |
| 205 | |
| 206 | 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: |
| 207 | |
| 208 | [[Image(CustomImage-create-pt.jpg)]] |
| 209 | |
| 210 | 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: |
| 211 | |
| 212 | [[Image(CustomImage-name-pt.jpg)]] |
| 213 | |
| 214 | 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: |
| 215 | |
| 216 | [[Image(CustomImage-confirm-pt.jpg)]] |
| 217 | |
| 218 | You 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 | |
| 222 | 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. |
| 223 | |
| 224 | 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: |
| 225 | |
| 226 | [[Image(CustomImage-select-pt.jpg)]] |
| 227 | |
| 228 | 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: |
| 229 | |
| 230 | [[Image(CustomImage-select1-pt.jpg)]] |
| 231 | |
| 232 | Click on OK to get the list of available images. |
| 233 | |
| 234 | 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: |
| 235 | |
| 236 | [[Image(CustomImage-list-pt.jpg)]] |
| 237 | |
| 238 | After 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 | |
| 242 | Your node will be created using the custom image you just selected. |
| 243 | |
| 244 | |
| 245 | === Deleting your Custom Image === |
| 246 | |
| 247 | 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. |