WASPostUpgrade 指令

WebSphere® Application ServerWASPostUpgrade 指令會從您指定的 backupDirectory 中,擷取 WASPreUpgrade 指令所建立的已儲存的配置。 WebSphere Application ServerWASPostUpgrade Script 會從這個目錄讀取要移轉至 WebSphere Application Server 9.0 版的配置,將所有已移轉的應用程式新增到 9.0 版安裝架構的 app_server_root/installedApps 目錄中。

位置

支援的配置 支援的配置:

本文討論設定檔配置的移轉。 如果要將應用程式移轉至最新的版本,請使用 WebSphere Application Server Migration Toolkit。 如需相關資訊,請參閱 WASdev 上的 Migration Toolkit

sptcfg

指令檔在 app_server_root/bin 目錄中,且必須從這個目錄來執行。

權限

如果要執行這個指令 Script,您的使用者設定檔必須具備 *ALLOBJ 權限。

語法

WASPostUpgrade backupDirectory
                     [-properties properties_file_name]
                     [-username userID]
                     [-password password]
                     [-profileName profile_name]
                     [-setPorts useOld | generateNew | port_starting_number]
                     [-resolvePortConflicts incrementCurrent | port_starting_number]
                     [-backupConfig true | false]
                     [-includeApps true | false | script]
                     [-keepDmgrEnabled true | false]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]
當移轉已登錄且啟用安全的應用程式伺服器時,請在目標和來源管理代理程式上使用這些參數:
WASPostUpgrade backupDirectory
[-oldAdminAgentProfilePath 舊管理代理程式的路徑]
[-oldAdminAgentSoapPort 舊管理代理程式的 SOAP 埠]
[-oldAdminAgentHostname 舊管理代理程式的主機名稱,預設為 localhost ]
[-oldAdminAgentUsername 舊管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-oldAdminAgentPassword 舊管理代理程式的登入密碼,如果啟用管理安全的話 ]
[-newAdminAgentProfilePath 新管理代理程式的路徑 ]
[-newAdminAgentSoapPort 新管理代理程式的 SOAP 埠 ]
[-newAdminAgentHostname 新管理代理程式的主機名稱,預設為 localhost ]
[-newAdminAgentUsername 新管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-newAdminAgentPassword 新管理代理程式的登入密碼,如果啟用管理安全的話 ]

參數

指令的參數如下:

backupDirectory
這是必要參數。值 backupDirectory 指定目錄的名稱,以供 WASPreUpgrade 工具用來存放所儲存的配置與檔案,以及供 WASPostUpgrade 工具讀取其中的配置與檔案。
-properties
這是選用性參數。 properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPostUpgrade 之類移轉工具要如何操作的參數內容。

您可以在移轉內容檔中定義參數內容,而不在指令行上指定大部分的選用參數。 如果在內容檔定義參數也在指令行指定參數,則指令行所指定的參數優先。

註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username-password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties
-username
這是選用性參數。 userID 值指定現行 WebSphere Application Server 7.0 版或更新版本安裝架構的管理使用者名稱。
如果下列狀況屬實,則此為必要的參數:
  • 您要移轉部署管理程式或聯合節點。
  • 在來源安裝架構中啟用管理或廣域安全。
  • security.xml 檔中未定義管理或廣域安全使用者 ID。
-password
這是選用性參數。 password 值指定現行 WebSphere Application Server 7.0 版或更新版本安裝架構之管理使用者名稱的密碼。
如果下列狀況屬實,則此為必要的參數:
  • 您要移轉部署管理程式或聯合節點。
  • 在來源安裝架構中啟用管理或廣域安全。
  • security.xml 檔中未定義管理或廣域安全密碼。
-profileName
當您移轉至 WebSphere Application Server 9.0 版中的特定設定檔時,這是一個選用參數。 profile_name 值指定 Script 移轉您的配置的目標 9.0 版設定檔名稱。 您必須已建立這個設定檔,才能呼叫 WASPostUpgrade 指令。
如果未指定 -profileName 參數,就會使用預設設定檔。如果找不到預設設定檔,系統會報告錯誤。
避免困難 避免困難: 如果您沒有在 -profileName 上指定特定的設定檔名稱,就會移轉任何指定的「預設」設定檔。 您可能必須利用 WASPostUpgrade 後置移轉指令,針對用戶端在新的環境中所想要的每個設定檔來指定 -oldProfile 和 -profileName 參數,以移轉預先移轉時所備份的每個設定檔。 如果在範例應用程式和系統應用程式之外,舊設定檔還包含已安裝的應用程式 (installedApps),移轉程序會自動移轉那些應用程式。gotcha
註: 當從 9.0 版移轉獨立式應用程式伺服器時,您可以選擇已登錄於管理代理程式的獨立式應用程式伺服器節點來作為移轉目標。
-backupConfig
這是一個選用參數,用來指定在 WASPostUpgrade 工具進行任何變更之前,是否要先儲存現有的 WebSphere Application Server 9.0 版配置。 預設值為 true — 亦即,使用 backupConfig 指令,將現行配置的副本儲存至 profile_name/temp 目錄。

