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版本,这里是默认全局设置的编译版本。
<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/#/
Linux安装参考:https://blog.csdn.net/m0_67239058/article/details/129307602
本文参考:https://www.cnblogs.com/bigcousin/p/cboard.html