Differences

This shows you the differences between two versions of the page.

Link to this comparison view

public:experimenters:images [2013/04/26 14:21]
pruth
public:experimenters:images [2016/09/07 11:46] (current)
ibaldin [Building and using your own images]
Line 1: Line 1:
 ====== ExoGENI VM Images ====== ====== ExoGENI VM Images ======
  
-This page aggregates information about known VM images known to work on ExoGENI:+ExoGENI is a BYOI testbed - unlike Emulab/InstaGENI the images are not hosted by the testbed. Instead, VM images can be created by anyone, uploaded to any webserver and then used to create slices. ExoGENI control software is provided with a URL of the metafile, containing the parts of the image, based on which it retrieves the image and boots VM instances with it. ExoGENI does provide a [[http://geni.renci.org:15080/registry/images.jsp | few starter images]] that can be used by experimenters.
  
-^ Website or Image URL + Checksum ^ Owner information ^ Notes ^  +ExoGENI VM images typically consist of three separate parts:  
-|https://geni-orca.renci.org/trac/wiki/neuca-images| ExoGENI Ops Team | A list of known base images usable on ExoGENI provided by the ExoGENI Ops team | +  * The kernel  
-|http://emmy9.casa.umass.edu/Disk_Images/ExoGENI/exogeni-umass-1.2.xml, 49f0c193cc91d7b2fc1a6f038427935f4c296a8a| UMass Amherst Cong Wang <cwang AT ecs.umass.edu> | A GIMI/OMF-enabled image. Please use m1.large or [[public:experimenters:resource_types:start | any size]] capable of accommodating a 5G image.  | +  * The ramdisk 
-| http://emmy9.casa.umass.edu/Disk_Images/ExoGENI/Ubuntu1204/ubuntu1204.xml, 0beb69c8fbe65af0134ac8fe38b22e8f9b3c254c | Jeanne Ohren (GPO):  <johren AT bbn.com | An Ubuntu 12.04.1 LTS image based on Ubuntu EC image.  |+  * The filesystem
  
 +Kernels and ramdisks can be mixed and matched with different filesystems, if desired, as long as necessary modules to mount the filesystem are in the ramdisk. 
  
-If you have an image you would like to share with the community, please send an email to geni-orca-users list and ask for the image to be added to this list. Please provide detailed information about what is on the image and who created it.+A simple XML-based meta-file format is used to describe images. Image parts are referenced by the URLs of the metafile and the image itself is used by providing ExoGENI tools (Flukes, omni or Flack) with the URL of the metafile and its SHA1 signature. See [[https://geni-orca.renci.org/trac/wiki/orca-and-rspec | for RSpec conventions]] on specifying images to ExoGENI. 
 + 
 +Note that since image elements are referenced by URLs, the different parts of the image and the metafile itself can all be hosted by different webservers. 
 + 
 +<code> 
 +<images> 
 + <image> 
 + <type>ZFILESYSTEM</type> 
 + <signature>FS IMAGE SHA1 HASH</signature> 
 + <url>http://url_to_compressed_filesystem_image</url> 
 + </image> 
 + <image> 
 + <type>KERNEL</type> 
 + <signature>KERNEL IMAGE SHA1 HASH</signature> 
 + <url>http://url_kernel_image</url> 
 + </image> 
 + <image> 
 + <type>RAMDISK</type> 
 + <signature>RAMDISK IMAGE SHA1 HASH</signature> 
 + <url>http://url_ramdisk_image</url> 
 + </image> 
 +</images> 
 +</code> 
 + 
 +To see a working example, simply click on any URLs in the listing provided by the [[http://geni.renci.org:15080/registry/images.jsp | Image Registry Service]] 
 +===== Finding existing images ===== 
 + 
 +Well-known and tested images are listed [[http://geni.renci.org:15080/registry/images.jsp | on this page]] through an Image Registry Service. In addition to providing a human-readable web page, there is also an XMLRPC service that is available for tool builders (see same page). For example Flukes automatically reads all images listed by this service at startup.  
 + 
 +Note that due to licensing requirements we cannot list or provide non Open-Source OS images (MS Windows, Solaris etc).  
 + 
 +===== Building and using your own images ===== 
 + 
 +You can [[https://geni-orca.renci.org/trac/wiki/virtual-machines | build your own image yourself]] on any Linux computer and add [[https://geni-orca.renci.org/trac/wiki/NEuca-guest-configuration | NEuca guest tools to it]].  
 + 
 +After you have placed the image metafile on some Internet-facing webserver and calculated its SHA1 signature (using e.g. 'sha1sum' program under Linux), you can 
 +  * Add the image to the [[https://geni-orca.renci.org/trac/wiki/flukes#Clientdiskimages | list of images]] known to your Flukes  
 +  * Input the image metafile URL and SHA1 signature into Flukes image dialog  
 +  * Input the image metafile URL and SHA1 signature into RSpec (for omni and Flack) 
 + 
 +You can then launch a slice using this image.  
 + 
 +Note that since ExoGENI software needs to fetch parts of your image from the webserver prior to launching your slice, the first time you launch a slice with a particular image in a particular site, you may incur a significant delay.  
 + 
 +There is a helpful script attached to [[https://geni-orca.renci.org/trac/wiki/virtual-machines | this page]] that helps create an image descriptor XML file.  
 +===== Making your images useful to other experimenters ===== 
 + 
 +If you have an image you would like to share with the community, please send an email to geni-orca-users list and ask for the image to be added to the list of well-known images. This way it will become automatically available to all experimenters 
 + 
 +Please provide detailed information about what is on the image and who created it.
  
-Visit [[https://geni-orca.renci.org/trac/wiki/virtual-machines | this page]] to see how you can build and host your own image. 
Navigation
Print/export