數據可視化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/#/