FineBI個人試用版啟動常見問題

1.1 版本

1.1 問題描述

本文簡單介紹，FineBI工程啟動失敗的原因和解決方案。

2.1 Windows/Linux磁碟剩餘空間不足

問題描述：

FineBI啟動失敗，在%FineBI%/logs下開啟fanruan.log日誌，存在報錯在關鍵詞：

• java.io.IOException: 裝置上沒有空間

• 磁碟剩餘空間不足

原因分析：

待安裝目錄，磁碟剩餘可用空間不足。

解決方案：

1）聯絡維運，對伺服器磁碟空間進行擴容。

2）清理磁碟

使用df -h命令檢查當前各分割槽磁碟佔用大小，如下圖所示：

使用命令du -sh *查看當前目錄下每個資料夾大小，如下圖所示：

將不需要的檔案清理即可。

2.2 Mac電腦記憶體不足導致無法存取

問題描述：

啟動FineBI，進程還在，但無法存取工程，提示「找不到主機」。

原因分析：

部署在個人Mac電腦時，記憶體預設分配為1.2g。若電腦總記憶體過小，或其他軟體佔用了大量記憶體，導致剩餘可用記憶體過小，則會出現該問題。

解決方案：

1）建議更換一個伺服器部署，提升硬體配置。

2）如需繼續在該裝置啟動工程，建議在啟動FineBI時，關閉其他無用進程，保證充足的可用記憶體。

3.1 未使用管理者權限啟動BI

Windows系統，推薦使用管理者身分運作FineBI。如下圖所示：

3.2 檔案權限不足

問題描述：

FineBI啟動失敗，在%FineBI%/logs下開啟fanruan.log日誌，存在報錯在關鍵詞：

• permission denied

• Database is not initialized

原因分析：

啟動工程的使用者權限不足

解決方案：

請檢查下使用者讀寫權限，可使用命令chmod -R 777，給對應資料夾配置權限。

3.3 臨時目錄建立失敗

問題描述：

FineBI啟動失敗，在%FineBI%/logs下開啟fanruan.log日誌，存在報錯在關鍵詞：

• Failed to create local dir in /home/ap/bin/ROOT/temp/spark

原因分析：

啟動工程的使用者權限不足，導致spark臨時目錄建立失敗

解決方案：

請檢查下使用者讀寫權限，可使用命令chmod -R 777，給臨時目錄對應路徑配置權限。

4.1 內部檔案錯誤

問題描述：

FineBI啟動失敗，報錯提示為An internal ereor occurred(error code:34)

原因分析：

下載的安裝包不完整。

解決方案：

重新下載安裝包安裝。

4.2 解壓縮失敗導致閃退

問題描述：

Windows系統，安裝包部署後出現閃退的情況，日誌停在start unzip file:D:\app\FineBI5.1\...\assist\update\update.zip

原因分析：

啟動卡在解壓縮插件檔案的步驟 ，關鍵詞start unzip

解決方案：

手動把插件的壓縮檔案解壓縮之後放到plugins資料夾裏，即可啟動成功

工程啟動異常或失敗時，需要依次檢查以下進程問題。

5.1 FineBI重複啟動兩個執行緒

1）輸入命令 ps -ef|grep java ，查看當前路徑下的BI 啟動了多少執行緒，如下圖所示：

2）若有多個執行緒則全部結束，輸入 kill -9 進程號，如下圖所示：

5.2 FineBI埠被佔用

問題描述：

部署後閃退/前端無法存取，日誌裏有關鍵詞Address already in use

原因分析：

埠號埠號只能被一個進程佔用。FineBI啟動所需的埠目前被其他進程佔用中。

解決方案：

1）使用lsof -i:埠號 命令檢查當前埠是否被佔用，若如下圖所示，則表示埠未被佔用：

注：若報錯-bash: lsof-i:xx: command not found，則需要輸入命令 yum install lsof ，才能使用 lsof 命令。

若如下圖所示，則表示進程 ID 為 8152 的 java 應用佔用 80 埠：

2）埠號只能被一個進程佔用，若當前埠號已經被佔用，則需要將 BI 伺服器的埠號調整為未被佔用的埠號。

詳情參見：修改FineReport工程埠 、如何修改FineBI埠號 。

5.3 webapps目錄下存在多個工程/沒有工程

進入 BI 安裝目錄，查看 %FineBI%\webapps 目錄下是否有多個webroot檔案或沒有檔案。

若沒有，需要將安裝的 webroot 檔案放置在 webapps 下，如下圖所示：

注：備份檔案都以壓縮資料夾形式存放，或者把備份檔案copy到非工程所在目錄，確定 Web 容器裏只有一個名為webroot的工程。

5.4 db.lck 檔案報錯

Windows 使用其他工具開啟 FineDB 資料庫並且未關閉，檢查是否有其他軟體連結 FineDB 內建資料庫，如果有，需要關閉工程並重啟 BI 。

6.1 UnknownHostException

問題描述：

FineBI啟動失敗，介面報錯61300110Spider計算引擎服務初始化異常

查看%FineBI%/logs日誌，報錯為UnknownHostException

解決方案：

登入安裝伺服器，查看hosts檔案（Linux為/etc/hosts，Windows通常在C盤下），新增該伺服器IP和對應hostname。

6.2 獲取hostname失敗

問題描述：

FineBI存取失敗，前端提示「獲取hostname失敗，請檢查伺服器hostname是否正常或重新配置hostname」

原因分析：

伺服器hosts檔案中，沒正確配置好映射關係

解決方案：

根據hostname命令傳回的值，配置到/etc/hosts檔案中，配置127.0.0.1 具體的hostname

7.1 安裝FineBI後，沒有配置管理者帳號密碼介面？

該問題需要排查下是否之前安裝過 FineBI ，此處使用了之前安裝過的路徑重新安裝。

若安裝過，需將之前安裝的版本完全卸載乾淨再重新安裝。

7.2 tools.jar異常

問題描述：

Mac環境下，FineBI部署到tomcat中，啟動工程時報錯「tools.jar異常」

原因分析：

tomcat部署，使用的tools.jar必須和環境變數中配置的jdk相一致。

解決方案：

1）設定好正確的JAVA環境路徑。

2）更換tools.jar。