一、概述
在進行伺服器部署時，會出現部署失敗的情況，而導緻失敗的原因有很多種，此時就需要提供一個頁面或者工具來引導使用者檢測並修復問題。
在伺服器部署失敗時，伺服器部署嚮導(Server Deployment Wizard)可以引導使用者及時檢測並修復問題，從而成功部署。
1
版本。
報表伺服器版本 | JAR 包 | 新增功能 |
10.0 | 2019-05-20 | - |
10.0.14 | 2021-03-17 | 伺服器部署嚮導頁面中，外接資料庫配置資訊介面中支援設定資料連線 URL。 |
2
應用場景。
在進行伺服器部署時，會出現部署失敗的情況，而導緻失敗的原因有很多種，此時就需要提供一個頁面或者工具來引導使用者檢測並修複問題。
3
功能簡介。
在伺服器部署失敗時，引導使用者及時檢測並修複問題，從而成功部署。
二、前期準備
1
配置容器環境。
Tomcat7 及以上，（Tomcat7編碼修改為UTF-8，Tomcat8 不需要修改）。
JBoss 6.0.0 及以上。
WebLogic 12c 及以上。
WebSphere 8.5.5.9 及以上。
Jetty 8.0 及以上。
Glassfish 3.0 及以上。
Resin 4.0.4 及以上。
三、部署報錯頁面- tools.jar
1
tools.jar 不匹配。
tools.jar 不匹配時，報錯內容如下圖所示。
2
工程缺少 tools.jar。
工程缺少 tools.jar 時，報錯內容如下圖所示。
四、部署報錯頁面-資料庫
1
內建資料庫連線失敗。
內建資料庫連線失敗時，報錯內容如下圖所示。
2
外接數據庫連接失敗。
外接數據庫連接失敗時，報錯内容如下圖所示。
修改外接資料庫相關配置後，點選【重新檢測】，連線成功則直接啟用新的資料庫；若連線的資料庫無表資訊，則提示目標資料庫為新資料庫，無法使用。
3
websocket 埠異常。
websocket 埠沖突時，報錯頁面如下圖所示。
五、示例1-缺失 tools.jar
這裡以 Tomcat 容器為例進行演示。將 %FR_HOME%\webapps\webroot資料夾複制到 %TOMCAT_HOME%\webapps 資料夾下，啟動 Tomcat。
1
跳轉部署嚮導頁面。
工程啟動失敗後，訪問平臺http://localhost:8080/webroot/decision，webroot 工程啟動失敗，自動跳轉到伺服器部署嚮導頁面 http://localhost:8080/webroot/decision/v10/deployment/recommendation，如下圖所示。
2
根據提示操作。
將 %JAVA_HOME%\lib目錄下的 tools.jar 複制到 工程名\WEB_INF\lib 資料夾下，如下圖所示。
3
部署成功。
重啟 Tomcat ，此時再次訪問平臺http://localhost:8080/webroot/decision，跳轉到登入頁面，即部署成功。如下圖所示。
六、示例2-tools.jar 不匹配
1
問題現象。
伺服器啟動後，訪問平臺提示 tools.jar 異常，tools.jar 不匹配。
2
排查步驟。
複制系統環境變數的 tools.jar。部署嚮導會給出解決方案，把環境使用的jdk\lib\tools.jar複制到webroot\lib下，如下圖所示。
排查環境使用的 JAVA_HOME 和複制的是不是一緻的。因為 Linux 自帶 openjdk ，沒有配置 JAVA_HOME 的情況預設使用 openjdk ，而且通常這個 openjdk 不帶 tools.jar 。
排查 JDK 的系統版本是否和系統環境匹配。64 位環境是可以安裝 32 位 JDK 的，同時 Tomcat 可以正常啟動，但是會一直報錯 tools.jar 不匹配。
補充說明：若依然提示 tools.jar 不匹配，通常就是系統版本和 JDK 版本不匹配。因為系統版本一緻的情況下，即使 tools.jar 的版本和執行環境的 JDK 不一緻，也是可以正常啟動的。