若有需要,可使用 restoreConfig 指令來還原該配置。如需相關資訊,請參閱 restoreConfig 指令

-setPorts
這是選用參數,用來指定如何設定新設定檔的埠。此參數所用的值如下:
  • useOld(預設值):使用舊設定檔使用的相同埠。
  • generateNew:根據預設埠指派,來產生新埠。
  • port_starting_number:從指定埠增量,來產生新埠。

如果您為這個參數指定一值,任何所要指派的新埠,都會根據此值來設定。每當需要新埠值時,就會根據此值來建立埠,並讓種子值增量,以供下次使用。不會指派重複埠。

-resolvePortConflicts
這個選用參數用來指定如何對映埠值。當埠無法使用時,會從起始值開始增量其值,直到找到可用埠為止。
  • incrementCurrent(預設值):從衝突的埠值開始增量。
  • port_starting_number:從指定的一般起始埠值開始增量。
-includeApps
您可以在移轉的過程中,併入商業層次的應用程式、資產和組合單元。 您可以選擇性地在 WASPostUpgrade 指令中,利用 -IncludeApps 參數來移轉這些項目。 這個選用參數有下列數種的指定方式:
  • True

    在移轉的過程中,併入使用者企業應用程式、商業層次的應用程式、資產和組合單元。

    這個值是預設值。

  • False

    WASPostUpgrade 處理期間,對使用者企業應用程式、商業層次的應用程式、資產和組合單元不執行任何動作。

  • Script
    • 企業應用程式

      準備使用者企業應用程式,以便安裝在 WebSphere Application Server 9.0 版 installableApps 目錄中,而不在 WASPostUpgrade 處理期間安裝它們。

      會產生可用來安裝這些應用程式的 Script,並儲存在 backupDirectory 目錄中。完成 WASPostUpgrade 指令之後,您就可以在任何時間點,以任何組合來執行這些檔案。您也可以重組和合併這些檔案來提高應用程式安裝效率。

    • 商業層次的應用程式、資產和組合單元

      會產生 install_all_BLAs.jy Script,並放在備份目錄中。這個 Script 可以將備份目錄中的所有商業層次的應用程式、資產和組合單元移轉至您的目標設定檔。 位於 <WAS_PROFILE_ROOT>/bin 目錄中的 WASPostUpgradeBLAHelper.bat/.sh Script,用來移轉 install_all_BLAs.txt 檔中的商業層次應用程式、資產和組合單元。

      避免困難 避免困難: 如果要移轉商業層次的應用程式、資產和組合單元,您必須先建立它們的相依關係。gotcha

不論這個參數設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。

-keepDmgrEnabled
這個選用參數用來指定是否停用現有 WebSphere Application Server 7.0 版或更新版本部署管理程式。預設值為 false。

如果這個參數指定為 true,當移轉完成時,您可以使用現有 7.0 版或更新版本部署管理程式。只有在您移轉的是部署管理程式時,才會是有效的;在其他所有的移轉作業中,都會忽略此項。

警告: 請小心使用此參數。
  • 通常會停止及停用 WebSphere Application Server 7.0 版或更新版本部署管理程式配置的原因,是為了防止多個部署管理程式管理相同的節點。您必須先停止 7.0 版或更新版本部署管理程式,再開始使用 9.0 版部署管理程式。如果沒有這樣做,最有可能發生的錯誤狀況是,當啟動部署管理程式的第二個實例時,會發生埠衝突。
  • 如果將這個參數指定為 true,表示移轉期間在舊配置中所作的任何配置變更,都不會被移轉。
-keepAppDirectory
這個選用參數用來指定是否將所有的應用程式,安裝至它們目前所在的相同目錄中。預設值為 false。

如果將這個參數指定為 true,每一個個別的應用程式都會保留其位置。

如果您指定這個參數,就不能指定 -appInstallDirectory 參數。

