WASPostUpgrade 指令
WebSphere® Application Server 的 WASPostUpgrade 指令會從您指定的 backupDirectory 中,擷取 WASPreUpgrade 指令所建立的已儲存的配置。 WebSphere Application Server 的 WASPostUpgrade 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 目錄中,且必須從這個目錄來執行。
語法
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname host_name]
[[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-oldAdminAgentProfilePath 舊管理代理程式的路徑]
[-oldAdminAgentSoapPort 舊管理代理程式的 SOAP 埠]
[-oldAdminAgentHostname 舊管理代理程式的主機名稱,預設為 localhost ]
[-oldAdminAgentUsername 舊管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-oldAdminAgentPassword 舊管理代理程式的登入密碼,如果啟用管理安全的話 ]
[-newAdminAgentProfilePath 新管理代理程式的路徑 ]
[-newAdminAgentSoapPort 新管理代理程式的 SOAP 埠 ]
[-newAdminAgentHostname 新管理代理程式的主機名稱,預設為 localhost ]
[-newAdminAgentUsername 新管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-newAdminAgentPassword 新管理代理程式的登入密碼,如果啟用管理安全的話 ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-oldAdminAgentProfilePath 舊管理代理程式的路徑]
[-oldAdminAgentSoapPort 舊管理代理程式的 SOAP 埠]
[-oldAdminAgentHostname 舊管理代理程式的主機名稱,預設為 localhost ]
[-oldAdminAgentUsername 舊管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-oldAdminAgentPassword 舊管理代理程式的登入密碼,如果啟用管理安全的話 ]
[-newAdminAgentProfilePath 新管理代理程式的路徑 ]
[-newAdminAgentSoapPort 新管理代理程式的 SOAP 埠 ]
[-newAdminAgentHostname 新管理代理程式的主機名稱,預設為 localhost ]
[-newAdminAgentUsername 新管理代理程式的登入使用者名稱,如果啟用管理安全的話 ]
[-newAdminAgentPassword 新管理代理程式的登入密碼,如果啟用管理安全的話 ]
參數
指令的參數如下:
- 這是必要參數。值 backupDirectory 指定目錄的名稱,以供 WASPreUpgrade 工具用來存放所儲存的配置與檔案,以及供 WASPostUpgrade 工具讀取其中的配置與檔案。
- 這是選用性參數。
properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPostUpgrade 之類移轉工具要如何操作的參數內容。
您可以在移轉內容檔中定義參數內容,而不在指令行上指定大部分的選用參數。 如果在內容檔定義參數也在指令行指定參數,則指令行所指定的參數優先。
註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username 和 -password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties。 - 這是選用性參數。
userID 值指定現行 WebSphere Application Server 7.0 版或更新版本安裝架構的管理使用者名稱。如果下列狀況屬實,則此為必要的參數:
- 這是選用性參數。
password 值指定現行 WebSphere Application Server 7.0 版或更新版本安裝架構之管理使用者名稱的密碼。如果下列狀況屬實,則此為必要的參數:提示: 當您需要在「移轉」精靈中指定密碼,或是在指令行中使用含有 -password 參數的 WASPostUpgrade 指令時,您可以用純文字來輸入密碼,或是使用 xor 加密值。如果要使用 xor 加密值,請輸入整個密碼,包括以 {xor} 字首作為參數的值。在您舊有配置的任何一個 WebSphere Application Server 配置檔中,都可能指定了這個 xor 加密值,其中包括 soap.client.props、ssl.client.props 和 security.xml 檔。提示: 當您在指令行中使用含有 -password 參數的 WASPostUpgrade 指令時,您可以用純文字來輸入密碼,或是使用 xor 加密值。 如果要使用 xor 加密值,請輸入整個密碼,包括以 {xor} 字首作為參數的值。在您舊有配置的任何一個 WebSphere Application Server 配置檔中,都可能指定了這個 xor 加密值,其中包括 soap.client.props、ssl.client.props 和 security.xml 檔。
- 當您從舊版的 WebSphere Application Server 中移轉實例或設定檔時,這是一個選用參數。
執行這個指令之前,實例或設定檔必須已存在於移轉備份目錄中。如果未指定 -oldProfile 參數,就會使用預設設定檔。 如果找不到預設設定檔,系統會報告錯誤。
避免困難: 如果您沒有在 -oldProfile 上指定特定的設定檔名稱,就會移轉任何指定的「預設」設定檔。 您可能必須利用 WASPostUpgrade 後置移轉指令,針對用戶端在新的 9.0 版環境中所想要的每個設定檔來指定 -oldProfile 和 -profileName 參數,以移轉預先移轉時所備份的每個設定檔。 如果在範例應用程式和系統應用程式之外,舊設定檔還包含已安裝的應用程式 (installedApps),移轉程序會自動移轉那些應用程式。gotcha
- 當您移轉至 WebSphere Application Server 9.0 版中的特定設定檔時,這是一個選用參數。
profile_name 值指定 Script 移轉您的配置的目標 9.0 版設定檔名稱。
您必須已建立這個設定檔,才能呼叫 WASPostUpgrade 指令。如果未指定 -profileName 參數,就會使用預設設定檔。如果找不到預設設定檔,系統會報告錯誤。
避免困難: 如果您沒有在 -profileName 上指定特定的設定檔名稱,就會移轉任何指定的「預設」設定檔。 您可能必須利用 WASPostUpgrade 後置移轉指令,針對用戶端在新的環境中所想要的每個設定檔來指定 -oldProfile 和 -profileName 參數,以移轉預先移轉時所備份的每個設定檔。 如果在範例應用程式和系統應用程式之外,舊設定檔還包含已安裝的應用程式 (installedApps),移轉程序會自動移轉那些應用程式。gotcha
註: 當從 9.0 版移轉獨立式應用程式伺服器時,您可以選擇已登錄於管理代理程式的獨立式應用程式伺服器節點來作為移轉目標。 - 這是一個選用參數,用來指定在 WASPostUpgrade 工具進行任何變更之前,是否要先儲存現有的 WebSphere Application Server 9.0 版配置。
預設值為 true — 亦即,使用 backupConfig 指令,將現行配置的副本儲存至
profile_name/temp 目錄。
若有需要,可使用 restoreConfig 指令來還原該配置。如需相關資訊,請參閱 restoreConfig 指令。
- 這是選用參數,用來指定如何設定新設定檔的埠。此參數所用的值如下:
如果您為這個參數指定一值,任何所要指派的新埠,都會根據此值來設定。每當需要新埠值時,就會根據此值來建立埠,並讓種子值增量,以供下次使用。不會指派重複埠。
- 這個選用參數用來指定如何對映埠值。當埠無法使用時,會從起始值開始增量其值,直到找到可用埠為止。
- 您可以在移轉的過程中,併入商業層次的應用程式、資產和組合單元。
您可以選擇性地在 WASPostUpgrade 指令中,利用 -IncludeApps 參數來移轉這些項目。
這個選用參數有下列數種的指定方式:
不論這個參數設定了什麼值,WebSphere Application Server 系統應用程式都會進行移轉。
- 這個選用參數指示是否執行複本移轉,表示您將來源設定檔移轉至 9.0 版環境之後,可以繼續使用它。
預設值為 false。
當 -clone 參數是 true 時,您無法指定 -setPorts useold。 新的設定檔配置必須使用唯一埠號,以便現在共存的新舊配置不會有埠衝突。
如果您複製部署管理程式,您也必須複製它的聯合節點,且無法在不複製部署管理程式的情況下複製聯合節點。 聯合節點的複本移轉需要您在下列參數中設定新主機名稱,以及節點 SOAP 埠或 RMI 埠。- -newDmgrHostname
- 9.0 版 部署管理程式的主機名稱
- -newDmgrSoapPort
- 9.0 版 部署管理程式的「簡易物件存取通訊協定 (SOAP)」埠
- -newDmgrRmiPort
- 9.0 版 部署管理程式的「遠端方法呼叫 (RMI)」埠
- 這個選用參數用來指定是否停用現有 WebSphere Application Server
7.0 版或更新版本部署管理程式。除非 -clone 參數是 true,否則,預設值是 false,這時 -keepDmgrEnabled 也會設為 true。
如果這個參數指定為 true,當移轉完成時,您可以使用現有 7.0 版或更新版本部署管理程式。只有在您移轉的是部署管理程式時,才會是有效的;在其他所有的移轉作業中,都會忽略此項。
警告: 請小心使用此參數。 - 這個選用參數用來指定是否將所有的應用程式,安裝至它們目前所在的相同目錄中。預設值為 false。
如果將這個參數指定為 true,每一個個別的應用程式都會保留其位置。
如果您指定這個參數,就不能指定 -appInstallDirectory 參數。
限制: 如果這個參數指定為 true,現有 WebSphere Application Server 7.0 版或更新版本安裝架構及 9.0 版安裝架構會共用這個位置。如果您將移轉後的應用程式保留在與舊版相同的位置中,將會有下列若干限制: - 移轉期間當安裝所有應用程式時,可使用這個選用參數來傳遞要使用的目錄名稱。如果沒有指定這個參數,會使用預設的 profile_name\installedApps。
如果您指定這個參數,就不能指定 -keepAppDirectory 參數。
如果目錄名稱中有一或多個空格,必須用引號括住名稱。
如果您使用這個參數,移轉工具會同時在備份目錄(舊版的變數)與目的地設定檔(新版中的變數)中,針對所要移轉的節點,探索節點層次的變數。只要路徑是這些版本中之下列任何變數的一部分,工具就會簽訂路徑資訊,以使用相關的變數:
例如: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\.
- 這是選用性參數。
值 trace_spec 指定您要收集的追蹤資訊。
如果要收集所有的追蹤資訊,請指定 "*=all=enabled"(含雙引號)。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
- 這是選用性參數。
值 file_name 會指定輸出檔的名稱,以取得追蹤資訊。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
- 這是選用性參數。
秒值是指移轉所等待的秒數,過了這個秒數,就將嘗試的 wsadmin 連線設為失敗。
在應用程式移轉期間,這個值也用來作為逾時參數。
- 這是選用性參數。
舊管理代理程式的路徑值是指原始管理代理程式之設定檔目錄的檔案系統路徑。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的 SOAP 埠值是指原始管理代理程式用於管理連線的 SOAP 埠。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的主機名稱值是指原始管理代理程式的主機名稱位置。
如果未指定這個參數,依預設,這個值會設為 "localhost"。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的登入使用者名稱值是指原始管理代理程式的使用者名稱。
只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
新管理代理程式的路徑值是指新的已移轉的「管理代理程式」之設定檔目錄的檔案系統路徑。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的 SOAP 埠值是指新的已移轉的「管理代理程式」用於管理連線的 SOAP 埠。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的主機名稱值是指新的「管理代理程式」的主機名稱位置。
如果未指定這個參數,依預設,這個值會設為 "localhost"。
只有在所移轉的應用程式伺服器接受管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的登入使用者名稱值是指新的「管理代理程式」的使用者名稱。
只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
舊管理代理程式的登入密碼值是指新的「管理代理程式」的使用者名稱。
只有在所移轉的應用程式伺服器接受啟用管理安全之管理代理程式的管理時,才需要這個參數。
- 這是選用性參數。
請利用這個參數來指定 WASPostUpgrade 所用的 Java 資料堆記憶體大小。
"-Xms...m" 值指定起始資料堆大小。 請將 "..." 更換為您需要的大小 (MB)。 比方說,如果起始資料堆大小是 128 MB,請將這個參數指定為:-javaoption -Xms128m
"-Xmx...m" 值指定資料堆大小上限。 請將 "..." 更換為您需要的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xms1024m
記載
WASPostUpgrade 工具在執行時,會在畫面中顯示狀態。這個工具也會將一組較廣泛的記載資訊,儲存在位於 backupDirectory/logs 目錄的 WASPostUpgrade.time_stamp.log 檔中。您可以使用文字編輯器來檢視 WASPostUpgrade.time_stamp.log 檔。
安全考量
移轉之前,目標系統必須先停用安全。如果您從已啟用安全的來源配置進行移轉,在移轉期間,WASPostUpgrade 指令會自動啟用 9.0 版目標配置的安全。