關閉或重啟FineReport工程

1.1 版本

1.2 應用場景

• 需要重啟工程以使配置變更生效

• 需要完全關閉工程相關進程後再執行重啟

1.3 功能簡介

本文提供在 Linux 系統中，關閉和重啟以下三種容器內 FineReport 工程的操作方法：

• Tomcat

• WebLogic

• WebSphere

1.4 其他說明

1）部署在Tomcat、WebLogic、WebSphere、JBoss、Resin中間軟體中的工程，可透過關閉中間軟體，直接關閉工程

2）部署在中間軟體中的工程，若因使用者操作不當等原因導致系統中存在殘留執行緒，工程啟動時，檢查到殘留執行緒後，將以平台訊息的方式提示超管，通知內容如下所示：

單機：檢查到XXX號進程可能存在進程殘留，為不影響當前應用正常運作，建議即時檢查確認

叢集：檢查到XXXXX（節點地址）節點下XXX號進程可能存在進程殘留，為不影響當前應用正常運作，建議即時檢查確認

範例：以下範例中，工程部署路徑為 /home/wendy/tomcat-linux，請根據實際部署路徑取代。

2.1 關閉工程

步驟一：優化配置檔案

關閉工程前，建議對以下兩個檔案進行優化，以確定關閉操作更加可靠。

${tomcat}/bin/catalina.sh檔案：在該行PRGDIR=`dirname "$PRG"`下面新增一行內容CATALINA_PID=./CATALINA_PID

${tomcat}/bin/shutdown.sh檔案：最後一行改成exec "$PRGDIR"/"$EXECUTABLE" stop -force "$@"

步驟二：執行關閉腳本

使用 Tomcat 自帶的 shutdown.sh 腳本關閉容器：

注：/home/wendy/tomcat-linux 為範例路徑，請取代為工程的實際部署路徑。

cd /home/wendy/tomcat-linux/bin

./shutdown.sh

2.2 清理舊有進程

執行 shutdown.sh 後，可能存在未完全跳出的舊有進程，需手動清理 。

1）查看工程相關進程：

注：tomcat-linux 為範例路徑中的目錄名，請取代為實際部署路徑中對應的目錄名 。

ps -ef | grep tomcat-linux

2）根據查詢結果，逐一終止所有工程相關進程（將 <PID> 取代為實際進程號）：

kill -9 <PID>

3）再次執行查詢命令，確認所有相關進程已清除：

注：tomcat-linux 為範例路徑中的目錄名，請取代為實際部署路徑中對應的目錄名。

ps -ef | grep tomcat-linux

2.3 重啟工程

1）進入工程 bin 目錄，執行啟動腳本：

注：/home/wendy/tomcat-linux 為範例路徑，請取代為工程的實際部署路徑。

cd /home/wendy/tomcat-linux/bin

./startup.sh

2）查看實時日誌，確認重啟結果：

注：/home/wendy/tomcat-linux 為範例路徑，請取代為工程的實際部署路徑。

cd /home/wendy/tomcat-linux/logs

tail -f catalina.out

日誌中出現類似以下內容，表示重啟成功：

3.1 關閉工程

1）查看工程相關進程：

ps -ef | grep weblogic

2）根據查詢結果，逐一終止所有工程相關進程（將 <PID> 取代為實際進程號）：

kill -9 <PID>

3）再次執行查詢命令，確認所有相關進程已清除：

ps -ef | grep weblogic

3.2 重啟工程

1）進入 startWebLogic.sh 所在目錄，以後台方式啟動工程：

注：/web/weblogic/Oracle/Middleware/user_projects/domains 為範例路徑，請取代為工程的實際部署路徑。

cd /web/weblogic/Oracle/Middleware/user_projects/domains

nohup ./startWebLogic.sh &

2）驗證工程已成功啟動：

ps -ef | grep weblogic

查詢結果中出現 WebLogic 相關進程，表示重啟成功。

4.1 關閉工程

1）查看工程相關進程：

ps -ef | grep WebSphere

2）根據查詢結果，逐一終止所有工程相關進程（將 <PID> 取代為實際進程號）：

kill -9 <PID>

3）再次執行查詢命令，確認所有相關進程已清除：

ps -ef | grep WebSphere

4.2 重啟工程

1）進入 startServer.sh 所在目錄：

注：/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin 為範例路徑，請取代為工程的實際部署路徑。

cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin

2）啟動應用程式伺服器（將 server1 取代為實際的伺服器名稱）：

./startServer.sh server1

3）驗證工程已成功啟動：

ps -ef | grep websphere

查詢結果中出現 WebSphere 相關進程，表示重啟成功。

注：應用程式伺服器名稱（即上文的 server1 ），可在控制台查看。