限制: 如果這個參數指定為 true,現有 WebSphere Application Server 7.0 版或更新版本安裝架構及 9.0 版安裝架構會共用這個位置。如果您將移轉後的應用程式保留在與舊版相同的位置中,將會有下列若干限制:
  • 必須遵循 WebSphere Application Server 9.0 版混合式節點支援限制。 這表示呼叫 wsadmin 指令時,無法使用下列支援:
    • 預先編譯 JSP
    • 使用二進位配置
    • 部署 EJB
  • 日後在您管理 7.0 版或更新版本的安裝架構時,如果您刪除這些位置中的應用程式,會有無意中遺失移轉後應用程式的風險。
-appInstallDirectory
移轉期間當安裝所有應用程式時,可使用這個選用參數來傳遞要使用的目錄名稱。如果沒有指定這個參數,會使用預設的 profile_name\installedApps

如果您指定這個參數,就不能指定 -keepAppDirectory 參數。

如果目錄名稱中有一或多個空格,必須用引號括住名稱。

如果您使用這個參數,移轉工具會同時在備份目錄(舊版的變數)與目的地設定檔(新版中的變數)中,針對所要移轉的節點,探索節點層次的變數。只要路徑是這些版本中之下列任何變數的一部分,工具就會簽訂路徑資訊,以使用相關的變數:
  • APP_INSTALL_ROOT
  • USER_INSTALL_ROOT
  • WAS_INSTALL_ROOT
一旦簽訂,您會收到下列警告訊息,指出工具已變更您的指定值以及所簽訂的值為何:
MIGR0341W: Application install directory has been updated to {0}.
例如:
MIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}\customAppDirectory.
MIGR0341W: Application install directory has been updated to ${APP_INSTALL_ROOT}\
cellName\customAppDirectory\.
-traceString
這是選用性參數。 值 trace_spec 指定您要收集的追蹤資訊。

如果要收集所有的追蹤資訊,請指定 "*=all=enabled"(含雙引號)。

如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。

-traceFile
這是選用性參數。 值 file_name 會指定輸出檔的名稱,以取得追蹤資訊。

如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。

-requestTimeout
這是選用性參數。 值是指移轉所等待的秒數,過了這個秒數,就將嘗試的 wsadmin 連線設為失敗。

在應用程式移轉期間,這個值也用來作為逾時參數。

-oldAdminAgentProfilePath
這是選用性參數。 舊管理代理程式的路徑值是指原始管理代理程式之設定檔目錄的檔案系統路徑。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-oldAdminAgentSoapPort
這是選用性參數。 舊管理代理程式的 SOAP 埠值是指原始管理代理程式用於管理連線的 SOAP 埠。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-oldAdminAgentHostname
這是選用性參數。 舊管理代理程式的主機名稱值是指原始管理代理程式的主機名稱位置。 如果未指定這個參數,依預設,這個值會設為 "localhost"。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-oldAdminAgentUsername
這是選用性參數。 舊管理代理程式的登入使用者名稱值是指原始管理代理程式的使用者名稱。

只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。

-newAdminAgentProfilePath
這是選用性參數。 新管理代理程式的路徑值是指新的已移轉的「管理代理程式」之設定檔目錄的檔案系統路徑。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-newAdminAgentSoapPort
這是選用性參數。 舊管理代理程式的 SOAP 埠值是指新的已移轉的「管理代理程式」用於管理連線的 SOAP 埠。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-newAdminAgentHostname
這是選用性參數。 舊管理代理程式的主機名稱值是指新的「管理代理程式」的主機名稱位置。 如果未指定這個參數,依預設,這個值會設為 "localhost"。

只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。

-newAdminAgentUsername
這是選用性參數。 舊管理代理程式的登入使用者名稱值是指新的「管理代理程式」的使用者名稱。

只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。

-newAdminAgentPassword
這是選用性參數。 舊管理代理程式的登入密碼值是指新的「管理代理程式」的使用者名稱。

只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。

-javaoption < -Xms...m > -javaoption < -Xmx...m >
這是選用性參數。 請利用這個參數來指定 WASPostUpgrade 所用的 Java 資料堆記憶體大小。

"-Xms...m" 值指定起始資料堆大小。 請將 "..." 更換為您需要的大小 (MB)。 比方說,如果起始資料堆大小是 128 MB,請將這個參數指定為:-javaoption -Xms128m

"-Xmx...m" 值指定資料堆大小上限。 請將 "..." 更換為您需要的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xms1024m

安全考量

移轉之前,目標系統必須先停用安全。如果您從已啟用安全的來源配置進行移轉,在移轉期間,WASPostUpgrade 指令會自動啟用 9.0 版目標配置的安全。


指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=rmig_WASPostUpgrade
檔名:rmig_WASPostUpgrade.html