修改FineReport工程埠

1.1 問題描述

• 工程部署到 Tomcat 中，預設埠號為 8080 ，使用者想修改為其他埠號。

• 一個伺服器啟動多個 Tomcat 工程，啟動失敗，原因是多個工程共用一個埠號，埠衝突，需修改埠號。

1.2 解決思路

1）對於維運平台部署的FineReport項目，請勿參考本文方案手動配置

• 在部署階段，使用者即可介面化修改各個組件的佔用埠，無需透過後台配置。

• 如已部署完成，如需修改組件的佔用埠，請聯絡帆軟技術支援協助配置。

2）對於非維運平台部署的FineReport項目

透過修改%Tomcat_HOME%/conf/server.xml檔案中的埠號。

本文方案面向非維運平台部署的、Linux伺服器環境、Tomcat中間軟體下的FineReport項目。

2.1 瞭解埠作用

在Tomcat中，常見的埠及其預設值和作用如下：

建議檢查並確認工程中的每個埠是否被佔用，如果一個伺服器中部署了多個Tomcat工程，請務必確定各個工程的這些埠配置均不相同。

2.2 查看埠占用

管理者需要確定預設埠是否被佔用，或如需更換埠，需要確認待使用埠是否被佔用。

本文提供兩種方法查看埠是否被佔用，使用者可按需選用。基於伺服器作業系統或環境不同，可能方法不適用，可另行百度查詢。

注：Linux伺服器中，1024 以下埠一般只允許 root 權限使用者佔用。因此在準備新埠時，建議使用 1024 以上埠，例如：8081、8082 等。

• lsof -i:埠號

可使用 lsof（list open files），用於查看某一埠的佔用情況。

例如使用lsof -i:8080查看 8080 埠使用情況，發現進程號（PID）為 22936 的 java 進程佔用了 8080 埠。

• netstat -tunlp|grep 埠號

可使用 netstat -tunlp 用於顯示 tcp、udp 的埠和進程等相關情況。

例如使用netstat -tunlp|grep 8080查看 8080 埠使用情況，發現進程號（PID）為 22936 的 java 進程佔用了 8080 埠。

2.3 修改工程埠

確認好新埠閒置未被使用後，即可進行埠修改操作。

1）請參考「關閉或重啟FineReport工程」文檔，關閉工程。

2）開啟終端，導航到Tomcat安裝目錄的conf目錄下，開啟並編輯server.xml檔案

3）修改HTTP連結埠（預設為8080）

找到形如Connector port="8081" protocol="HTTP/1.1"的內容，修改port值，本範例修改為9980

如果沒有安裝負載均衡相關組件，這個埠就是使用者存取工程的地址中的埠。

4）修改AJP連結器埠（預設為8009）

找到形如Connector protocol="AJP/1.3的內容，修改port值，本範例修改為9909

5）修改管理埠（預設為8005）

找到形如Server port="8005" shutdown="SHUTDOWN"的內容，修改port值，本範例修改為9905

6）儲存檔案，請參考「關閉或重啟FineReport工程」文檔重啟工程，修改生效。

2.4 驗證修改生效

使用新的HTTP連結埠，存取工程。如可正常存取，即為修改成功。

例如本範例，使用http://IP:9980/webroot/decision，即可正常存取工程

修改 Tomcat 埠號後，可能會出現變更失效或不起作用的情況，可參考以下步驟進行排查：

1）參考2.2節排查埠號是否被佔用。

2）取消環境變數檢查

開啟終端，導航到Tomcat安裝目錄的bin目錄下，開啟並編輯startup.bat檔案。

使用rem，將語句if not "%CATALINA_HOME%" == "" goto gotHome註釋掉。

儲存後，參考「關閉或重啟FineReport工程」文檔重啟工程，修改生效。