运行部署

1.环境准备

系统原始开发环境在简介中已经介绍过了,建议参考原始开发环境进行本地环境准备,如下:

jdk >= 1.8
MySQL >= 8.0.23
maven >= 3.6.3

2.运行

2.1.源码获取

源码获取都是标准方式,不过多介绍了,可以参考下面两种方式。

方式一:直接下载压缩包

访问源码页面 https://gitee.com/xhhxb/sitesCMS , 选择【克隆/下载】,下载ZIP包,即可将全部源码下载到本地,之后使用Eclipse或者IDEA导入工作空间即可。

方式二:使用git克隆

源码的git地址同样可以在源码页面获取,完整地址为 https://gitee.com/xhhxb/sitesCMS.git , 可以使用git克隆一份到本地。

2.2.数据库准备

创建数据库

手动在本地创建数据库sitescms,编码设置为 utf8。

导入初始化数据

系统的初始化数据库sql文件是 sitesCMS/src/main/resources/sql/sitescms-all-2.2.1.sql,包含数据表结构和测试数据,直接运行导入即可。

如果是从之前的版本升级上来的,请在原有数据库基础上执行update-xxx.sql进行数据库升级。

2.3.调整配置

系统的配置文件都在sitesCMS/src/main/resources这个目录下面,先简单的看下需要修改的基本配置。

cmsConfig.txt

需要调整数据库的地址、端口、名称、用户名、密码、秘钥,出于安全性考虑数据库的密码是加密的,可以使用com.sites.common.kit.DruidKit对数据库密码进行加密。工具类使用很简单,输入自己的明文密码,运行main方法即可得到需要的加密后的密码和秘钥;

修改文件上传路径uploadPath,改为你本地的一个可用目录,用于放置上传文件。这个建议是项目外的一个磁盘目录,将文件和代码剥离开;例如:

uploadPath=G:\\upload\\

log4j.properties

根据实际情况将系统日志输出目录改为自己本地的磁盘目录,windows和Linux的路径都有参考案例,仿照着修改即可。

undertow.txt

需要修改undertow.resourcePath项,前两项内容不要动,把后面的磁盘目录改为自己上传文件的目录即可(这个要跟cmsConfig.txt中的uploadPath路径一致)。修改后的配置类似如下这种:

undertow.resourcePath = src/main/webapp,classpath:webapp,G:/upload

2.4.运行

sitesCMS使用JFinal-Undertow方式开发部署,启动的时候只需运行com.sites.common.RunApp中的main方法即可,控制台显示启动成功后即可浏览器访问。数据库中默认没有设置主站点,所以访问的是main站点,主站点可以在后台【站点管理-站点列表】中进行设置切换。

前台地址:http://localhost

后台地址:http://localhost/cms, 管理用户名为wumoxi,默认密码111111.

3.部署

3.1.打包

sitesCMS是一个标准的maven项目,你所知道的maven知识都可以用到该项目的打包部署中。由于项目中已经配置好了打包方式,所以直接进行打包即可。下面以eclipse为例简单介绍下打包过程:

  1. 右击项目--->点击Debug as --->点击 Maven install进行编译;
  2. 右击项目--->点击Debug as --->点击 Maven build,然后弹出一个对话框,在Goals中输入clean compile package,然后点击debug等到完成;
  3. 根据控制台提示定位到打包后的文件即可。

3.2.发布

前面已经提到了sitesCMS是使用的JFinal-Undertow方式开发部署的,所以发布并不需要Tomcat,将打包好的文件拷贝到服务器或者自己本地需要的目录, 修改sitesCMS\config\undertow.txt,在undertow.resourcePath配置项中添加webapp目录 ,然后运行jfinal.bat或者jfinal.sh即可启动。

jfinal.bat start

想要了解更多的打包部署方式可以详细阅读 JFinal官方手册中部署章节内容

4.视频教程

sitesCMS源码详解视频教程 已经上线了,运行部署部分可以免费试学,有需要的请 戳这里