WASPreUpgrade 指令

位置

指令檔位於 9.0 app_server_root/bin 目錄中，且必須從該目錄執行。

權限

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

語法

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]
                 [-allowSameRelease < true | false >]

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]
                  [-allowSameRelease < true | false >]

WASPreUpgrade backupDirectory 
              currentWebSphereDirectory
              [-properties properties_file_name]
              [-traceString trace_spec [-traceFile file_name ]]
              [-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 用來存放所儲存的配置。

避免麻煩: WAS_INSTALL 和 USER_INSTALL 根目錄是 WebSphere Application Server 備份目錄位置的無效目錄。

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

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

currentWebSphereDirectory

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

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

對於轉移使用者: 在 9.0版之前的版本中， currentWebSphereDirectory 值指定來源實例或設定檔根目錄的名稱，而不是安裝目錄。 雖然您可以繼續將設定檔根目錄指定為此值，但將安裝目錄指定為此值，並在 -oldProfile 參數上指定設定檔，可提供更大的彈性。

-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移轉特定實例或設定檔的選用參數。

重要事項: 如果您指定 currentWebSphereDirectory 值作為設定檔根目錄，且在 -oldProfile 參數上指定設定檔，則設定檔必須相符。

-workspaceRoot

這是選用性參數。 值 user_workspace_folder_name_x 針對一或多個設定檔，指定管理主控台自訂「我的作業」設定的位置。

-username

這是選用性參數。 使用者名稱 值指定現行 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

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

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

預設值為 false。

-allowSameRelease

此為選用參數。 當此參數設為 true時，您可以將 WebSphere Application Server 9.0 設定檔從一個 WebSphere Application Server 9.0 安裝架構移轉至另一個安裝架構，包括移轉至不同機器上的安裝架構。 當 -allowSameRelease 參數設為 true時， WASPostUpgrade 指令上的 -clone 參數必須設為 true。

記載

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

移轉的資源

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