![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
WASPreUpgrade 指令
WebSphere® Application Server 9.0 版的 WASPreUpgrade 指令會將 WebSphere Application Server 先前安裝版本的配置儲存到移轉特定備份目錄中。
位置
指令檔在 9.0 版 app_server_root/bin 目錄中,且必須從這個目錄來執行。
![[IBM i]](../images/iseries.gif)
權限
如果要執行這個指令 Script,您的使用者設定檔必須具備 *ALLOBJ 權限。
語法
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPreUpgrade.sh backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name>]
[-password < password >]
[-javaoption < -Xms...m> -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[Windows]](../images/windows.gif)
WASPreUpgrade.bat backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-machineChange true | false]
[-oldProfile profile_name]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name>]
[-password < password >]
[-javaoption < -Xms...m> -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
![[IBM i]](../images/iseries.gif)
WASPreUpgrade backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name>]
[-password < password >]
[-javaoption < -Xms...m> -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
參數
指令的參數如下:
- 這是必要的參數,並且必須是您指定的第一個參數。值 backupDirectory 指定目錄的名稱,以供指令 Script 用來存放所儲存的配置。
避免困難: 對於 WebSphere Application Server 備份目錄的位置而言,WAS_INSTALL 和 USER_INSTALL 根目錄是無效目錄。gotcha
這也是供 WASPostUpgrade 指令從中讀取配置的目錄。
如果目錄不存在,WASPreUpgrade 指令 Script 會建立它。
- 這是必要的參數,並且必須是您指定的第二個參數。這可能是 WebSphere Application Server 7.0 版或更新版本的任何支援移轉的版本。
currentWebSphereDirectory 值指定來源 WebSphere Application Server 安裝架構的安裝根目錄的名稱。
currentWebSphereDirectory 值指定您想要移轉的來源 WebSphere Application Server 實例 7.0 版或更新版本設定檔的實例或設定檔根目錄的名稱。
這是選用性參數。 properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPreUpgrade 之類移轉工具要如何操作的參數內容。
您可以在移轉內容檔中定義參數內容,而不在指令行上指定大部分的選用參數。 如果在內容檔定義參數也在指令行指定參數,則指令行所指定的參數優先。
註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username 和 -password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties。- 這是選用性參數。
值 trace_spec 指定您要收集的追蹤資訊。
如果要收集所有的追蹤資訊,請指定 "*=all=enabled"(含雙引號)。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
- 這是選用性參數。
值 file_name 會指定輸出檔的名稱,以取得追蹤資訊。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
這個選用參數用於涉及跨作業系統與機器界限的移轉作業。如果指定為 true,這個參數會備份儲存在 WebSphere Application Server 安裝或設定檔資料夾階層之外的項目,以支援在移轉之時變更實體硬體。 如果指定為 false,在移轉期間,只會將儲存在 WebSphere Application Server 安裝資料夾或設定檔資料夾之下的檔案複製到備份目錄中。
預設值為 false。
當這個值是 false 時,移轉會假設 WebSphere Application Server 新舊安裝架構是在同一部實體機器上,且共用檔案系統存取權。 因此,任何位於 WebSphere 目錄外的檔案都是公有而可以共用的。當 -machineChange 是 false 時,移轉不會將 WebSphere Application Server 樹狀結構之外的檔案複製到備份目錄中。
當您使用「移轉」精靈時,false 是唯一的選項。 如果您選取 -machineChange=false,必須在相同的實體硬體上執行 WASPostUpgrade 指令。
如果您有意在不同機器或檔案系統上執行 WASPostUpgrade 指令,應執行指定 -machineChange=true 的 WASPreUpgrade 指令。如果您選取 -machineChange=true,移轉會在移轉備份目錄中,建立一個附加的子目錄 (/migrated/),其中含有 WebSphere Application Server 配置所參照,在產品或設定檔目錄之外的任何檔案。 當執行 WASPostUpgrade 指令時,這些檔案在新機器上會回到其原始路徑中。
效能考量:如果您移轉時使用「服務整合匯流排 (SIB)」的匯流排,並且為這些匯流排配置了檔案系統檔案儲存庫,您可能需要增加移轉資料堆與移轉備份目錄中的空間。每一個匯流排都有三個檔案儲存庫值 — 日誌、暫存空間與儲存庫。這三個檔案的大小互異,但每一個最多可以有 100-500 MB。當移轉在執行中,在前置升級程序期間,它會備份在 WebSphere Application Server 樹狀結構中的任何檔案儲存庫。 檔案系統上必須有足夠空間才能允許這樣做。在後置升級程序期間,如果檔案儲存庫已存在於目的地位置中,移轉作業會將檔案儲存庫備份在記憶體中,以支援回復。
如果您在執行 WASPreUpgrade 指令時,指定了 -machineChange=true,使得備份目錄中含有共用的檔案儲存庫物件,您可能發現後置升級程序遇到記憶體不足異常狀況,這是因為預設資料堆上限過小,而無法包含支援回復用的檔案儲存庫備份。如果要解決這個問題,請執行下列三項作業的其中一項:這是一個選用參數,用來移轉 WebSphere Application Server 舊版中特定的實例或設定檔。
- 這是選用性參數。 值 user_workspace_folder_name_x 針對一或多個設定檔,指定管理主控台自訂「我的作業」設定的位置。
- 這是選用性參數。
user name 值指定現行 WebSphere Application Server 安裝架構的管理使用者名稱。
如果下列狀況屬實,則此為必要的參數:
- 您在移轉部署管理程式。
- 在來源安裝架構中啟用管理或廣域安全。
- 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
- 這是選用性參數。
password 值指定現行 WebSphere Application Server 安裝架構的管理密碼。
如果下列狀況屬實,則此為必要的參數:
- 您在移轉部署管理程式。
- 在來源安裝架構中啟用管理或廣域安全。
- 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
- 這是選用性參數。
請利用這個參數來指定 WASPreUpgrade 指令所用的 Java™ 資料堆記憶體大小。
"-Xms...m" 值是指定來指示起始資料堆大小的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果起始資料堆大小是 128 MB,請將這個參數指定為: -javaoption -Xms128m
"-Xms...m" 值是指定來指示資料堆大小上限的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xmx1024m
- 這是用來移轉內嵌資料庫的選用參數。
如果將值指定為 true,您在移轉內嵌資料庫時所發生的任何異常狀況,都會造成 WASPreUpgrade 指令失敗。如果將值指定為 false,會將您在移轉內嵌資料庫時所發生的任何異常狀況,記載到追蹤檔中,並繼續執行 WASPreUpgrade 指令。
預設值為 true。
- 這是用來移轉 8.0 版部署管理程式設定檔的選用參數。
在 WASPreUpgrade 執行時,會停止 8.0 版部署管理程式設定檔。依預設,部署管理程式維持停止狀態。如果將值指定為 true,在指令執行完成之前,WASPreUpgrade 就會啟動部署管理程式。
預設值為 false。
記載
當 WASPreUpgrade 工具執行時,會在畫面中顯示狀態。工具也會將一組較廣泛的記載資訊,儲存在寫入至 backupDirectory 目錄的 WASPreUpgrade.time_stamp.log 檔中,其中 backupDirectory 是指定給 backupDirectory 參數的值。您可以使用文字編輯器來檢視 WASPreUpgradetime_stamp.log 檔。
移轉的資源
WASPreUpgrade 會儲存您所有的資源,但不會移轉 classes 目錄中的實體。