DashBoard安裝配置

1. 簡介

  DashBoard的測試環境可以用Windows 10或者Windows 7 進行搭建，用於生產環境的系統建議使用Windows Server或Debian的64位系統進行環境部署。

  安裝DashBoard需要依賴於jdk1.8與MySQL 5.7，在進行安裝前請先安裝並配置以上環境。點選以下載Java運行環境 (opens new window)與MySQL資料庫 (opens new window)。

  也可使用其他社區版本如 MariaDB (opens new window) 替代 MySQL， Adoptium OpenJDK (opens new window) 替代 Orancle JDK。MariaDB推薦使用的版本為10.10。

2. 硬體要求

  用於開發環境的DashBoard安裝配置建議如下：

配置清單	最低配置	推薦配置
處理器	Intel 奔騰G系列	Intel Core i3系列
記憶體	8 GB RAM	16 GB RAM
操作系統	Windows 10 64位	Windows 10 64位
網路	具有1000MBps的內網訪問速率	具有1000MBps的內網訪問速率
顯示器	具有1920*1080解析度的21寸以上螢幕	具有1920*1080解析度的21寸以上螢幕

  用於生產環境的DashBoard安裝配置建議如下：

配置清單	最低配置	推薦配置
處理器	Intel 奔騰G系列	Intel Xeon E3
記憶體	16 GB RAM	32 GB RAM
操作系統	Windows Server 2012R2 64位	Windows Server 2016 64位
儲存空間	1TB可用空間	4TB可用空間
網路	具有1000MBps的內網訪問速率	具有1000MBps的內網訪問速率

3. 安裝部署

  點選鏈接 https://isoface.net/isoface/component/osdownloads/routedownload/general/dashboard/dashboard?Itemid=268 (opens new window) 獲取下載安裝包，將獲取的安裝包解壓放置於自定的目錄中。修改 conf/bootstrap.yml。將圖中關於mysql的連線配置資訊換成實際使用的服務地址、使用者名稱與密碼。aj_report庫是存放底層基礎資訊的庫，flyway在啟動時會自動建立，如果在這裡修改了庫的設定，將會出錯。

  如需要使用到上傳匯入等相關的功能，以下內容請注意修改，注意路徑格式，比如Win是 \ , linux是 /，目錄后一定要帶上完整的斜槓符號。

4. 啟動運行

windows下可直接雙擊 bat 檔案來啟動，或者是在powershell中通過命令列運行，運行后請勿關閉控制檯界面，否則程序會自動結束。

  如果start.bat啟動存在問題，可以嘗試使用以下方式解決。

  修改第4行的 JAVA_HOME，改成實際的目錄地址，並去掉 rem 註釋。

  如果 JAVA_HOME 目錄存在空格，將bat檔案最後一行的 JAVA_HOME 處新增""號。

5. 檢查防火墻配置

  如果是要開放給區域網客戶端訪問的，請在防火墻中檢查是否為 java.exe 開啟允許訪問。如未設定，請在 高級安全防火墻 中配置 java.exe的允許連線。

6. 重置mysql連線

  使用本機瀏覽器打開 http://localhost:9095/ (opens new window)。預設的登錄使用者名稱與密碼為 admin，123456。

  登陸后請及時修改mysql數據源以檢視初始示例。

  點選報表設計 - 數據源，在右側列表中找到mysql數據源，點選編輯 ，修改其中顯示的使用者名稱與密碼（改成實際使用的mysql的使用者名稱密碼）。

7. 其它問題

  如果在設定mssql server的數據連線時出現無法連線的情況，在日誌中可看到 The server selected protocol version TLS10 is not accepted by client preferences [TLS12] 字樣的，可到Java的運行環境目錄，找到 jre/lib/security/java.security檔案，修改 jdk.tls.disabledAlgorithms 后的字串，去除 3DES_EDE_CBC 、 TLSv1、TLSv1.1 專案，儲存檔案後重新啟動專案。

  如果報錯中發現包含 Public Key Retrieval is not allowed 的內容，可修改 conf/bootstrap.yml 中datasource的設定，需要將allowPublicKeyRetrieval=true和useSSL=false。

jdbc:mysql://127.0.0.1:3306/aj_report?characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&PublicKeyRetrieval=true&useSSL=false;

8. 反向代理配置

  如需要將 AI DashBoard 部署于SSL 環境或者特殊需要，可使用 Nginx 等 Web 伺服器來配置反向代理。配置反向代理的 Nginx 配置檔案中請新增如下設定：

server{
    ...
    # AI DashBoard 前端與服務反向代理
    location  / {
        # 這裡的 ip 是後端 dashboard 的 ip
        # 請修改此處的地址為您的 AI DashBoard 服務地址
        proxy_pass http://192.168.0.201:9095/;
        proxy_read_timeout  300;
        proxy_connect_timeout   300;
        proxy_redirect  off;

        # 代理參數，請照複製
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    # AI DashBoard WebSocket 反向代理
    location /ws {
    # 請修改此處的地址為您的 AI DashBoard 服務地址，後綴預設帶上/ws
        proxy_pass http://192.168.0.201:9095/ws;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
     }
     ...
}

  同步修改 conf/bootstrap.yml 中的 downloadpath 與 websocket-url 地址為反向代理后的地址。重新啟動后就可實現反向代理連線。