FineBI對接DB2實現配置服務- FineBI帮助文档 FineBI帮助文档

1. 概述

帆軟應用中，管理者往往會在平台設定使用者、掛載目錄、分配權限、設定排程管理。這些配置，均儲存於配置庫中。

在正式環境下，使用者可準備一個DB2資料庫，與帆軟應用對接，用於配置儲存。穩定的外部資料庫，可確定帆軟應用在高負載下的穩定運作。

本文主要講解帆軟專案對接DB2資料庫，儲存工程配置資訊：

使用者可自行準備一個DB2資料庫的表空間，並進行參數調優
在專案部署好後，可將專案與該配置庫對接

2. 準備配置庫

使用者需要自行準備並部署DB2資料庫和表空間。

帆軟不提供相關資料和指導，僅對必要內容進行指明，請查閱資料庫官網獲取其他幫助。

如維運能力不足，推薦使用維運平台部署新專案時，勾選「部署MySQL8」即可，無需手動部署和調優。

2.1 資料庫版本

本文列出的是帆軟測試透過的環境。

本文未提及的更低版本，一般預設不支援，或存在一些漏洞，不建議使用
本文未提及的更高版本，使用者可自行測試驗證。如果出現問題，付費使用者可聯絡技術支援獲取幫助。技術支援聯絡方式：「服務平台>線上支援」

資料庫類型	資料庫版本
DB2	8.2、9.7、10.5、11.1

2.2 伺服器配置

配置類型	最低配置	推薦配置	注意事項
記憶體	1GB	2GB	記憶體，是指分配給配置庫的記憶體，而非伺服器的所有記憶體如有條件，建議配置庫獨佔一台伺服器如條件不足，至少確定部署配置庫的伺服器中，不部署帆軟應用以外的任何內容，且確定分配給配置庫的記憶體足夠
CPU	4核	8核	-
網速	50Mbps	100Mbps	配置庫和應用工程、其他組件建議在同一網段，避免網路波動等問題配置庫和應用工程、其他組件之間需要網路暢通，互相埠可存取
finedb佔用空間	1GB	2GB	佔用空間，請結合工程使用度進行調整建議根據推薦配置，增大1~2倍，預留足夠空間
伺服器磁碟空間	100GB	200GB	-
磁碟讀寫速度	50MB/s	100MB/s	-

2.3 建立表空間

不同帆軟工程，不可共用同一個資料庫表空間作為配置庫，否則資料可能會出現錯亂。

因此建議在資料庫中建立一個表空間，用於儲存相關配置資料。

標準建立表空間語句：CREATE SCHEMA FINEDB

表空間名稱只允許包含數字、字母、底線和「.」
該表空間內不建議存放其他任何資料，包括業務資料、日誌資料等。

2.4 配置日誌空間

如果配置庫資料量過大，而日誌空間又不足，很可能在配置程式中出錯（SQLCODE=-964, SQLSTATE=57011）。

所以需要提前確定DB2資料庫的日誌空間足夠。

	步驟	語句
1	查看DB2資料庫的日誌配置	get db cfg for <DATABASENAME>
2	修改DB2資料庫的日誌檔案大小限制	db2 update db cfg for <DATABASENAME> using LOGFILSIZ 8192
3	修改DB2資料庫的主日誌檔案個數限制	db2 update db cfg for <DATABASENAME> using LOGPRIMARY 50
4	修改DB2資料庫的輔助日誌檔案個數限制	db2 update db cfg for <DATABASENAME> using LOGSECOND 20
5	再次查看DB2資料庫的日誌配置	get db cfg for <DATABASENAME>

2.5 準備配置庫資訊

請準備好表空間的相關資訊，用於接入專案作為配置庫。

設定項	說明
資料庫名稱	2.3節，在資料庫建立的表空間名稱表空間名稱只允許包含數字、字母、底線、「-」和「.」
主機	資料庫所在伺服器的IP
埠	資料庫佔用的伺服器埠
帳號	資料庫的用戶名稱 1）所準備的使用者需要具備 create、delete、alter、update、select、insert、index 權限，以滿足配置表架構調整、配置資訊調整等訴求 2）由於資料庫模式一般選擇使用者同名模式，因此帳號稱建議僅包含數字、字母，不建議包含特殊字元
密碼	資料庫的用戶密碼配置庫對接成功後，請勿輕易修改所使用的資料庫帳號和密碼，否則會導致工程啟動失敗
模式	即為所準備的資料的帳號稱

