CloudStack 在Windows 平台上的开发环境设置

原文地址：https://cwiki.apache.org/confluence/display/CLOUDSTACK/Setting+up+a+CloudStack+dev+environment+on+Windows

安装步骤：

步骤一、安装Cygwin

下载Cygwin安装工具。

运行Cygwin的安装文件setup.exe，请将Cygwin安装到没有空格的路径下（很多公共组件在有空格的路径下会有问题），如“C:\bin\cygwin”或者“c:\cygwin”。

• Cygwin安装可以选择从网络下载安装、从本地目录安装。

• Select Packages步骤中，需要额外选择安装包，默认安装包并不包括开发包和编辑器。（注：可以使用search功能进行搜索）

• 选择Devel下的git，也可以选择安装整个Devel，只是会多花些时间。

• 选择Editors下的vim或者emacs，这是Cygwin下的编辑器。

• 选择Libs下的libsasl2

• 选择Net下的ca-certificates和openssh

• 选择Python

• 选择Utils下的genisoimage和mkisofs

• 下载可能会比较慢，取决于所使用的镜像网站（注：我选择的163的镜像网站）。不要选择不必要的安装包如KDE 何Games，以减少安装时间。

• 安装完成后，请做如下事情，以确保maven能够调用mkisofs和python。

• 打开windows命令行（运行cmd，回车）.

• cd到cygwin的bin目录, 如C:\bin\cygwin\bin或者c:\cygwin\bin。

• 建立符号链接：mklink mkisofs.exe genisoimage.exe

• 建立符号链接：mklink python.exe python2.7.exe

• 运行Cygwin

• 将“none /cyg cygdrive binary,noacl,posix=0,user 0 0”添加到/etc/fstab文件的最后。这做了两件事情，替换 /cygdrive/c为更短的 /cygdrive/c。去掉posix acl语法，该语法会导致编译出现问题，因为编译会试图修改文件权限，这在windows 文件系统下会出现问题。

• 完成cygwin安装后，还可以运行setup来升级软件包，也可以安装新的软件包，再次安装时，路径等信息请使用默认配置。

注：打开Cygwin Terminal时，会导入包括Path在内的windows的环境变量到linux环境变量中。后面还需要设置windows环境变量，需要重新打开Cygwin Terminal才能生效。

步骤二、安装JDK

下载最最新的JDK，网址：http://www.oracle.com/technetwork/java/javase/downloads/index.html

• 安装路径请选择没有空格的路径，如c:\bin\Java
• 设置windows系统变量 JAVA_HOME 为安装路径。
  • 我删除了用户变量JAVA_HOME，以防止系统变量被覆盖。

步骤三、安装Python2.7

如果建立了步骤一Cygwin 安装中的软连接，则可略过此步骤（我执行了）。

• 从http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi下载并安装python2.7
• 安装路径请不要包含空格，如c:\bin\python27
• 将安装路径添加到windows的系统变量Path末尾。

步骤四、安装最新版Eclipse

Eclipse下载地址：http://www.eclipse.org/downloads/

• Eclipse没有安装文件，只有zip压缩包可下载。
• 撰写本文时，Eclipse最新版本是 Eclipse Juno (4.2)
• 解压Zip压缩包到希望运行Eclipse的文件夹。
• 修改eclipse安装目录里的eclipse.ini。
  • 修改launcher.XXMaxpermSize为1024m
  • 增加或者修改-Xms1024m参数
  • 增加或者修改-Xmx2048m参数

步骤四A、安装Eclipse插件

CloudStack源码中有python代码，需要在PyDev插件中编辑。

• 打开Eclipse。
• 点击菜单Help-->Installing New Software...
• 使用Add...按钮，将 http://pydev.org/updates加入到下载列表中。
  • PyDev将会出现在下面的列表中，选中PyDev并继续。
  • 请注意查看安装对话框，PyDev插件安装需要进行一些确认。

M2E插件运行Eclipse导入CloudStack的pom.xml，该文件相当于Eclipse通常使用的.project文件。

• 打开Eclipse。
• 点击菜单Help-->Installing New Software...
• 选择在下拉列表中选择“All Available Sites”。
  • 等待“Pending...”完成
• 在过滤框中输入m2e进行过滤。

安装M2Eclipse

可选：安装EGit，为Eclipse基础Git。

• 点击About
• 点击Eclipse Market Place
• 点击Popular tab
• 查找EGit-Git Team Provider

步骤五、可选：安装tomcat6.0.33

开发过程不需要tomcat，CloudStack的maven启动脚本是启动Jetty，Jetty类似于Tomcat。

Apache Tomcat 是个开源web服务器和Servlet容器，CloudStack的管理节点使用Tomcat。

