Davinci配置部署出坑指南

Davinci是一个开源的图表可视化编辑项目，包括前端跟后台工程。启动项目后可以导入数据源、配置数据视图、配置小组件、设计显示面板和大屏等，并可将设计好的页面生成链接进行发布。

github地址：https://github.com/edp963/davinci

操作文档地址：https://edp963.github.io/davinci/docs/zh/1.1-deployment

davince版本：davinci-0.3.0-beta.8 release

以下是在开发过程中碰到的一些坑：

• 运行项目前要准备的东西
  JDK 1.8（或更高版本）
  MySql5.5（或更高版本）
  Mail Server
  phantomjs 或 chrome（需同时安装chromedriver，清注意版本）
  Redis（可选）
  这里做下说明：
  Mail Server 指的是准备好一个免费的邮箱，并开通SMTP服务且在邮箱设置开启客户端授权码（有的邮箱叫客户端独立密码）
  phantomjs或chrome（需同时安装chromedriver，清注意版本）指的是需要安装一个特殊浏览器，用于爬取指定页面并截图的，在项目里的定时发送截图邮件会用到，推荐phantomjs，下载和安装可参考：https://blog.csdn.net/qq_37245397/article/details/81543450?tdsourcetag=s_pctim_aiomsg

• 配置启动的时候，一定要下载release版本，github上放的是源码，不是部署安装的版本
    如何下载release版本： 进入本文开头引用的github链接后，将页面拖到最后
  ​​​​
  点击release进行下载。

• 初始化数据库之前的注意事项
  比如如下初始化数据库命令：

mysql -P 3306 -h localhost -u root -p123456 davinci3 < $DAVINCI3_HOME/bin/davinci.sql

1，事先在localhost的mysql中建好名称为“davinci3”的数据库，否则运行的时候会提示找不到数据库
2，数据库名在操作文档中给的是davinci0.3，但是在mysql（版本5.6）建库的时候报错了，改为davince3后建库成功，如果这步用davince0.3建库出错可以这样改库名称试试。（如果这里数据库名称改了，后面的yml配置文件中的数据库连接串也要做对应的修改）
3，命令中的“123456”为连接数据库的密码和“-p”之间无空格

• yml配置文件，每个配置项的冒号和值之间至少要有一个空格
    这个官方操作文档明确说明了，但还是容易不小心踩坑，这里再强调一下

• yml中邮箱配置中的password项
    邮箱配置是十分必要的，再注册账号和定时发送邮件功能中，都会使用这个地方配置的邮箱来发送相应的邮件
    这里需要注意的是常见免费邮箱（如 163 邮箱、QQ 邮箱、gmail 等）这里应填客户端授权码（也叫客户端独立密码，各邮箱提供商叫法不同），这是各大邮箱为了在用户开通SMTP服务后可能导致密码泄露而设置的，可前往对应邮箱账号设置页面开启 SMTP 服务，并申请客户端授权码（或客户端独立密码）

• yml截图配置中的浏览器路径配置
    此处建议使用官方操作文档中的“ PHANTOMJS ”，phantomjs的下载和安装可以参考：
  https://blog.csdn.net/qq_37245397/article/details/81543450?tdsourcetag=s_pctim_aiomsg
    注意该配置中的“phantomjs_path”或者“chromedriver_path”配置项，填的是浏览器可执行文件在本机的绝对路径，比如以下完整配置：

screenshot:
  default_browser: PHANTOMJS        # PHANTOMJS or CHROME
  timeout_second: 600
  phantomjs_path: D:\phantomjs-2.1.1-windows\bin\phantomjs.exe
  chromedriver_path: $your_chromedriver_path$