数据可视化BI平台——CBoard的部署与使用（笔记整理）

CBoard作为国内自主开发的数据可视化平台，因其方便好用而受到广大用户的使用和好评。现今CBoard有社区版和企业版两个版本，本文所述为社区版的0.4.2版本。
注意：所需的一切资源以及相关参考链接都在本文文末！！！

一、准备与安装

1. JDK1.8

直接安装到指定位置，然后为它配置环境变量。

配置环境变量：右击“我的电脑”–>“属性”–>“高级系统设置”–>“高级”–>“环境变量”

在系统变量里新建"JAVA_HOME"变量，变量值为：C:\Program Files\Java\jdk1.8.0_172（根据自己的jdk的安装路径填写）
在系统变量里新建"classpath"变量，变量值为：.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar (注意最前面有一点)
找到path变量（已存在不用新建）添加变量值：%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
“Windows+R”–>输入“cmd”–>Enter，输入java -version(记得中间有个空格)，如果显示jdk版本信息就说明环境变量配置成功了。

注意：
变量值之间用";“隔开。注意原来Path的变量值末尾有没有;号，如果没有，先输入;号再输入。如果你的系统是Windows10，就相对方便多了，不用担心这个”;"。

2. Maven 3.6

CBoard项目需要使用maven编译，所以先下载并解压maven，并配置环境变量。

在系统变量中新建“MAVEN_HOME”，变量值为maven的安装路径。
在环境变量的path中添加变量值：；%MAVEN_HOME\bin；
配置完成后在命令行cmd 运行mvn -version查询对应的版本号，显示信息则说明配置成功。

配置文件setting.xml（在maven安装目录的conf文件夹中）的简单配置

配置创建项目时默认的jdk版本，在标签中添加,这样每次update项目的时候就会变为默认的jdk版本，这里是默认全局设置的编译版本。

<profile>
        <id>jdk-1.8</id>
        <activation>
            <activeByDefault>true</activeByDefault>
            <jdk>1.8</jdk>
        </activation>
        <properties>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
        </properties>
</profile>

配置私有仓库的位置（maven所有的本地jar包都会放在私有仓库里面），其默认位置是当前用户目录下.m2文件夹中。通过修改下面的路径可以修改本地仓库的位置。
配置中央仓库，使用阿里云仓库作为中央仓库的镜像，因为国外的仓库访问非常慢。

<mirror>
      <id>nexus-aliyun</id>
      <mirrorOf>central</mirrorOf>
      <name>Nexus aliyun</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

3. Tomcat 9.0

安装Tomcat之后，配置环境变量。

在系统变量新建CATALINA_BASE变量
变量名：CATALINA_BASE
变量值：D:\Program Files\Apache Software Foundation\Tomcat 9.0
（Tomcat安装位置，即bin文件所在位置）
在系统变量新建CATALINA_HOME变量
变量名：CATALINA_HOME
变量值：D:\Program Files\Apache Software Foundation\Tomcat 9.0
（变量值同上，填Tomcat的安装位置）
在环境变量中找到Path变量，点击编辑
变量名：Path
变量值： ;%CATALINA_HOME%\bin;
（不要删除原有path变量值，直接在最后一行添加上这一句即可）

这样Tomcat就配置好了。打开cmd命令提示符，输入`startup`后回车，就可以看到Tomcat成功启动了。（或者直接双击Tomcat安装路径中的bin文件中的startup.bat文件）

在浏览器地址栏输入localhost:8080或127.0.0.1:8080，验证Tomcat是否配置成功。

4. PhantomJS 2.1

如果要使用看板导出和邮件功能，需要安装PhantomJS 2.1+，下载PhantomJS后直接解压到想要安装的位置即可。

5. MySQL

安装MySQL

打开刚刚下载好的安装包，开始安装MySQL。
选择 I accept 然后点击next进入下一步。
选择Server Only，然后点击next进入下一步。
之后的除了要记住后面自己设置的root密码之外，基本都是点击execute或者next按钮就行了。

配置MySQL环境变量

创建一个my.ini文件放到MySQL数据库安装路径的bin目录下，内容如下。

#  power by phpStudy  2014  www.phpStudy.net  官网下载最新版
 
[client]
port=3306
[mysql]
default-character-set=utf8
 
[mysqld]
port=3306
basedir="D:/Program Files/MySQL/MySQL Server 5.7"
datadir="D:/Program Files/MySQL/MySQL Server 5.7/data/"
#以上路径请与自己的安装路径对应
 
character-set-server=utf8
default-storage-engine=MyISAM
#支持 INNODB 引擎模式。修改为　default-storage-engine=INNODB　即可。
#如果 INNODB 模式如果不能启动，删除data目录下ib开头的日志文件重新启动。
 
