WASPreUpgrade 指令

WebSphere® Application Server 9.0 版WASPreUpgrade 指令會將 WebSphere Application Server 先前安裝版本的配置儲存到移轉特定備份目錄中。

位置

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

語法

[AIX][HP-UX][Linux][Solaris]
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]
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]

參數

指令的參數如下:

backupDirectory
這是必要的參數,並且必須是您指定的第一個參數。值 backupDirectory 指定目錄的名稱,以供指令 Script 用來存放所儲存的配置。
避免困難 避免困難: 對於 WebSphere Application Server 備份目錄的位置而言,WAS_INSTALLUSER_INSTALL 根目錄是無效目錄。gotcha

這也是供 WASPostUpgrade 指令從中讀取配置的目錄。

如果目錄不存在,WASPreUpgrade 指令 Script 會建立它。

currentWebSphereDirectory
這是必要的參數,並且必須是您指定的第二個參數。這可能是 WebSphere Application Server 7.0 版或更新版本的任何支援移轉的版本。

currentWebSphereDirectory 值指定來源 WebSphere Application Server 安裝架構的安裝根目錄的名稱。

-properties
這是選用性參數。 properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPreUpgrade 之類移轉工具要如何操作的參數內容。

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

註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username-password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties
-traceString
這是選用性參數。 值 trace_spec 指定您要收集的追蹤資訊。

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

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

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

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

-machineChange
這個選用參數用於涉及跨作業系統與機器界限的移轉作業。如果指定為 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,使得備份目錄中含有共用的檔案儲存庫物件,您可能發現後置升級程序遇到記憶體不足異常狀況,這是因為預設資料堆上限過小,而無法包含支援回復用的檔案儲存庫備份。如果要解決這個問題,請執行下列三項作業的其中一項:
  • 如果系統位置中的檔案儲存庫有效,在執行 WASPostUpgrade 指令之前,請刪除備份目錄中的副本。

    執行 WASPostUpgrade 指令之前,將整個 /migrated/ 子目錄從移轉備份目錄中刪除,本質上是將您的前置升級備份從 -machineChange=true 轉換為 -machineChange=false。

  • 如果備份目錄中的檔案儲存庫副本有效,請刪除位於目的地位置中的版本。

    這會變更回復支援,因此,目的地檔案不存在,而不會在移轉期間佔據記憶體空間。

  • 如果您需要回復支援,並且需要備份目錄以及檔案系統兩者中的檔案,請增加後置升級程序的資料堆大小上限,使該值大到足以支援所有發生衝突的 SIB 檔。
-oldProfile
這是一個選用參數,用來移轉 WebSphere Application Server 舊版中特定的實例或設定檔。
-workspaceRoot
這是選用性參數。 值 user_workspace_folder_name_x 針對一或多個設定檔,指定管理主控台自訂「我的作業」設定的位置。
-username
這是選用性參數。 user name 值指定現行 WebSphere Application Server 安裝架構的管理使用者名稱。
如果下列狀況屬實,則此為必要的參數:
  • 您在移轉部署管理程式。
  • 在來源安裝架構中啟用管理或廣域安全。
  • 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
-password
這是選用性參數。 password 值指定現行 WebSphere Application Server 安裝架構的管理密碼。
如果下列狀況屬實,則此為必要的參數:
  • 您在移轉部署管理程式。
  • 在來源安裝架構中啟用管理或廣域安全。
  • 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
-javaoption
這是選用性參數。 請利用這個參數來指定 WASPreUpgrade 指令所用的 Java™ 資料堆記憶體大小。

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

"-Xms...m" 值是指定來指示資料堆大小上限的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xmx1024m

-requireEmbeddedDBMigration
這是用來移轉內嵌資料庫的選用參數。

如果將值指定為 true,您在移轉內嵌資料庫時所發生的任何異常狀況,都會造成 WASPreUpgrade 指令失敗。如果將值指定為 false,會將您在移轉內嵌資料庫時所發生的任何異常狀況,記載到追蹤檔中,並繼續執行 WASPreUpgrade 指令。

預設值為 true。

-keepDmgrEnabled
這是用來移轉 8.0 版部署管理程式設定檔的選用參數。

WASPreUpgrade 執行時,會停止 8.0 版部署管理程式設定檔。依預設,部署管理程式維持停止狀態。如果將值指定為 true,在指令執行完成之前,WASPreUpgrade 就會啟動部署管理程式。

預設值為 false。

記載

WASPreUpgrade 工具執行時,會在畫面中顯示狀態。工具也會將一組較廣泛的記載資訊,儲存在寫入至 backupDirectory 目錄的 WASPreUpgrade.time_stamp.log 檔中,其中 backupDirectory 是指定給 backupDirectory 參數的值。您可以使用文字編輯器來檢視 WASPreUpgradetime_stamp.log 檔。

移轉的資源

WASPreUpgrade 會儲存您所有的資源,但不會移轉 classes 目錄中的實體。

移轉作業會將下列檔案儲存在 backupDirectory 目錄中。
  • classes
  • config
  • properties

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



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