搭建Qcadoo

前言

项目需要用到mes系统，选择基于一个叫qcadoo（我喜欢读Q卡度/奇卡多）开源mes项目来进行开发

官方文档:

Installation manual - Qcadoo - Developer Documentation - Quonfluence
Installation Guide for Windows - English - Qcadoo - Developer Documentation - Quonfluence
主要参考的是这个，基于源代码的方式构建Building MES from source code - tutorial - Qcadoo - Developer Documentation - Quonfluence

参考教程：

阿里云CentOS安装Qcadoo开源MES（制造执行系统） - 简书 我按照这个教程一步步搭下来成功了。期间需要注意的是maven的版本，我把版本换成这篇文章里的3.6.2之后就可以正常mvn install了。
How to Build and Debug qcadoo MES? - soong的文章 - 知乎

搭建过程

1. 安装jdk1.8
2. 安装 Postgres 数据库，官方使用Postgres ，其他数据库需要找对应版本，以及配置
   Windows 上安装 PostgreSQL | 菜鸟教程
3. （需要了解git相关知识，并且电脑配置好git）在新建的qcadoo文件夹下用git bash从github上面用如下指令拉取qcadoo的4个项目，按顺序分别是qcadoo-super-pom-open、qcadoo-maven-plugin、qcadoo和mes。推荐每拉取一个就先mvn clean install，然后构建完再拉取下一个。

git clone git@github.com:qcadoo/qcadoo-super-pom-open
git clone git@github.com:qcadoo/qcadoo-maven-plugin
git clone git@github.com:qcadoo/qcadoo
git clone git@github.com:qcadoo/mes

• 在编译qcadoo项目的时候遇到的Please refer to E:\qcadoo\qcadoo\qcadoo-model\target\surefire-reports for the individual test results.报错，根据这篇文章解决解决：target\surefire-reports for the individual test results_东天里的冬天-CSDN博客 。
• 在拉取mes项目的时候会遇到文件名过长没法下载的问题，error: unable to create file src/main/webapp/xxxxxx/xxxx: Filename too long
  解决方案：git for windows下的Filename too long_赶路人儿-CSDN博客

4. （需要了解maven相关知识，并且电脑配置好maven，推荐使用阿里云镜像，下载速度比较快）然后在git bash中按照拉取的顺序依次mvn clean install，期间可能会因为maven版本（建议使用3.6.2，还有一种说法是推荐使用3.5版本）或者使用阿里云镜像遇到包下载失败/未找到相关依赖的问题。根据提示的报错信息依次百度搜索解决方案。
   和上一步合并之后的操作指令如下：

git clone git@github.com:qcadoo/qcadoo-super-pom-open
git clone git@github.com:qcadoo/qcadoo-maven-plugin
git clone git@github.com:qcadoo/qcadoo
git clone git@github.com:qcadoo/mes
cd qcadoo-super-pom-open
mvn clean install
cd ../qcadoo-maven-plugin
mvn clean install
cd ../qcadoo
mvn clean install # 这一步发生了错误
cd ../mes
mvn clean install

5. 每个项目依次build seccess之后，开始创建数据库
6. 创建数据库，我用的是pgAdmin可视化界面直接创建一个名字叫mes的数据库，按照这个教程来安装qcadoo开源MES的几个坑_数据之路-CSDN博客
   • 第4条关于数据库密码的问题，因为我设置的密码不是postgres123，所以我在mes\mes-application\conf\tomcat\db.properties中更改dbPassword=密码为自己安装postgre时候设置的密码，官方给的修改地址在我的mes-application中并没有。但是最后运行tomcat的时候虽然tomcat成功启动，但是却提示我找不到 localhost 的网页。然后我在日志中查看，发现是密码错误的问题。我这个直接修改配置文件的操作是错误的
   • 我重装了postresql之后使用pgadmin登录还是提示我密码错误，然后我直接使用输入密码框下方的reset密码，重置了密码
7. 在git bash中使用cd命令进入mes/mes-application并编译，官网使用的是mvn clean install -o -Ptomcat -Dprofile=package命令，但是这样会报错，
   如果把-o去掉就不会了：mvn clean install -Ptomcat -Dprofile=package
   （记录成功时刻）
   
8. 编译完成之后，开始启动mes，在git bash中把当前目录导航到mes/mes-application/target/tomcat-archiver/mes-application下
   官方的命令cd mes/mes-application/target/tomcat-archiver/mes-application有问题,最后要加一个/。
   具体命令要根据自己当前所在路径来，比如我现在已经在mes/mes-application了，那么只需要cd target/tomcat-archiver/mes-application/
9. 在上一步的目录下git bash中赋予 tomcat 脚本执行权限：
   chmod a+x bin/*.sh
10. 在第8步的目录下git bash中启动mes：
    ./bin/startup.sh
    （记录成功时刻）
    
    localhost:8080启动的时候有点慢，耐心等待一下
    
11. 在git bash中关闭 MES:
    ./bin/shutdown.sh
    
12. 默认用户: admin，password: admin。
    Superadmin 用户: superadmin，password: superadmin(从这个用户开始，向组添加访问角色!)
13. 查看日志：在 mes/mes-application/target/tomcat-archiver/mes-application/Logs/目录中找到。
    大多数情况下，你会在 root.log 文件中找到你需要的信息，例如你的实例是否正确启动，发现错误的详细信息等等。
14. 使用程序
    1. Login as superadmin.以超级管理员的身份登录
    2. Go to ‘Administration’ → ‘Groups’. 进入‘管理’→‘团体’
    3. Click the right group on a list - the one that is related to the user you want to log in. Next, go there.单击列表中与要登录的用户相关的右组。下一步，去那里
    4. Select all available roles. Save your choice.选择所有可用的角色。保存您的选择
    5. Log out. 退出
    6. Log in the account again.再次登录帐户

总结：

主要还是跟着官网文档一步步操作，但是官网有些地方写的并不是让人很明白，甚至有些操作指令是有坑的，所以推荐对照着其他人的搭建过程来进行。