伺服器部署嚮導

1. 在進行伺服器部署時，會出現部署失敗的情況，而導致失敗的原因有很多種，此時就需要提供一個頁面或者工具來引導使用者檢測並修復問題。

2. 在伺服器部署失敗時，伺服器部署嚮導(Server Deployment Wizard)可以引導使用者及時檢測並修復問題，從而成功部署。

1

版本。

2

應用場景。

1. 在進行伺服器部署時，會出現部署失敗的情況，而導緻失敗的原因有很多種，此時就需要提供一個頁面或者工具來引導使用者檢測並修複問題。

3

功能簡介。

1. 在伺服器部署失敗時，引導使用者及時檢測並修複問題，從而成功部署。

1

配置容器環境。

1. Tomcat7 及以上，（Tomcat7編碼修改為UTF-8，Tomcat8 不需要修改）。

2. JBoss 6.0.0 及以上。

3. WebLogic 12c 及以上。

4. WebSphere 8.5.5.9 及以上。

5. Jetty 8.0 及以上。

6. Glassfish 3.0 及以上。

7. Resin 4.0.4 及以上。

1

tools.jar 不匹配。

1. tools.jar 不匹配時，報錯內容如下圖所示。

2

工程缺少 tools.jar。

1. 工程缺少 tools.jar 時，報錯內容如下圖所示。

1

內建資料庫連線失敗。

1. 內建資料庫連線失敗時，報錯內容如下圖所示。

2

外接數據庫連接失敗。

1. 外接數據庫連接失敗時，報錯内容如下圖所示。

2. 修改外接資料庫相關配置後，點選【重新檢測】，連線成功則直接啟用新的資料庫；若連線的資料庫無表資訊，則提示目標資料庫為新資料庫，無法使用。

3

websocket 埠異常。

1. websocket 埠沖突時，報錯頁面如下圖所示。

這裡以 Tomcat 容器為例進行演示。將 %FR_HOME%\webapps\webroot資料夾複制到 %TOMCAT_HOME%\webapps 資料夾下，啟動 Tomcat。

1

跳轉部署嚮導頁面。

1. 工程啟動失敗後，訪問平臺http://localhost:8080/webroot/decision，webroot 工程啟動失敗，自動跳轉到伺服器部署嚮導頁面 http://localhost:8080/webroot/decision/v10/deployment/recommendation，如下圖所示。

2

根據提示操作。

1. 將 %JAVA_HOME%\lib目錄下的 tools.jar 複制到 工程名\WEB_INF\lib 資料夾下，如下圖所示。

3

部署成功。

1. 重啟 Tomcat ，此時再次訪問平臺http://localhost:8080/webroot/decision，跳轉到登入頁面，即部署成功。如下圖所示。

1

問題現象。

1. 伺服器啟動後，訪問平臺提示 tools.jar 異常，tools.jar 不匹配。

2

 排查步驟。

1. 複制系統環境變數的 tools.jar。部署嚮導會給出解決方案，把環境使用的jdk\lib\tools.jar複制到webroot\lib下，如下圖所示。

2. 排查環境使用的 JAVA_HOME 和複制的是不是一緻的。因為 Linux 自帶 openjdk ，沒有配置 JAVA_HOME 的情況預設使用 openjdk ，而且通常這個 openjdk 不帶 tools.jar 。

3. 排查 JDK 的系統版本是否和系統環境匹配。64 位環境是可以安裝 32 位 JDK 的，同時 Tomcat 可以正常啟動，但是會一直報錯 tools.jar 不匹配。

4. 補充說明：若依然提示 tools.jar 不匹配，通常就是系統版本和 JDK 版本不匹配。因為系統版本一緻的情況下，即使 tools.jar 的版本和執行環境的 JDK 不一緻，也是可以正常啟動的。