cboard企业版源码_数据可视化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版本，这里是默认全局设置的编译版本。

jdk-1.8

true

1.8

1.8

1.8

1.8

配置私有仓库的位置(maven所有的本地jar包都会放在私有仓库里面)，其默认位置是当前用户目录下.m2文件夹中。通过修改下面的路径可以修改本地仓库的位置。

配置中央仓库，使用阿里云仓库作为中央仓库的镜像，因为国外的仓库访问非常慢。

nexus-aliyun

central

Nexus aliyun

http://maven.aliyun.com/nexus/content/groups/public

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 2014www.phpStudy.net 官网下载最新版[client]port=3306

[mysql]default-character-set=utf8[mysqld]port=3306basedir="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=512query_cache_size=0#table_cache=256tmp_table_size=18M

thread_cache_size=8myisam_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=8explicit_defaults_for_timestamp=true

max_allowed_packet=500M

wait_timeout=288000interactive_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. 所需的一切资源下载链接

2. 参考资料链接