Moqui系统安装配置说明

26 Jun 2021

Moqui虽然是高度模块化的系统，但整体安装并不复杂，参考官方文档即可。本文主要对过程中的一些细节做简要说明。

系统安装

准备框架
Moqui的运行依赖于moqui-framework，所以第一步是获取其源码：
```
git clone https://github.com/moqui/moqui-framework.git moqui
```
随后的命令都在moqui目录中执行。
获取组件
Moqui使用组件化的方式管理各模块，安装时需要根据需要获取，以下以HiveMind为例：
```
./gradlew getComponent -Pcomponent=HiveMind
```
获取ElasticSearch
Moqui和ElasticSearch有较深的整合，Moqui可以连接外部的ElasticSearch服务，也可以由其启动，后者需要通过以下命令获取相关包：
```
./gradlew downloadElasticSearch
```
编译
执行以下命令，以生成moqui.war文件：
```
./gradlew build
```
说明：官方文档里建议是用./gradlew load命令单步完成编译和数据库初始化操作，但个人感觉分开操作逻辑更为清晰，所以这里分两步执行。但实际上这个是将 ./gradlew build 和 java -jar moqui.war load types=seed,seed-initial 整合，感觉还是分开比较清晰。
解压
上一步编译生成的moqui.war是直接执行的，但每次执行都需要解压到临时目录./execwartmp，并在程序结束时清理。
如果想要省去这一步操作，可以通过以下命令先解压，之后直接通过java -cp ROOT MoquiStart命令执行：
```
unzip -d ROOT moqui.war
```

执行以下命令完成数据初始化：

java -cp ROOT MoquiStart load types=seed,seed-initial

注意：如果不手动执行数据初始化操作而直接运行服务，Moqui默认加载所有数据，包括demo数据。

通过以下命令启动服务：

java -cp ROOT MoquiStart

说明：如果使用内建ElasticSearch服务，Moqui会在启动过程中检测并拉起，无需手动启动。

时区设置
在runtime/conf/MoquiDevConf.xml中添加如下配置：
```
<default-property name="default_time_zone" value="Asia/Shanghai"/>
```