mirror of
				https://github.com/apache/cloudstack.git
				synced 2025-10-26 08:42:29 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			93 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			93 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| <HTML>
 | |
| <!--
 | |
| Licensed to the Apache Software Foundation (ASF) under one
 | |
| or more contributor license agreements.  See the NOTICE file
 | |
| distributed with this work for additional information
 | |
| regarding copyright ownership.  The ASF licenses this file
 | |
| to you under the Apache License, Version 2.0 (the
 | |
| "License"); you may not use this file except in compliance
 | |
| with the License.  You may obtain a copy of the License at
 | |
| 
 | |
|   http://www.apache.org/licenses/LICENSE-2.0
 | |
| 
 | |
| Unless required by applicable law or agreed to in writing,
 | |
| software distributed under the License is distributed on an
 | |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 | |
| KIND, either express or implied.  See the License for the
 | |
| specific language governing permissions and limitations
 | |
| under the License.
 | |
| -->
 | |
| <HEAD>
 | |
| <TITLE>Cloud.com's EC2 local deployment Guide</TITLE>
 | |
| </HEAD>
 | |
| <BODY>
 | |
| <H1>Cloud.com's EC2 local deployment Guide</H1>
 | |
| 8/30/2010
 | |
| 8/25/2011 (updated)
 | |
| <H2>Table of Contents</H2>
 | |
| <UL>
 | |
| <LI><A href="#prereq">1. Required 3rd Party Software</A></LI>
 | |
| <LI><A href="#git">2. Clone repository</A></LI>
 | |
| <LI><A href="#build">3. Build, deploy and run cloud-bridge with ant</A></LI>
 | |
| </UL>
 | |
| <P>
 | |
| <H2 id="prereq">1. Required 3rd Party Software</H2>
 | |
| 1) Following software has to be installed in order to deploy and run cloud-bridge tool:
 | |
| <pre>
 | |
| apache-tomcat-6.0.32
 | |
| axis2 1.5.1 (http://apache.imghat.com//ws/axis2/1_5/axis2-1.5-bin.zip)
 | |
| ant
 | |
| java
 | |
| mysql
 | |
| </pre>
 | |
| 2) Set following environment variables:
 | |
| <pre>
 | |
| ANT_HOME
 | |
| CATALINA_HOME
 | |
| export ANT_HOME
 | |
| export JAVA_HOME
 | |
| </pre>
 | |
| 3) Go to CATALINA_HOME directory and excute “mkdir temp” (this directory is used for storing temporary axis files)
 | |
| <P>
 | |
| <H2 id="git">2. Clone repository</H2>
 | |
| Clone cloud-bridge repository:
 | |
| <pre>
 | |
| git clone git@github.com:alena11081/cloud-bridge.git
 | |
| </pre>
 | |
| <P>
 | |
| <H2 id="build">3. Build, deploy and run cloud-bridge with ant</H2>
 | |
| Deployment procedure using ant (build.xml and build-cloud-bridge.xml are config files), execute from cloned cloud-bridge directory:.
 | |
| <pre>
 | |
|  
 | |
| * ant clean - removes dist directory
 | |
| * ant clean-tomcat - cleans up $CATALINA_HOME/webapps/bridge directory
 | |
| * ant build-cloud-bridge compiles and places the resulting jars into cloud-bridge/dist:
 | |
| 
 | |
| ls dist/
 | |
| cloud-auth-ec2.mar  cloud-auth-s3.mar  cloud-bridge.jar  cloud-ec2.aar  cloud-s3.aar
 | |
| 
 | |
| 
 | |
| * deploy-axis - copies and unwars cloud-bridge/lib/axis2.war to $CATALINA_HOME/webapps/bridge directory
 | |
| 
 | |
| <b>ant deploy-cloud-bridge</b> copies files to $CATALINA_HOME/webapps/bridge tomcat directory:
 | |
| 
 | |
| 
 | |
| - copy cloud-bridge/dist/cloud-ec2.aar and  cloud-s3.aar to $CATALINA_HOME/webapps/bridge/WEB-INF/services
 | |
| - copy cloud-bridge/dist/cloud-auth-ec2.mar and cloud-auth-s3.mar to $CATALINA_HOME/webapps/bridge/WEB-INF/modules
 | |
| - copy all .mar files from cloud-bridge/modules to $CATALINA_HOME/webapps/bridge/WEB-INF/modules
 | |
| - copy cloud-bridge/dist/cloud-bridge.jar to $CATALINA_HOME/webapps/bridge/WEB-INF/lib
 | |
| - copy all .jar files from cloud-bridge/lib directory to $CATALINA_HOME/webapps/bridge/WEB-INF/lib
 | |
| - copy all .jar files from cloud-bridge/rampartlib directory to $CATALINA_HOME/webapps/bridge/WEB-INF/lib 
 | |
| <del>- copy all files from cloud-bridge/conf directory to $CATALINA_HOME/webapps/bridge/WEB-INF/conf</del>
 | |
| - copy cloud-bridge/resource/Axis2/axis2.xml to $CATALINA_HOME/webapps/bridge/WEB-INF/conf
 | |
| - copy cloud-bridge/web/web.xml to $CATALINA_HOME/webapps/bridge/WEB-INF
 | |
| - copy cloud-bridge/resource/AmazonEC2/crypto.properties and xes.keystore to $CATALINA_HOME/webapps/bridge/WEB-INF/classes/
 | |
| - remove $CATALINA_HOME/webapps/bridge/WEB-INF/lib/dom4j-1.6.1.jar
 | |
| 
 | |
| 
 | |
| ant deploydb - execute cloud-bridge/db/mysql/deploy-db-bridge.sh (for Unix). If it's a windows deployment, execute db/mysql/init_db.bat script
 | |
| 5) Configure ec2-service.properties (see parameters descriptions in resource/AmazonEC2/docs/EC2-implementation-guide.html).
 | |
| 6) To run application execute "./catalina.sh run" from $CATALINA_HOME/bin directory.
 | |
| </BODY>
 | |
| </HTML>
 |