快速运行

演示模式

如果想快速预览MQCloud的功能，请参考演示模式wiki。

一. 配置数据库

1.本地数据库[可选]

1. MQCloud内嵌H2DB数据库，支持本地启动，无需依赖外部数据库，项目启动即可使用。

2. 项目启动后，可使用浏览器访问http://localhost:8080/h2-console/进入H2DB控制台。

  注意：该模式只适用测试或模拟环境，生产环境不建议使用

2.外部数据库

1. 下载并安装mysql

2. 创建数据库并初始化数据【注意，如果数据初始化不正确将影响项目运行！】

   执行数据文件init.sql，执行完毕后将自动创建好数据库、表及初始化数据，但是务必要校验数据的正确性：user、warn_config各有一条数据。common_config有如下数据：

   key	value	comment
   domain	127.0.0.1:8080	mqcloud的域名
   serverUser	mqcloud	服务器 ssh 用户
   serverPassword	9j7t4SDJOIusddca+Mzd6Q==	服务器 ssh 密码
   serverPort	22	服务器 ssh 端口
   serverConnectTimeout	6000	服务器 ssh 链接建立超时时间
   serverOPTimeout	12000	服务器 ssh 操作超时时间
   ciperKey	DJs32jslkdghDSDf	密码助手的key
   operatorContact	1234","mobile":"18688888888","qq":"88888888","email":"[email protected]"}]	运维人员json

3. 创建用户并赋权

   create user 'mqcloud' identified by 'mqcloud';
   grant all on *.* to 'mqcloud'@'%' identified by 'mqcloud' with grant option;   
   flush privileges;
   

4. 启用配置

   如需启用该模式，在jvm属性中增加以下配置

   -Dspring.profiles.active=online
   

   如果需要修改默认链接配置，可以在jvm属性增加以下配置

   -Dspring.datasource.mq.url=jdbc:mysql://127.0.0.1:3306/mq-cloud?useUnicode=true&characterEncoding=UTF-8 -Dspring.datasource.mq.username=mqcloud -Dspring.datasource.mq.password=mqcloud
   

---

二. 运行项目

1. war包运行

   使用下载或编译的war包，执行：

   java -Dspring.profiles.active= '运行环境' -Dfile.encoding=UTF-8 -DPROJECT_DIR=日志绝对路径 -jar mq-cloud.war
   

   当启用本地数据库时，-Dspring.profiles.active配置可省略，如启用外部数据库，则需配置-Dspring.profiles.active=online

   如果需要修改的配置很多，可以使用如下方式指定外部配置文件：

   java -Dspring.profiles.active=online -Dfile.encoding=UTF-8 -DPROJECT_DIR=日志绝对路径 -Dspring.config.location=绝对路径\application.yml,绝对路径\application-online.yml -jar mq-cloud.war
   

   如果放到线上运行，建议参考如下参数进行修改：

   -server -Xmx4g -Xms4g -Xss256k -XX:+UseG1GC -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -XX:MaxGCPauseMillis=100  -Xloggc:/data/logs/gc.log -XX:+PrintGCDateStamps -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/data/logs/java.hprof -XX:+DisableExplicitGC -XX:+PrintCommandLineFlags -XX:-OmitStackTraceInFastThrow -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true -Djava.util.Arrays.useLegacyMergeSort=true -Dfile.encoding=UTF-8
   

2. 开发工具内运行：

   经过编译后，模块的依赖会解析成功，可以直接执行com.sohu.tv.mq.cloud.Application 中的main函数即可。

3. 访问

   直接访问mqcloud_ip:8080即可，默认管理员用户名：[email protected] 密码为：admin