3. 專案接入配置庫

支援在以下情況下接入DB2配置庫，請根據情況自行選擇即可。

3.1 維運平台叢集管理接入

在維運平台的「叢集管理」中，可為專案接入自備的DB2資料庫作為配置庫。

3.1.1 帆軟專案上傳驅動

帆軟專案中，預設未內建DB2相關驅動，需要手動上傳。請務必執行本節，否則無法成功對接。

1）前往IBM官網，下載資料庫對應版本的驅動包： IBM 官網

2）參考文檔，將驅動上傳到專案中：驅動管理

3.1.2 確定單應用存活（多應用服務工程須完成，單應用服務工程無需）

對於多應用專案，需要確定接入/遷移配置服務時僅存活一個應用節點。

管理者登入維運平台，選中指定專案。點選「維護>組件管理」。檢查是否有多個「bi-web」容器存活。

如果有，請點選容器的「停止」按鈕，確定將其他「bi-web」容器關停至「exited」狀態，僅保留一個容器存活。

3.1.3 配置外接配置庫

1）管理者登入維運平台，選中指定專案。

2）點選「維護>叢集管理」，對「外接配置庫」進行配置。

3）填寫資料庫資訊：

資料庫類型：選擇「DB2」
驅動：無需調整，選擇「com.ibm.db2.jcc.DB2Driver」即可
資料庫名稱、主機、埠、帳號、密碼：填寫2.5節準備的配置庫資訊即可

4）選擇「模式」：

正確填寫完上面的所有配置後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式
優先選擇與資料庫使用者同名的模式

5）填寫資料連結URL：

一般無需手動修改，會由其他配置和預設參數共同組成

6）選擇是否「遷移資料至要啟動的資料庫」

情況	新DB2配置庫情況
希望使用當前專案原有配置	1）必須勾選「遷移資料至要啟動的資料庫」 2）專案與該配置庫對接成功後，會將工程原有配置資料，遷移到該表空間中 3）無論準備的新DB2表空間中是否有資料，均會被清空，無法找回
希望使用其他專案配置（例如將正式環境配置，copy一份給測試環境使用）	1）自行將準備的配置資料上傳到新DB2表空間中必須確定所準備的資料，對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致，否則無法使用 2）不勾選「遷移資料至要啟動的資料庫」 3）專案與該配置庫對接成功後，會使用表空間中的資料，作為專案的配置 4）專案原有配置的對接資訊，會備份到工程config目錄下的db.properties.bak檔案中

情況

新DB2配置庫情況

希望使用當前專案原有配置

1）必須勾選「遷移資料至要啟動的資料庫」

2）專案與該配置庫對接成功後，會將工程原有配置資料，遷移到該表空間中

3）無論準備的新DB2表空間中是否有資料，均會被清空，無法找回

希望使用其他專案配置

（例如將正式環境配置，copy一份給測試環境使用）

1）自行將準備的配置資料上傳到新DB2表空間中

必須確定所準備的資料，對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致，否則無法使用

2）不勾選「遷移資料至要啟動的資料庫」

3）專案與該配置庫對接成功後，會使用表空間中的資料，作為專案的配置

4）專案原有配置的對接資訊，會備份到工程config目錄下的db.properties.bak檔案中

7）點選「啟動資料庫」，提示「遷移成功」，即代表可正常對接。

3.1.4 確定多應用配置同步（多應用服務工程須完成，單應用服務工程無需）

1）copydb.properties檔案

前往唯一存活的「bi-web」容器所在伺服器，複製該組件外掛目錄/config資料夾中的db.properties檔案。

逐一貼上到其他「bi-web」容器所在伺服器的組件外掛目錄/config資料夾中。

2）停止所有應用

管理者登入維運平台，選中指定專案，點選「維護>組件管理」

請對「bi-web」組件進行一鍵「停止」，確定所有「bi-web」容器關停至「exited」狀態。

3）啟動所有應用

管理者登入維運平台，選中指定專案，點選「維護>組件管理」。

請對「bi-web」組件進行一鍵「啟動」，確定所有「bi-web」容器啟動至「running」狀態。

3.2 管理系統接入配置庫

在帆軟應用的「管理系統>管理系統>標準」中，可接入自備的資料庫作為配置庫。

3.2.1 帆軟專案上傳驅動