1. 概述
1.1 版本
FineBI 版本 | JAR 包 | 新增功能 |
|---|---|---|
| 5.0 | 2019-06-14 | - |
| 5.1.10 | - | 伺服器部署精靈頁面中，外接資料庫配置資訊介面中支援設定資料連結 URL |
| 5.1.15 | - | 外接資料庫資料更改後，外接資料庫使用者若沒有相關權限，例如：create、alter，工程啟動後會進入部署精靈頁面，給出提示 |
1.2 應用場景
在進行伺服器部署時，會出現部署失敗的情況，而導致失敗的原因有很多種，此時就需要提供一個頁面或者工具來引導使用者檢查並修復問題。
1.3 功能簡介
在伺服器部署失敗時，引導使用者及時檢查並修復問題，進而成功部署。
2. 前期準備
配置容器環境如下表所示：
| 容器 | 說明 |
|---|---|
| Tomcat | JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上，詳細請參見 Tomcat伺服器部署 |
| Weblogic | JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上，詳細請參見：Weblogic伺服器部署 |
| Wildfly | 詳細請參見：Wildfly(JBoss)9~18伺服器部署、Wildfly(JBoss)8伺服器部署 |
| WebSphere | 詳細請參見：Linux 系統 Websphere 伺服器部署 |
| Resin | 詳細請參見：Resin伺服器部署 |
| Docker | 詳細請參見：Docker 部署 FineBI |
3. 伺服器部署精靈檢查內容
3.1 tools.jar
3.1.1 tools.jar 不匹配
tools.jar 不匹配時，報錯內容如下圖所示：
3.1.2 工程缺少 tools.jar
工程缺少 tools.jar 時，報錯內容如下圖所示：
3.2 資料庫
3.2.1 內建資料庫連結失敗
內建資料庫連結失敗時，報錯內容如下圖所示：
3.2.2 外接資料庫連結失敗
外接資料庫連結失敗時，報錯內容如下圖所示：
修改外接資料庫相關配置後，點選「重新檢查」，連結成功則直接啟用新的資料庫；若連結的資料庫無表資訊，則提示目標資料庫為新資料庫，無法使用
3.3 websocket 埠異常
websocket 埠衝突時，報錯頁面如下圖所示：
3.4 沒有外接資料庫相關權限
外接資料庫資料更改後，外接資料庫使用者若沒有相關權限，例如：create、alter，工程啟動後會進入部署精靈頁面，給出提示。如下圖所示：
注：外接資料庫使用者，在升級時若沒有資料庫相關權限，則會給出提示，終止升級。
4. 範例
這裏以 Tomcat 容器為例進行示範。將 %BI_HOME%/webapps/webroot資料夾複製到 %TOMCAT_HOME%/webapps 資料夾下，啟動 Tomcat。
4.1 跳轉部署精靈頁面
工程啟動失敗後，訪問平台http://localhost:8080/webroot/decision，webroot 工程啟動失敗，自動跳轉到伺服器部署精靈頁面 http://localhost:8080/webroot/decision/v10/deployment/recommendation，如下圖所示：
4.2 根據提示操作
將%JAVA_HOME%\jdk\lib下的 tools.jar copy到%Tomcat_home%\webapps\webroot\WEB-INF\lib資料夾下，如下圖所示：
4.3 部署成功
重啓 Tomcat ，此時再次存取平台http://localhost:8080/webroot/decision，跳轉到登入頁面，即部署成功。如下圖所示：