• 大部分web服务器是用java实现的，tomcat是用C实现的。
• servlet容器需要实现Servlet和JSP协议。

下载Tomcat，http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.33/bin/apache-tomcat-6.0.33.exe

• 安装路径请选择没有空格的路径，如c:\bin\Tomcat6.0
• 安装中保留8080端口，用户名和密码为空

安装完成后设置系统变量。

• 增加系统变量CATALINA_HOME，设置为Tomcat的安装路径。如c:\bin\Tomcat6.0
• 将“%CATALINA_HOME%\bin”增加到windows系统变量PATH末尾。

注: 测试环境变量，可以通过打开cygwin，执行命令'which Tomcat6'，将会返还Tomcat执行文件的路径。

步骤六：安装MySql

下载安装文件http://dev.mysql.com/downloads/mysql/5.0.html#downloads

• 建议使用5.1.x; 但开发者使用的是5.5
• Check the box that asks whether you want to include mysql bin directory in the PATH. The option is a checkbox towards the end of the config wizard.
• 也可以下载安装Mysql 客户端来连接Mysql数据库.

步骤六A 为Mysql安装Python connector.

下载并安装Python 2.7的mysql connectorhttp://dev.mysql.com/downloads/connector/python/

步骤七:  安装Ant

只有CloudStack4.0才需要人工安装Ant。

下载Ant，路径 http://ant.apache.org/bindownload.cgi

• Ant只有zip压缩包，没有安装文件。
• 解压Ant压缩包到希望运行Ant的目录下。
• 增加windows系统变量ANT_HOME，设置值为Ant安装路径。
• 增加“%ANT_HOME%\bin" 到windows系统变量Path末尾。

注：测试环境变量，可以通过打开cygwin，执行命令'which ant'，将会返还Ant执行文件的路径。

步骤八、安装Maven 3.0

下载Maven， http://maven.apache.org/download.html

• CloudStack需要使用3.x版本
• Maven只有zip压缩包，没有安装文件
• 解压Maven压缩包到希望运行Maven的目录下
• 安装目录请使用没有空格的目录，如 C:\bin\maven
• 增加windows系统变量M2_HOME，设置值为maven安装路径，如c:\bin\maven
• 增加windows系统变量M2，设置值为%M2_HOME%\bin
• 增加“%M2%”到windows系统变量Path末尾。
• Add '%M2%' to the Windows System environment variable PATH

注：测试环境变量，可以通过打开cygwin，执行命令'which mvn'，将会返还Maven执行文件的路径。

步骤九、下载cloudstack-oss源代码

• 打开cygwin
• 创建cloudstack-oss 目录, cdcloudstack-oss
• 执行git clone

  https://git-wip-us.apache.org/repos/asf/cloudstack.git

• 也可以下载源代码Zip包并解压。

步骤十、产生SSH Key

在 $HOME目录产生ssh key (CloudStack Management server 在运行时会检查ssh key)

ssh-keygen -t rsa -q

步骤十一、安装"mkisofs"

Cygwin的 mkisofs只是一个连接符，在build的时候并不工作。

下载并安装mkisofs，http://svnpenn.blogspot.com/2011/06/mkisofs-for-windows_24.html（注：下载有问题，我没有安装）

注：测试环境变量，可以通过打开cygwin，执行命令'which mkisofs'，将会返回mkisofs执行文件的路径。

步骤十二，配置cloudstack数据库信息

修改build/replace.properties文件，只需要配置DBROOTPW，就是数据库root的密码。

E.g.
{{$ cat build/override/replace.properties
DBUSER=cloud
DBPW=cloud
DBROOTPW=
MSLOG=vmops.log
APISERVERLOG=api.log
DBHOST=localhost
AGENTLOGDIR=logs
AGENTLOG=logs/agent.log
MSMNTDIR=/mnt
COMPONENTS-SPEC=components-premium.xml}}

步骤十三、编译（注：原文中的编译命令有问题，使用了http://cloudstack.apache.org/develop/environment.html里的编译方法，需要安装Tomcat6）

下载依赖包，在CloudStack源代码跟目录运行:

mvn -P deps

编译CloudStack，在CloudStack源代码跟目录运行:

ant clean-all build-all

部署CloudStack，run：

ant deploy-server

部署数据库:

ant deploydb

运行CloudStack

开启CloudStack，运行:

ant debug

CloudStack 日志文件在源代码跟目录下的 vmops.log。

tail -f vmops.log

步骤十四、可选: 使用DevCloud工作

DevCloud是运行在VirtualBox里的VM，包含了CloudStack的开发环境和运行环境，相关请看https://cwiki.apache.org/confluence/display/CLOUDSTACK/DevCloud