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.0.0.sql,包含数据表结构和测试数据,直接运行导入即可。
如果是从之前的版本升级上来的,请在原有数据库基础上执行update-2.0.0.sql进行数据库升级。
2.3.调整配置
系统的配置文件都在sitesCMS/src/main/resources这个目录下面,先简单的看下需要修改的基本配置。
cmsConfig.txt
1.需要调整数据库的地址、端口、名称、用户名、密码、秘钥,出于安全性考虑数据库的密码是加密的,可以使用com.sites.common.kit.DruidKit对数据库密码进行加密。工具类使用很简单,输入自己的明文密码,运行main方法即可得到需要的加密后的密码和秘钥;
2.修改文件上传路径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 --->点击 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官方手册中部署章节内容。
另外,我还录制了一套JFinal从入门到实战视频教程【60集】课程,里面打包部署章节是免费试学的,大家也可以参考下。后续考虑针对sitesCMS专门录制一套介绍课程,当然这是后话。
4.常见问题
1.图片/文件访问不到:系统默认访问的图片或者文件是作者开发本地上传的,路径、文件名都是开发者本地的,首次运行没有图片或者文件是正常的,这个只需要在后台重新上传一次就可以了。如果想要作者使用的图片请关注微信公众号sitesCMS并发送关键字“图片获取”;
2.发布后启动报错,提示cmsLayout.html模板找不到,这个很有可能就是上述3.2中的配置undertow.resourcePath没有修改或者配置项不对,建议重点观察该配置项;
3.idea导入报错或者不能运行,解决方案参考这里 https://gitee.com/xhhxb/sitesCMS/issues/I22M2U