syncNode 指令

syncNode 指令會強制在節點及配置了此節點之 Cell 的部署管理程式之間，進行配置同步化。

節點代理程式伺服器會執行配置同步化服務，使節點配置和主要的 Cell 配置保持同步化。 如果節點代理程式因節點配置有問題而無法執行，您可以在節點代理程式未執行時，使用 syncNode 指令來執行同步化，強制讓節點配置重新與 Cell 配置同步化。 如果節點代理程式正在執行，而您要執行 syncNode 指令，則必須先停止節點代理程式。

syncNode.log 檔案位於 profile_root/logs 目錄中。

如需在何處執行此指令的相關資訊，請參閱 使用指令行工具。

語法

指令語法如下：
syncNode <deploymgr host> <deploymgr port> [options]
  • The <deploymgr 主持人> argument is required.
  • The <deploymgr 埠> is the Java™ Management Extensions (JMX) port number that corresponds to the connector type on the -conntype parameter.

參數

下列選項可用於 syncNode 指令：

-stopservers
告訴 syncNode 指令在執行與 Cell 的配置同步化之前，停止節點上的所有伺服器，包括節點代理程式。
-restart
告訴 syncNode 指令在配置同步化完成之後，啟動節點代理程式程序。 如果節點代理程式正在執行，而您要執行 syncNode 指令，則必須先停止節點代理程式。
-nowait
告訴 syncNode 指令不要等待已啟動之節點代理程式處理程序順利起始設定。
-quiet
隱藏 syncNode 指令以標準模式列印的進度資訊。
-logfile <fileName>
指定要寫入追蹤資訊的日誌檔位置。 依預設，日誌檔的名稱是 syncNode.log，並且是在節點（您正進行同步化）設定檔的 logs 目錄中建立的。
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]在多重設定檔安裝中定義應用程式伺服器程序的設定檔。 如果要在單一設定檔環境中執行，-profileName 選項不是必要選項。 這個選項的預設值是預設設定檔。
-replacelog
取代日誌檔，而不是附加至現行日誌。
-trace
在檔案中產生追蹤資訊，以用於除錯。
-timeout <seconds>
指定節點代理程式起始設定逾時前的等待時間並傳回錯誤。
-username <name>
指定在啟用安全的情況下，要進行鑑別的使用者名稱。 作用和 -user 選項一樣。
-user <name>
指定在啟用安全的情況下，要進行鑑別的使用者名稱。 作用和 -username 選項一樣。
-password <password>
指定在啟用安全的情況下，要進行鑑別的密碼。
-conntype <type>
指定用來連接部署管理程式的 Java 管理延伸 (JMX) 連接器類型。 有效類型有 SOAP 或遠端方法呼叫 (RMI)。 預設類型是 SOAP。
-help
列印用法說明。
-?
列印用法說明。

使用實務

下列範例示範正確的語法：

[AIX Solaris HP-UX Linux Windows][IBM i]
syncNode testhost 8879

syncNode deploymgr 8879 -trace (produces the syncNode.log file)

syncNode host25 4444 -stopservers -restart 
(assumes that the deployment manager JMX port is 4444)
[z/OS]
syncNode.sh testhost 8879

syncNode.sh deploymgr 8879 -trace (produces the syncNode.log file)

syncNode.sh host25 4444 -stopservers -restart 
(assumes that the deployment manager JMX port is 4444)
[HP-UX][Solaris]避免麻煩:
  1. 在 HP-UX 或 Solaris 作業系統上，可能會在大型且複雜的作業期間，發生 java.lang.OutOfMemoryError: PermGen 空間問題。 例如，當您在具有大型應用程式的節點上，執行像是 syncNode 這樣的指令時，可能會遇到這個問題。 當資源需求超出預設儲存體大小時，作業可能會發生 java.lang.OutOfMemoryError: PermGen 空間錯誤而失敗。 如果要解決這個問題，請增加永久區域的大小下限。 將 -XX:PermSize Java虛擬機器 (JVM) 選項設為 128MB 這樣的值，這對發生此問題的許多狀況來說都是足夠的：
    XX:PermSize=128m
  2. 當您執行 syncNode Script 時，請務必以伺服器 WebSphere 管理群組的成員身分來執行它。 syncNode Script 可能會將部分配置檔的所有權變更為啟動 Script 之使用者的所有權。

    一般而言，配置檔是由伺服器的使用者 ID 所擁有，但這不是必要項目。 請確定 Cell 的「 WebSphere 管理」群組仍可讀取及寫入配置檔。