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

                            下载依赖包，在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