http://www.moqui.org/framework/docs/RunDeploy.html
运行和部署指南
本文档介绍了如何运行Moqui通过可执行的jar文件,或者在应用程序服务器中部署WAR文件。
<!--jiasudu 15000850008 -->
运行和部署指南
1。快速入门
2。运行目录和配置文件
3。执行WAR文件
4。示例和公共文件
简单的方式 - 默认设置
普通的用法 - 在命令行中指定一个配置文件
在设置里面创建一个自定义的WAR文件
5。从源代码的编译和运行
6。目录结构
<!--jiasudu 15000850008 -->
1、快速入门
1.1 请确保你有一个Java6 JDK安装(最好是Sun / Oracle和苹果版本的jdk,OpenJDK或Harmony可能会有问题)
1.2 下载并解压缩二进制分发版,创建一个moqui目录
1.3 加载种子数据和演示数据,并创建derby数据以及表结构:
$ java -jar moqui-<version>.war -load
1.4 运行框架(内嵌的servlet,JTA / CP,DB):
$ java -jar moqui-<version>.war
1.5 在浏览器(同一台计算机上),访问:
输入http://localhost:8080/
2、运行目录和配置文件
Moqui框架部署有两个主要部分:
1 可执行的WAR文件(见下文)
2 运行时配置文件的目录
使用的可执行的WAR文件,你必须有一个runtime目录,你可以重写一个XML配置文件的默认设置。
运行目录是主要的地方,把你要加载,为Web应用程序的根文件(root screen)的画面,和配置文件的组成部分。它的框架也会把日志文件,Derby 数据库文件(如果你使用的是Derby),JCR repo文件,等你最终将要创建自己的运行时目录,并保持它在自己的源库中,您可以使用默认的项目一开始浏览网页。
指定这两个属性:
moqui.runtime运行时目录(如果存在,默认为“/runtime”,或如果没有运行的子目录,仅仅是“.”)
moqui.conf的Conf XML文件(URL或路径相对于moqui.runtime)
有两种方法可以指定这两个属性:
1、MoquiInit.properties文件在classpath中
2、系统属性可以在命令行上指定(java -D 参数 )
请参阅下面的例子。
3. 执行WAR文件
生成一个可执行的war文件. 你需要做3个步骤:
加载数据: $ java -jar moqui-<version>.war -load
运行内置的Web服务器: $ java -jar moqui-<version>.war
发布成war, 部署到Tomcat: $ cp moqui-<version>.war ../tomcat/webapps
你也可以获取帮助信息:
java -jar moqui-<version>.war -help
获得一些帮助的说明文字.
4. 示例和公共方法
简单方式 - 默认设置
最简单的方式 解压moqui的二进制发行包,运行moqui.
使用默认配置:
moqui.runtime = runtime
moqui.conf = conf/MoquiDevConf.xml (相对于 runtime)
运行下面的命令:
加载数据 $ java -jar moqui-<version>.war -load
启动服务器 $ java -jar moqui-<version>.war
修改一些配置 - 在命令行指定一个配置文件
加载数据 $ java -Dmoqui.conf=conf/MoquiStagingConf.xml -jar moqui-<version>.war -load
启动服务器 $ java -Dmoqui.conf=conf/MoquiStagingConf.xml -jar moqui-<version>.war
创建一个自定义的war文件
1 在runtime目录里面新增一个组件或者其他资源
2 修改 ${moqui.home}/MoquiInit.properties
3 根据需求修改Moqui配置文件(runtime/conf/Moqui*Conf.xml)
4 基于moqui.war 文件创建派生的war文件并添加到runtime目录中以及 MoquiInit.properties文件: "$ gradle addRuntime" 或者 "$ ant add-runtime"
5 将新建的war文件 (moqui-plus-runtime.war) 部署到目标服务器
6 运行服务器 (或者重新部署war包)
5. 从源代码的编译和运行
Moqui 框架使用了 Gradle作为编译工具..
这也有Ant的一些构建命令,但是不适用从源码代码构建.
编译 JAR, WAR $ gradle build
加载所有数据 $ gradle load $ ant load
运行内置服务器 $ gradle run $ ant run
清理JAR文件, WAR文件 $ gradle clean
清理所有构建文件和运行时的文件(日志, 数据库, 等等) $ gradle cleanAll
注意 加载和运行任务是依赖于构建任务的. 最简单的获得一个全新开发环境以及数据库的命令是:
$ gradle load run
这将构建war 文件, 加载数据, 运行内置服务器. 停止命令为<ctrl-c>.
6. 项目的目录结构
- moqui (from https://github.com/jonesde/moqui)
- framework
- build : Results of framework build go here (classes, jars, etc)
- data : Seed data
- entity : Framework entity definitions
- lib : Libraries (JAR files) used in Moqui
- screen : Framework screens
- service : Framework services
- src : Java API, standard entities, services, data, XSDs, etc
- api : Java source for the Moqui Framework API
- main : Main implement source
- groovy : Groovy source (bulk of the implementation)
- java : Java source (a few special classes)
- resources : Classpath resources, placed in JAR as-is
- webapp : Base webapp, mostly just a WEB-INF/web.xml file
- start : Java source for MoquiStart, used for executable WAR
- template : Framework templates (screen/form, xml-actions FTLs)
- xsd : Framework XML Schema files
- runtime
- component : Components to deploy
- example : An example application
- tools : Framework administration and maintenance tools
- webroot : Root Screen and supporting content
- conf : Configuration files separated by dev, staging, prod, etc
- db : Database files for Derby, etc will go here
- lib : JAR files to add to classpath
- log : Log files will go here
- mantle : The Mantle root can go here, with components under it
- template : General Templates
- tmp : Temporary files
设置环境变量
export GRADLE_HOME=/Users/user/tools/gradle-1.2
export PATH=$GRADLE_HOME/bin:$PATH
最后在终端下执行gradle -v 查看输出
gradle run
Moqui运行部署说明(中文翻译)
猜你喜欢
转载自jiasudu.iteye.com/blog/1692296
今日推荐
周排行