Version 12 (modified by ibaldin, 8 years ago)

--

Eucalyptus/XCat image proxy

Overview

ImageProxy is the mechanism used make same guest image available across multiple independent Eucalyptus sites. It downloads images based on their URLs (including support for Bittorrent) and registers them with appropriate cloud mechanism (e.g. Eucalyptus) using local user credentials. ImageProxy is implemented as an Axis SOAP service that is provided with an image URL and a unique GUID and, which returns the EMI of the registered image. If the image is not present in the system, it is downloaded and registered, otherwise the EMI of the previously registered image is returned.

Installation

  • Download the source (latest tag or trunk). Env. variable IMAGEPROXY_SRC marks the location of the source.
    $ svn co https://geni-orca.renci.org/svn/orca-external/imageproxy/trunk imageproxy
    $ cd imageproxy
    $ export IMAGEPROXY_SRC=`pwd`
    
  • Define the installation directory
    $ export IMAGEPROXY_HOME=/opt/imageproxy
    
  • ImageProxy requires using an Axis2-capable servlet container. You can use one that comes with Axis2 distribution or for production deployment add Axis2 support to Tomcat. Download Axis2 (either binary distribution for stand-alone operation or WAR for running under Tomcat) from Axis2 download site.
    • For standalone operation unzip Axis2 zip into $IMAGEPROXY_HOME
    • For tomcat operation, install tomcat, place the Axis2 war into tomcat/webapps. Test by going to the Tomcat URL /axis2 e.g. http://localhost:8080/axis2
  • Build ImageProxy components
    • Bittorrent JNI
      $ cd $IMAGEPROXY_SRC/bittorrent_jni
      $ ./prep_build.sh 
      $ ./configure --prefix=$IMAGEPROXY_HOME --with-jdk=/path/to/jdk
      $ make
      $ make install
      
      • NOTE1: prep_build.sh script attempts to download and patch some software components
      • NOTE2: configure step depends on libevent library and headers present in the system. If your system does not have libevent installed, it can be compiled and installed from source. Use the latest libevent from 1.4 series. To point configure step at the location of libevent headers and binaries, you can use CFLAGS and LDFLAGS environment variables.
    • SOAP webservice
      $ cd $IMAGEPROXY_SRC
      $ mvn install
      

Using with ORCA