一、FineBI端口開放清單
1. 概述
在安裝完成 FineBI 後，伺服器需要開放一些端口供系統監聽使用。對于伺服器安全要求高的客戶來說，在啟動之前需要保證這些端口的開放，否則 FineBI 無法正常啟動。
2. Spider 單機部署開放端口
注：若使用了 Nginx 伺服器，則可能需要單獨修改 Requestport，詳情參見：Nginx 常見報錯及解決方案。
二、FineBI安裝目錄結構
1. 概述
在 FineBI 安裝完成以後，進入安裝目錄可以看到安裝檔案。FineBI 安裝檔案本質上就是一個 Tomcat 。本文詳細介紹安裝目錄結構。
2. 安裝根目錄
每個檔案存放的内容如下表所示：
| 檔案 | 内容 |
| .install4j | FineBI 的圖檔 |
| bin |
|
| jre | 是在 Java 運作環境下支援 Java 應用程式 |
| lib | 存放 BI 啟動的時候的加載動畫的 JAR 包 |
| logs | 包含工程運作日志、GC日志注：清空一般不會對運作帶來影響。 |
| server | Tomcat 的根目錄，包含 Tomcat 的配置檔案夾以及 Tomcat 自帶的依賴檔案夾 |
| temp |
|
| webapps | 存放應用程式，當服務啟動時會去加載 webapps 目錄下的應用程式 |
| FineBI5.1 幫助文檔 .chm | FineBI5.1 版本的離線幫助文檔 |
| LICENSE | 許可證，裡面記錄了 Tomcat 的一些條款等等 |
| NOTICE | 記錄 Tomcat 的新的通知，公告 |
| RELEASE-NOTES | 記錄的是發行版本的說明，一些捆綁的 API ，新特性等等 |
| RUNNING.txt | 記錄 Tomcat 的運作環境以及怎樣配置參數，變量，啟動等等 |
| uninstall.exe | 自帶解除安裝 exe ，輕按兩下即可調用解除安裝功能 |
3. webroot 目錄
每個檔案存放的内容如下表所示：
| 檔案 | 内容 |
| backup | 存放工程備份檔案，包含平台配置備份、jar備份、插件備份等 |
| Demo_files | 存放工程自帶的 DEMO 展示需要的檔案 |
| logs | 存放日志檔案，記錄系統登入資訊、模闆通路資訊、報錯資訊等 |
| scripts | 存放插件相關檔案 |
| WEB-INF | BI 工程主目錄 |
| FRDemo.db | 内置 Sqlite 資料庫檔案 |
| test.mv.db、test.trace.db | 内置 H2 資料庫檔案 |
| Web元件.html | 這是一個 Web 元件，寫入的超連結位址即可。比如這是一個自定義的 HTML 檔案，内置在工程内部 %/webroot/這個目錄之下 |
4. WEB-INF 目錄
每個檔案存放的内容如下表所示：
| 檔案 | 内容 |
| assets | 資源檔案夾，存放工程用到的資源檔案等 其中 temp_attach 中存放着上傳的圖檔和 Excel 資料。 |
| assist | 輔助檔案夾，存放一些輔助檔案 |
| classes | class 檔案存放目錄 |
| dashboards | BI 模闆儲存檔案夾 |
| embed | 内置資料庫配置目錄 |
| lib | BI 工程依賴的 JAR 封包件夾 |
| reportlets | 存放 FineReport 報表 cpt 、frm檔案 |
| resources | 存放工程相關的資源配置檔案 |
| treasures | 包含報表的功能點及 BI 的埋點資訊，正常情況下一個月會自動生成一次 |
5. resources 目錄
每個檔案存放的内容如下表所示：
| 檔案 | 内容 |
| direct | 存放實時資料相關配置資訊 |
| cpu.xml | CPU 開關，處理 sigard 導緻 JVM 虛拟機崩潰問題時使用 |
| FanRuan.lic | 工程證書檔案 |
| rlink.rlink | Rserver 連接配接配置 |
6. schedule 目錄
- 測試定時任務郵件通知：存放 定時排程 生成的檔案。
7. dashboard 目錄
- 目錄下存放的是不同使用者 ID 命名的檔案夾。
點開某使用者 ID 的檔案夾，如下圖所示：
- FBI 檔案：存放的是對應使用者建立的具體儀表闆，用儀表闆 ID 命名檔案。
8. 注意事項
8.1 error.log 檔案介紹
部分使用者工程的%FineBI_HOME%\bin目錄中存在 error.log 檔案，該檔案不會根據日期進行拆分，記錄所有日期 error 級别的日志和一些相關的 info 資訊。
若使用者覺得該檔案占用磁盤空間過大，可手動删除、寫腳本定時删除或者寫腳本監控大小删除。
注1：建議确認 fanruan.log 日志已夠用，再考慮是否删除 error.log 檔案。
注2：若工程部署在 Tomcat 的容器中，bin 目錄下不會有 error.log 檔案。
三、生成安全密鑰檔案按鈕說明
1. 概述
1.1 版本
| FineBI 版本 | JAR 包 | 新增功能 |
| 5.1 | 2020-08-04 | FineBI 安裝時，可勾選「生成安全密鑰檔案」按鈕 |
1.2 功能簡介
報表所有的可變配置資訊，都存儲在配置資料庫中，試用産品使用的是内置的 HSQL 資料庫，位置為：%BI_HOME%\webapps\webroot\WEB-INF\embed\finedb，正式環境可遷移到外置的資料庫中，在/WEB-INF/config下生成一個db.properties檔案，記錄了配置資料庫的位址、使用者名、密碼等資訊。
主要作用于兩方面：
- 遷移後db.properties檔案裡面資料庫的密碼加解密
- 資料連接配接密碼、郵箱密碼、帆軟通行證密碼等加解密（不包括平台使用者密碼）
為了增強密鑰的安全性，現對根密鑰的邏輯進行優化。
2. 按鈕介紹
FineBI 安裝 時勾選「生成安全密鑰檔案」按鈕，選擇後會随機生成 3 個種子檔案，工程啟動時讀取種子檔案，記憶體中根據種子生成恒定公私鑰，此時加解密使用生成的種子檔案。
若使用者對安全性要求較高，可勾選該按鈕。如下圖所示：
注1：Windows 環境下，FineReport 設計器安裝到 C:\Program Files 無寫入權限時，若要生成安全密鑰，滑鼠右鍵點選安裝包，選擇以管理者身份運作。
注2：配置外接資料庫方法請參見：配置外接資料庫
3. 注意事項
- 加密如果有新種子檔案，則使用新密鑰加密。
- 解密如果有新種子檔案，則使用新密鑰解密，解密失敗則再去用舊密鑰解密。
- 對更新 JAR 包的客戶無影響，隻要不手動放種子檔案，那麼還是走舊密鑰加解密。
- 新安裝 2020-08-04 及之後的 exe ，采用的種子檔案生成的密鑰加密密碼，是以不能退回 JAR 包，退回後隻有老的根密鑰，無法對密碼進行解密。