sql-mode="NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
max_connections=512
query_cache_size=0
#table_cache=256
tmp_table_size=18M
thread_cache_size=8
myisam_max_sort_file_size=64G
myisam_sort_buffer_size=35M
key_buffer_size=25M
read_buffer_size=64K
read_rnd_buffer_size=256K
sort_buffer_size=256K
#innodb_additional_mem_pool_size=2M
#innodb_flush_log_at_trx_commit=1
#innodb_log_buffer_size=1M
#innodb_buffer_pool_size=47M
#innodb_log_file_size=24M
#innodb_thread_concurrency=8
 
explicit_defaults_for_timestamp=true
 
max_allowed_packet=500M
wait_timeout=288000
interactive_timeout=288000

新建数据存放目录
配置环境变量：在环境变量的path中添加：D:\Program Files\MySQL\MySQL Server 5.7\bin;（MySQL中bin文件夹的路径）
在cmd中用net start mysql 启动服务（一般安装时就会启动，可不做）

安装Navicat

强大的数据库管理和设计工具（有其他的工具也行），下载后直接解压到想要安装的位置即可。

导入CBoard初始数据。（初始数据很重要，是CBoard能否成功运行的关键，下载链接在文末）

新建一个数据库连接（注意端口号默认为3306），然后新建一个数据库cboard。
右键->运行SQL文件
运行完毕并且不报错的话，关闭Navicat中数据库连接（cboard），然后重新打开就可以看见下面的表格了。
同理，新建第二个数据库连接footmart，导入第二个SQL文件。

6. CBoard 0.4.2

可以在文末链接下载0.4.2版本，网速较快也可以在GitHub中下载最新版CBoard下载链接。
Git下载语句：

git clone https://github.com/yzhang921/CBoard.git

7. Chrome浏览器(官方要求)

二、修改配置文件并部署

1. 修改配置文件

用IDEA打开解压后的CBoard，当然本文的操作方式也可以不用IDEA，直接打开CBoard文件夹中的文件修改即可。

打开src/main/resources/config.properties，修改初始数据库配置信息以及phantomjs的安装路径。

打开src\main\webapp\org\cboard\Settings.js，修改语言为cn，使CBoard显示为中文。

2. 编译源代码

下载依赖包（该操作需要确保maven配置成功）

在cmd中运行该命令：

mvn install:install-file -Dfile=lib/sqljdbc4-4.0.jar -DgroupId=com.microsoft.sqlserver -DartifactId=sqljdbc4 -Dversion=4.0 -Dpackaging=jar

编译

在cmd中运行该命令：

mvn clean package

3. 部署

拷贝cboard.war

拷贝CBoard安装目录下的target\cboard.war到tomcat安装目录下webapps目录，tomcat会自动解析cboard.war。

在Chrome浏览器中输入`http://127.0.0.1:8080/cboard/login.html`

登录CBoard

默认登录用户名和密码: admin/root123

三、CBoard的使用

1. 数据源

CBoard支持多种数据源（JDBC，Kylin，Saiku，等），不过我们目前最常用的还是JDBC。按照标准的JDBC连接字符串格式填入参数即可，如下图我使用的是MySQL作为数据仓库。

2. 数据集

CBoard中的数据集，就是Cube。所以创建数据集的过程，也就是设计维度，层次，度量的过程。（命名前缀为它所在文件夹）
设计数据集步骤如下图：

3. 图表设计

图表设计可以使用数据已有的数据集，也可以新建查询。使用非常简单，就和设计EXCEL透视表一样，拖放行，列，指标，然后预览微调。有透视表使用经验即可快速上手，如下图：

4. 看板设计

看板设计就是利用已有的图表进行排放，一般使用网格布局的比较多，其中的一些功能可以探索下，这里简单截个图看看：

看板预览效果如下：

5. 其他

定时任务、资源分享以及用户管理等比较简单明了，仔细研究下就知道如何使用了。

四、链接汇总

1. 所需的一切资源下载链接

链接：https://pan.baidu.com/s/1G0tXxMvtEkyqGp5iVVFYGQ
提取码：dqrk
复制这段内容后打开百度网盘手机App，操作更方便哦！

2. 参考资料链接

JDK：https://www.cnblogs.com/xch-yang/p/7629351.html
Maven：https://www.cnblogs.com/kyleinjava/p/9549481.html
Tomcat：https://jingyan.baidu.com/article/e8cdb32be15b0437052bad17.html
CBoard：https://www.cnblogs.com/zimo-jing/p/9868970.html，https://juejin.im/post/5b4ee1c2f265da0f5d4cc978
官方链接：https://peter_zhang921.gitee.io/cboard_docsify/#/