Changes between Version 17 and Version 18 of deploy-am

Show
Ignore:
Timestamp:
05/03/11 13:37:39 (8 years ago)
Author:
anirban (IP: 152.54.6.213)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • deploy-am

    v17 v18  
    4040#EUCA_KEY_DIR=$(dirname $(readlink -f ${BASH_SOURCE})) 
    4141}}} 
     42Generate 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. 
     43{{{ 
     44$ source $$ORCA_HOME/ec2/eucarc 
     45$ euca-add-keypair orca 
     46$ cat <output_previous_command> > $$ORCA_HOME/ec2/orca 
     47}}} 
    4248 
    4349=== Generate and store resource representations for the Eucalyptus Site === 
     
    6066}}} 
    6167 
     68=== Image Proxy === 
     69ORCA 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. 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]. 
     70 
     71[[Image(image-proxy.png, 30%)]] 
     72 
     73=== ssh Proxy Tunneling and Using Shorewall === 
     74When you need access to vm instances created in a private address space separated from the public Internet, ssh proxy tunneling can be used. We support Shorewall-DNAT proxy for this purpose. Install and run Shorewall on a machine (the NAT host) that is accessible via the public internet by following instructions at [wiki:shorewall-dnat-proxy Shorewall setup]. To use Shorewall with ORCA, follow instructions for [wiki:shorewall-with-orca Shorewall configuration for ORCA].  
     75 
     76[[Image(dnat-proxy.png, 30%)]] 
     77 
    6278=== Configuration === 
     79 
    6380==== config.xml ==== 
    6481An 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 
     
    6683$ cp $HOME/euca-m.renci.ben-config.xml $ORCA_HOME/config/config.xml  
    6784}}}  
     85 
    6886==== container.properties ==== 
    6987An example of 'container.properties' 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-container.properties here]. Please modify this file to tailor to your installation - change 'protocols.soapaxis2.url' and 'container.guid' properties to point to the correct soapaxis url and a new guid respectively. To make the actors in the container talk to the RENCI Actor Registry, follow instructions for [wiki:configure-with-registry configuring with registry]. From Camano 3.0+, this is the recommended way to connect to other actors (Brokers, SMs). Name this file 'container.properties' and place it in $ORCA_HOME/config 
    7088{{{ 
    71 $ cp $HOME/euca-m.renci.ben-container.properties $ORCA_HOME/config/config.xml  
     89$ cp $HOME/euca-m.renci.ben-container.properties $ORCA_HOME/config/container.properties  
    7290}}} 
    7391 
    74 ec2.site.properties 
    75 eucanet.cred.properties 
     92==== ec2.site.properties ==== 
     93Modify [source:orca/trunk/handlers/ec2/ec2.site.sample.properties] for your installation.  For the shorewall proxy section, see [wiki:shorewall-with-orca]. For the Image proxy section, see "Handler Integration" in [wiki:image-proxy-with-orca]. Name this file 'ec2.site.properties' and place it in $ORCA_HOME/config . 
     94{{{ 
     95$ cp $HOME/ec2.site.sample.properties $ORCA_HOME/config/ec2.site.properties  
     96}}} 
    7697 
    77 === Image Proxy === 
    78 ORCA 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. 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]. 
    79  
    80 [[Image(image-proxy.png, 30%)]] 
    81  
    82  
    83 === ssh Proxy Tunneling and Using Shorewall === 
    84 When you need access to vm instances created in a private address space separated from the public Internet, ssh proxy tunneling can be used. We support Shorewall-DNAT proxy for this purpose. Install and run Shorewall on a machine (the NAT host) that is accessible via the public internet by following instructions at [wiki:shorewall-dnat-proxy Shorewall setup]. To use Shorewall with ORCA, follow instructions for [wiki:shorewall-with-orca Shorewall configuration for ORCA].  
    85  
    86 [[Image(dnat-proxy.png, 30%)]] 
     98==== eucanet.cred.properties ==== 
     99Look up the "Credentials" sub-section of the section "Eucanet handler" at [wiki:NEuca-in-orca] to populate eucanet.cred.properties file and place it in $ORCA_HOME/config . 
    87100 
    88101=== Set up tomcat === 
     
    138151 
    139152=== Final Deployment === 
    140 tomcat restart, state_recovery lock file, deploy to the machine 
     153Now you are ready to deploy. Start tomcat on the Eucalyptus head node. 
     154{{{ 
     155$ cd $ORCA_HOME/tomcat 
     156$ ./stop.sh (if you want to kill an existing tomcat, or if you are doing a fresh container redeploy) 
     157$ rm -f $ORCA_HOME/state_recovery.lock  (if you want a fresh redeploy) 
     158$ ./start.sh 
     159}}} 
     160Deploy orca webapp by pointing to the machine where the tomcat server is running (euca-m.renci.ben in this example). 
     161{{{ 
     162$ cd $ORCA_SRC 
     163$ mvn clean install 
     164$ cd $ORCA_SRC/webapp 
     165$ mvn clean package 
     166$ ant -Duser.target.server=euca-m.renci.ben deploy 
     167}}} 
     168 
    141169 
    142170=== Some troubleshooting tips ===