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



你可能感兴趣的:(CloudStack 在Windows 平台上的开发环境设置)