Changes between Version 29 and Version 30 of deploy-am

Show
Ignore:
Timestamp:
05/09/11 14:05:20 (8 years ago)
Author:
ibaldin (IP: 152.54.9.21)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • deploy-am

    v29 v30  
    3434=== Prepare $ORCA_HOME directory === 
    3535 
    36 Set $ORCA_HOME. Use 'sudo' when needed. Change ownership of this directory to the user on whose behalf the euca site authority is going to run. 'geni-orca' is the user and 'nonrenci' is the group in this example. 
     36Once you decide which host ORCA container will run on, you can begin configuring ORCA on it. All of ORCA-specific configuration is contained under $ORCA_HOME directory (typically /opt/orca), which must be declared in Tomcat start/stop scripts.  
     37 
     38Set $ORCA_HOME. Change ownership of this directory to the user on whose behalf the euca site authority is going to run. 'geni-orca' is the user and 'nonrenci' is the group in this example. The user and group are presumed to exist. 
    3739{{{ 
    3840$ mkdir /opt/orca  
     
    4244}}} 
    4345 
    44 Make directories for storing Eucalyptus credentials, Euca site resource description files, ORCA actors' runtime credentials and ORCA configuration files. 
     46Make directories for storing Eucalyptus credentials (ec2.cred.properties file), Euca site resource description files (in NDL-OWL), ORCA actors' runtime credentials and ORCA configuration files (container.properties and config.xml). 
    4547{{{ 
    4648$ mkdir $ORCA_HOME/ec2 
     
    5153 
    5254=== Eucalyptus credentials === 
    53 Unzip euca credentials zip file into $ORCA_HOME/ec2 . Assume that the downloaded euca credentials zip file is in the home directory. 
     55 
     56Create user 'orca' or similar in your Eucalyptus cluster portal. Go to the portal and download the users credentials zip file. Unzip the contents euca credentials zip file into $ORCA_HOME/ec2.  
    5457{{{ 
    5558$ cd $ORCA_HOME/ec2 
    56 $ cp $HOME/euca2-orca-x509.zip . 
    57 $ unzip euca2-orca-x509.zip  
    58 }}} 
    59 Comment out the first line in $ORCA_HOME/ec2/eucarc. 
     59$ unzip ~/euca2-orca-x509.zip  
     60}}} 
     61Comment out the first line in $ORCA_HOME/ec2/eucarc (ORCA uses native EC2 tools to talk to Eucalyptus, rather then eucalyptus user tools; the first line confuses EC2 tools): 
    6062{{{ 
    6163#EUCA_KEY_DIR=$(dirname $(readlink -f ${BASH_SOURCE})) 
    6264}}} 
    63 Generate a key-pair for Euca. The name of this keypair ('orca' in this example) is used later to populate the "ec2.ssh.key" property in ec2.site.properties file. 
     65 
     66Generate a key-pair for Euca for the Eucalyptus 'orca' user created above. The name of this keypair is used later to populate the "ec2.ssh.key" property in ec2.site.properties file below. 
    6467{{{ 
    6568$ source $$ORCA_HOME/ec2/eucarc 
     
    6972 
    7073=== Generate and store resource representations for the Eucalyptus Site === 
    71 Generate the NDL resource description of the Eucalyptus site and store it in $ORCA_HOME/ndl. Example of an Eucalyptus site NDL resource description can be found [source:orca/trunk/network/src/main/resources/orca/network/rencivmsite.rdf here]. Consult RENCI staff on how to generate this. Let ORCA_SRC be the root of the downloaded ORCA source. 
     74 
     75Generate the NDL resource description of the Eucalyptus site and store it in $ORCA_HOME/ndl. Example of an Eucalyptus site NDL resource description can be found [source:orca/trunk/network/src/main/resources/orca/network/rencivmsite.rdf here]. Consult RENCI staff on how to generate this. Let ORCA_SRC be the root of the downloaded ORCA source. Actor config.xml file will reference this file later. 
    7276{{{ 
    7377$ cp $ORCA_SRC/network/src/main/resources/orca/network/rencivmsite.rdf $ORCA_HOME/ndl/. 
     
    7680 
    7781=== ORCA actors' runtime credentials === 
     82 
    7883Generate GUIDs and certificates for ALL the actors in your container. Store the guids, which will be used for configuring the actors. Let ORCA_SRC be the root of the downloaded ORCA source. 
    7984{{{ 
     
    9499 * DNAT Proxy - permits public SSH access to VMs/slivers on a Eucalyptus cluster that is hosted behind a firewall (i.e. even Eucalyptus public addresses aren't truly public).  
    95100 
    96 Image Proxy is a mandatory component, while DNAT proxy is optional. Both components are setup separately, however from ORCA perspective their configuration is contained in $ORCA_HOME/ec2/ec2.site.properties file. The following sections describe how to set up these components.  
     101Image Proxy is a mandatory component, while DNAT proxy is optional. Both components are setup separately, however from ORCA perspective their configuration is managed through $ORCA_HOME/ec2/ec2.site.properties file. The following sections describe how to set up these components.  
    97102 
    98103=== Image Proxy === 
     104 
    99105ORCA provides the capability for the user to specify urls for the filesystem image, kernel (optional) and ramdisk (optional) in their resource request. The user images would then be used to stand up the vms across potentially multiple independent Eucalyptus sites under ORCA control. The Image proxy is used to serve this purpose.  Follow instructions on [https://code.renci.org/gf/project/networkedclouds/wiki/?pagename=ImageProxy] to setup and run Image proxy. To configure ORCA to use the Image proxy, follow instructions on [wiki:image-proxy-with-orca ImageProxy with ORCA]. 
    100106 
     
    113119[[Image(dnat-proxy.png, 30%)]] 
    114120 
    115 == Configuration == 
     121== ORCA Configuration == 
    116122 
    117123=== $ORCA_HOME/config/config.xml === 
     124 
    118125An example of a configuration file for a container with site authority actors managing an Eucalyptus/NEuca cluster and a network switch can be found [source:config-files/trunk/euca-m.renci.ben-config.xml here]. Please modify this file to tailor to your installation. Remember to use unique GUIDs for each actor, which were generated in the last step. Name this file 'config.xml' and place it in $ORCA_HOME/config 
    119126{{{